feishu-repair
自动修复飞书-自动修复飞书群聊+自动修复会话 - 诊断 Gateway 连接、权限配置、消息投递问题
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/amd5/feishu-repairFeishu 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 - 诊断结果输出详细报告
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-amd5-feishu-repair": {
"enabled": true,
"auto_update": true
}
}
}Tags
Related Skills
openclaw-troubleshooter
OpenClaw 故障诊断与一键修复工具。自动检测 Gateway 状态、配置错误、端口冲突、危险技能代码,并提供修复方案。基于真实故障经验提取。
conversation-archive
对话记忆仓库:自动归档 session 对话,保留原始记录,支持检索和误解纠正。可与 memory-never-forget 联动形成完整记忆体系。
feishu-cron-announce
创建定时任务并通过 OpenClaw cron announce 直接推送结果到飞书。当需要设置定时监控任务(如版本发布、天气、股票等)并让结果自动推送到飞书时使用。关键词:飞书定时推送、cron 定时任务、飞书 announce、定时监控、飞书监控通知。
feishu-voice-assistant
Sends voice messages (audio) to Feishu chats using Duby TTS.
feishu-doc
Fetch content from Feishu (Lark) Wiki, Docs, Sheets, and Bitable. Automatically resolves Wiki URLs to real entities and converts content to Markdown.