{"skill":{"slug":"openclaw-troubleshoot","displayName":"Openclaw Troubleshoot","summary":"Provide step-by-step diagnostics and command-line fixes for common OpenClaw issues including memory plugin faults, Feishu disconnects, LLM timeouts, and Tele...","description":"# OpenClaw 故障排除 Skill\n\n## 症状：失忆症（无法记住对话）\n\n### 诊断步骤\n1. 检查 memory 插件状态：`openclaw plugins list | grep memory`\n2. 检查会话文件：`ls ~/.openclaw/agents/main/sessions/`\n3. 检查 MEMORY.md 是否存在：`ls ~/.openclaw/workspace/MEMORY.md`\n\n### 修复方案\n```bash\n# 启用 memory-core 插件\nopenclaw plugins enable memory-core\n\n# 添加到允许列表\njq '.plugins.allow += [\"memory-core\"]' ~/.openclaw/openclaw.json > /tmp/oc.json && mv /tmp/oc.json ~/.openclaw/openclaw.json\n\n# 重启 Gateway\nlaunchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist\nlaunchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist\n```\n\n---\n\n## 症状：飞书连接断开\n\n### 诊断步骤\n1. 检查 Gateway 状态：`openclaw gateway status`\n2. 检查通道状态：`openclaw status | grep -A 5 \"Channels\"`\n3. 查看错误日志：`tail -50 /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log`\n\n### 修复方案\n```bash\n# 强制重启 Gateway\nkillall openclaw-gateway 2>/dev/null\nsleep 2\nlaunchctl kickstart -k gui/$UID/ai.openclaw.gateway\n```\n\n---\n\n## 症状：LLM Timeout\n\n### 注意\nOpenClaw 的 config schema **不支持**直接在 providers 下加 `timeout` 字段。\n\n### 正确做法\n- 使用默认超时设置\n- 如需要调整，通过环境变量或 API 调用时指定\n\n---\n\n## 症状：Telegram 疯狂报错\n\n### 修复方案\n```bash\n# 禁用 Telegram\nopenclaw config set plugins.allow '[\"feishu\"]'  # 只保留飞书\nopenclaw config set plugins.entries.telegram.enabled false\nopenclaw config set channels.telegram.enabled false\n\n# 重启生效\nopenclaw gateway restart\n```\n\n---\n\n## 配置原则\n\n1. **插件最小化** - 只启用需要的插件\n2. **配置验证** - 修改后用 `openclaw doctor` 检查\n3. **备份习惯** - 重要修改前手动备份 `openclaw.json`\n\n## 关键文件位置\n\n- 主配置：`~/.openclaw/openclaw.json`\n- 会话存储：`~/.openclaw/agents/main/sessions/`\n- 长期记忆：`~/.openclaw/workspace/MEMORY.md`\n- 日志文件：`/tmp/openclaw/openclaw-YYYY-MM-DD.log`\n- 服务配置：`~/Library/LaunchAgents/ai.openclaw.gateway.plist`\n","topics":["Json","备份"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":786,"installsAllTime":30,"installsCurrent":5,"stars":0,"versions":1},"createdAt":1772638732869,"updatedAt":1778491718264},"latestVersion":{"version":"1.0.0","createdAt":1772638732869,"changelog":"Initial release of openclaw-troubleshoot skill.\n\n- Provides step-by-step troubleshooting guides for common OpenClaw issues including memory loss, Feishu disconnection, LLM timeout, and Telegram errors.\n- Offers recommended diagnostic commands and practical repair solutions.\n- Lists configuration best practices for plugin management, validation, and backup.\n- Documents locations of key files and logs for easier manual checks and recovery.","license":null},"metadata":null,"owner":{"handle":"wayne19820905","userId":"s177s8jkxf6av6pma0djgtze2d884ap3","displayName":"Wayne19820905","image":"https://avatars.githubusercontent.com/u/195230825?v=4"},"moderation":null}