当皇上故障排查手册doctor一键诊断高频问题清单快速修复你的AI朝廷【免费下载链接】danghuangshangOpen-source multi-agent collaboration system inspired by Chinese governance — deploy and coordinate specialized AI agents with OpenClaw.项目地址: https://gitcode.com/gh_mirrors/bo/danghuangshang「当皇上 × OpenClaw」是一个以明朝内阁制为蓝本的开源多 Agent 协作系统一台服务器 OpenClaw 一支 7×24 在线的AI 朝廷司礼监接旨、内阁出谋划策、六部各司其职、都察院质量把关。当朝廷「掉链子」——Bot 不回复、everyone 不触发、Gateway 启动失败——新手不必逐行翻配置。项目内置doctor 一键诊断脚本doctor.sh一次跑完 9 大类检查用 ✓ 通过 / ⚠ 警告 / ✗ 错误 三色标注30 秒定位问题。本文带你用 doctor 一键诊断快速修复 AI 朝廷并附高频问题清单与修复方法。doctor 一键诊断会检查什么运行bash doctor.sh后脚本按 9 步依次体检覆盖从安装到集成的完整链路步骤检查项典型抓出的问题1安装检查OpenClaw 未安装、Node.js 版本低于 v222配置文件openclaw.json缺失、JSON 语法错误多余逗号/缺引号3模型配置API Key 还是YOUR_LLM_API_KEY占位符、未配置 providers4Discord 配置在线验证 Bot Token 有效性、Intent 是否开启、groupPolicy、服务器角色权限5飞书配置appId/appSecret 占位符、dmPolicy/groupPolicy、bindings 路由缺失6Docker / 沙箱Docker 权限不足导致 sandbox 模式不可用7Agent 配置Agent 与 Binding 数量不匹配、缺identity.theme角色描述8工作区workspace 目录、SOUL.md、USER.md、memory/是否存在9可选集成Notion Key 格式、Gateway 服务是否在运行其中 Discord 部分最硬核它会实际调用 Discord API验证每个 Bot Token 是否有效、Message Content / Server Members Intent 是否开启、Bot 是否已加入服务器且拥有 View Channels Send Messages 权限并把结果逐条打出来。3 步完成一次故障排查第 1 步跑诊断bash doctor.sh第 2 步看汇总结尾会输出「通过 / 警告 / 错误」统计。有 ✗ 就按提示逐条修doctor 还会自动调用 OpenClaw 自带的体检openclaw doctor # 只检查 openclaw doctor --fix # 自动修复过期配置字段如 botName→name第 3 步看日志兜底配置层面没问题却仍不工作就查运行日志journalctl --user -u openclaw-gateway --since today --no-pager更多命令与场景见 docs/doctor.md。高频问题清单症状 → 原因 → 修复症状最可能的原因快速修复everyone 不触发 Bot 回复Discord Intent 未开启见下方第 1 条飞书 Bot 不回消息事件订阅 / 权限未配置见下方第 2 条Gateway 启动失败API Key 未填、JSON 错误、Token 无效openclaw doctor --fix 看日志Agent 报「只读文件系统」sandbox 模式设为all见下方第 3 条Agent 不知道自己是谁缺identity.theme见下方第 4 条Bot 之间互相 不触发mention 格式错误用用户ID格式1️⃣ everyone 不触发 Bot 回复最常见按顺序检查Discord Developer Portal → Bot 页面 → Privileged Gateway Intents开启Message Content Intent和Server Members Intent每个 Bot 都要开不是只开一个服务器设置 → 角色 → 确认每个 Bot 角色有View ChannelsSend Messages权限配置文件中全局channels.discord.groupPolicy和每个 account的groupPolicy都设为opendoctor.sh 会专门检查 account 级设置全局设置不会自动继承到 account改完 Intent 后重启 Gatewayopenclaw gateway restart2️⃣ 飞书 Bot 不响应6 项自查飞书开放平台 → 事件订阅确认WebSocket 长连接模式 已添加im.message.receive_v1事件权限管理中im:message等权限全部审批通过应用能力中已开启机器人能力且应用已发布版本管理中创建版本配置文件每个 account 的appIdcli_开头、appSecret已正确填写Bot 已加入目标群聊 时从弹出列表选择不能手打文本查日志journalctl --user -u openclaw-gateway --since 5 min ago | grep -i feishu完整清单见 docs/setup-feishu.md 与 飞书配置指南.md。3️⃣ Agent 报「只读文件系统」「apt 失败」sandbox 模式设成了allAgent 跑在只读容器里。不写代码的部门直接关掉沙箱sandbox: { mode: off }若必须开沙箱把workspaceAccess设为rw。详情见 docs/faq.md。4️⃣ Agent 不知道自己是谁 / SOUL.md 是空的doctor.sh 会列出缺identity.theme的 Agent 名单。修复编辑~/.openclaw/openclaw.json给每个 agent 补上identity: { theme: 你是... }再openclaw gateway restart。可直接参考 openclaw.example.json 里的 18 个部门人设模板configs/ming-neige/agents/ 有逐部门的 Markdown 版本。5️⃣ Bot 互相 不触发 / 日志出现 no-mentionDiscord 的 mention 必须用用户ID格式如1482...52974纯文本兵部不会触发确认配置了allowBots: mentionsBot 互触发需要且防消息风暴日志里其他 Bot 报no-mention是正常现象只要被 的 Bot 显示explicitlyMentionedtrue就没事用 GUI 面板盯着你的朝廷除了命令行项目自带可视化面板 gui/部署指南见 docs/gui.md。朝堂视图里每个部门的 Agent 都会以小人形象显示头顶绿点即在线状态一眼看出谁「罢工」了会话视图则是故障排查利器——每个 Agent 的消息数、Token 消耗、活跃状态一览无余。若某 Agent 消息量暴涨但无产出多半是循环触发若完全为 0说明消息根本没路由到它检查 bindings进阶定时健康检查可选部署稳定后可把 scripts/health-check.sh 挂到 crontab 每 5 分钟跑一次它负责检查 Gateway 存活、任务失败率超 30% 告警和 API 日费用异常超 $50 告警并可通过飞书/Discord 推送告警——把「事后排查」变成「事前预警」。 相关资源速查doctor.sh — 一键诊断脚本本文主角docs/doctor.md — 诊断指南与常用排查命令docs/faq.md — 常见问题 FAQdocs/install-troubleshooting.md — 安装阶段故障排查docs/setup-feishu.md — 飞书部署与排查scripts/health-check.sh — 定时健康检查与告警gui/ — 可视化管理面板一句话总结先跑bash doctor.sh拿体检报告红色 ✗ 按提示修修完再跑一遍直到「 配置完美」——你的 AI 朝廷即可恢复满朝文武在线。【免费下载链接】danghuangshangOpen-source multi-agent collaboration system inspired by Chinese governance — deploy and coordinate specialized AI agents with OpenClaw.项目地址: https://gitcode.com/gh_mirrors/bo/danghuangshang创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考