Skills feishu-repair

Name: feishu-repair
Author: openclaw

自动修复飞书-自动修复飞书群聊+自动修复会话 - 诊断 Gateway 连接、权限配置、消息投递问题

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/amd5/feishu-repair" ~/.claude/skills/openclaw-skills-feishu-repair && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/amd5/feishu-repair" ~/.openclaw/skills/openclaw-skills-feishu-repair && rm -rf "$T"

manifest: skills/amd5/feishu-repair/SKILL.md

Feishu Repair — 飞书群聊+会话修复技能

版本: 1.9.0 创建日期: 2026-04-14 触发关键词:

修复飞书

📋 功能

自动诊断和修复 OpenClaw 飞书渠道的常见问题：

问题类型	诊断方式	修复方式
Gateway 未运行	systemctl 检查	自动重启 Gateway
飞书 WebSocket 断开	journalctl 日志	自动重启 Gateway
群聊权限丢失	检查 groupAllowFrom	自动恢复配置 + 强制重启 + 验证 + 发送消息到所有群聊和用户
用户权限丢失	检查 allowFrom	自动恢复配置 + 强制重启 + 验证 + 发送消息到所有群聊和用户
配置未生效	检查 config	强制重启 Gateway + 验证
消息不回复	综合诊断	输出修复报告 + 发送验证消息

📂 文件结构

skills/feishu-repair/
├── SKILL.md
├── skill.json
├── _meta.json
└── scripts/
    └── diagnose.js     # 诊断脚本

🔧 修复流程

诊断 → 修复 → 强制重启 Gateway → 验证 → 发消息确认

步骤	功能	说明
1️⃣ 诊断	检查 Gateway、飞书配置、日志错误	始终执行
2️⃣ 修复	从配置恢复丢失的权限	检测到问题
3️⃣ 强制重启	重启 Gateway 使配置生效	有修复操作时强制重启
4️⃣ 验证	配置 + 日志双重检查	重启后自动执行
5️⃣ 消息确认	遍历所有群聊和会话发送当前时间	验证通过后自动发送

修复策略

策略	触发条件	动作
配置恢复	权限丢失/配置异常	从 `openclaw.json` 或 `openclaw.json.bak*` 读取完整配置自动恢复
Gateway 状态检查	Gateway 未运行	自动重启 Gateway
WebSocket 重连	WS 断开日志	自动重启 Gateway
配置生效检查	配置变更未生效	自动重启 Gateway + 验证

配置读取优先级

~/.openclaw/openclaw.json
（当前配置）
~/.openclaw/openclaw.json.bak
（最新备份）
~/.openclaw/openclaw.json.bak.1
（更早备份）

按顺序读取，找到第一个有飞书配置的文件即停止。从中提取

allowFrom

、

groupAllowFrom

、

appId

等完整列表。

📊 配置来源

技能内不硬编码任何用户 ID、群聊 ID、App ID。

全部从用户的

openclaw.json

及其备份文件中动态读取。

⚠️ 注意事项

检测到配置问题并修复后，强制重启 Gateway（不是提示手动）
重启完成后，自动验证修复结果（配置 + 日志双重检查）
验证通过后，自动在飞书所有群聊（groupAllowFrom）和会话（allowFrom）发送当前时间，确认消息功能已恢复

配置读取优先级：

openclaw.json

openclaw.json.bak

openclaw.json.bak.1

诊断结果输出详细报告