當(dāng)皇上故障排查手冊(cè)doctor一鍵診斷高頻問題清單快速修復(fù)你的AI朝廷【免費(fèi)下載鏈接】danghuangshangOpen-source multi-agent collaboration system inspired by Chinese governance — deploy and coordinate specialized AI agents with OpenClaw.項(xiàng)目地址: https://gitcode.com/gh_mirrors/bo/danghuangshang「當(dāng)皇上 × OpenClaw」是一個(gè)以明朝內(nèi)閣制為藍(lán)本的開源多 Agent 協(xié)作系統(tǒng)一臺(tái)服務(wù)器 OpenClaw 一支 7×24 在線的AI 朝廷司禮監(jiān)接旨、內(nèi)閣出謀劃策、六部各司其職、都察院質(zhì)量把關(guān)。當(dāng)朝廷「掉鏈子」——Bot 不回復(fù)、everyone 不觸發(fā)、Gateway 啟動(dòng)失敗——新手不必逐行翻配置。項(xiàng)目內(nèi)置doctor 一鍵診斷腳本doctor.sh一次跑完 9 大類檢查用 ? 通過 / ? 警告 / ? 錯(cuò)誤 三色標(biāo)注30 秒定位問題。本文帶你用 doctor 一鍵診斷快速修復(fù) AI 朝廷并附高頻問題清單與修復(fù)方法。doctor 一鍵診斷會(huì)檢查什么運(yùn)行bash doctor.sh后腳本按 9 步依次體檢覆蓋從安裝到集成的完整鏈路步驟檢查項(xiàng)典型抓出的問題1安裝檢查OpenClaw 未安裝、Node.js 版本低于 v222配置文件openclaw.json缺失、JSON 語法錯(cuò)誤多余逗號(hào)/缺引號(hào)3模型配置API Key 還是YOUR_LLM_API_KEY占位符、未配置 providers4Discord 配置在線驗(yàn)證 Bot Token 有效性、Intent 是否開啟、groupPolicy、服務(wù)器角色權(quán)限5飛書配置appId/appSecret 占位符、dmPolicy/groupPolicy、bindings 路由缺失6Docker / 沙箱Docker 權(quán)限不足導(dǎo)致 sandbox 模式不可用7Agent 配置Agent 與 Binding 數(shù)量不匹配、缺identity.theme角色描述8工作區(qū)workspace 目錄、SOUL.md、USER.md、memory/是否存在9可選集成Notion Key 格式、Gateway 服務(wù)是否在運(yùn)行其中 Discord 部分最硬核它會(huì)實(shí)際調(diào)用 Discord API驗(yàn)證每個(gè) Bot Token 是否有效、Message Content / Server Members Intent 是否開啟、Bot 是否已加入服務(wù)器且擁有 View Channels Send Messages 權(quán)限并把結(jié)果逐條打出來。3 步完成一次故障排查第 1 步跑診斷bash doctor.sh第 2 步看匯總結(jié)尾會(huì)輸出「通過 / 警告 / 錯(cuò)誤」統(tǒng)計(jì)。有 ? 就按提示逐條修doctor 還會(huì)自動(dòng)調(diào)用 OpenClaw 自帶的體檢openclaw doctor # 只檢查 openclaw doctor --fix # 自動(dòng)修復(fù)過期配置字段如 botName→name第 3 步看日志兜底配置層面沒問題卻仍不工作就查運(yùn)行日志journalctl --user -u openclaw-gateway --since today --no-pager更多命令與場景見 docs/doctor.md。高頻問題清單癥狀 → 原因 → 修復(fù)癥狀最可能的原因快速修復(fù)everyone 不觸發(fā) Bot 回復(fù)Discord Intent 未開啟見下方第 1 條飛書 Bot 不回消息事件訂閱 / 權(quán)限未配置見下方第 2 條Gateway 啟動(dòng)失敗API Key 未填、JSON 錯(cuò)誤、Token 無效openclaw doctor --fix 看日志Agent 報(bào)「只讀文件系統(tǒng)」sandbox 模式設(shè)為all見下方第 3 條Agent 不知道自己是誰缺identity.theme見下方第 4 條Bot 之間互相 不觸發(fā)mention 格式錯(cuò)誤用用戶ID格式1?? everyone 不觸發(fā) Bot 回復(fù)最常見按順序檢查Discord Developer Portal → Bot 頁面 → Privileged Gateway Intents開啟Message Content Intent和Server Members Intent每個(gè) Bot 都要開不是只開一個(gè)服務(wù)器設(shè)置 → 角色 → 確認(rèn)每個(gè) Bot 角色有View ChannelsSend Messages權(quán)限配置文件中全局channels.discord.groupPolicy和每個(gè) account的groupPolicy都設(shè)為opendoctor.sh 會(huì)專門檢查 account 級(jí)設(shè)置全局設(shè)置不會(huì)自動(dòng)繼承到 account改完 Intent 后重啟 Gatewayopenclaw gateway restart2?? 飛書 Bot 不響應(yīng)6 項(xiàng)自查飛書開放平臺(tái) → 事件訂閱確認(rèn)WebSocket 長連接模式 已添加im.message.receive_v1事件權(quán)限管理中im:message等權(quán)限全部審批通過應(yīng)用能力中已開啟機(jī)器人能力且應(yīng)用已發(fā)布版本管理中創(chuàng)建版本配置文件每個(gè) account 的appIdcli_開頭、appSecret已正確填寫B(tài)ot 已加入目標(biāo)群聊 時(shí)從彈出列表選擇不能手打文本查日志journalctl --user -u openclaw-gateway --since 5 min ago | grep -i feishu完整清單見 docs/setup-feishu.md 與 飛書配置指南.md。3?? Agent 報(bào)「只讀文件系統(tǒng)」「apt 失敗」sandbox 模式設(shè)成了allAgent 跑在只讀容器里。不寫代碼的部門直接關(guān)掉沙箱sandbox: { mode: off }若必須開沙箱把workspaceAccess設(shè)為rw。詳情見 docs/faq.md。4?? Agent 不知道自己是誰 / SOUL.md 是空的doctor.sh 會(huì)列出缺identity.theme的 Agent 名單。修復(fù)編輯~/.openclaw/openclaw.json給每個(gè) agent 補(bǔ)上identity: { theme: 你是... }再openclaw gateway restart。可直接參考 openclaw.example.json 里的 18 個(gè)部門人設(shè)模板configs/ming-neige/agents/ 有逐部門的 Markdown 版本。5?? Bot 互相 不觸發(fā) / 日志出現(xiàn) no-mentionDiscord 的 mention 必須用用戶ID格式如1482...52974純文本兵部不會(huì)觸發(fā)確認(rèn)配置了allowBots: mentionsBot 互觸發(fā)需要且防消息風(fēng)暴日志里其他 Bot 報(bào)no-mention是正常現(xiàn)象只要被 的 Bot 顯示explicitlyMentionedtrue就沒事用 GUI 面板盯著你的朝廷除了命令行項(xiàng)目自帶可視化面板 gui/部署指南見 docs/gui.md。朝堂視圖里每個(gè)部門的 Agent 都會(huì)以小人形象顯示頭頂綠點(diǎn)即在線狀態(tài)一眼看出誰「罷工」了會(huì)話視圖則是故障排查利器——每個(gè) Agent 的消息數(shù)、Token 消耗、活躍狀態(tài)一覽無余。若某 Agent 消息量暴漲但無產(chǎn)出多半是循環(huán)觸發(fā)若完全為 0說明消息根本沒路由到它檢查 bindings進(jìn)階定時(shí)健康檢查可選部署穩(wěn)定后可把 scripts/health-check.sh 掛到 crontab 每 5 分鐘跑一次它負(fù)責(zé)檢查 Gateway 存活、任務(wù)失敗率超 30% 告警和 API 日費(fèi)用異常超 $50 告警并可通過飛書/Discord 推送告警——把「事后排查」變成「事前預(yù)警」。 相關(guān)資源速查doctor.sh — 一鍵診斷腳本本文主角docs/doctor.md — 診斷指南與常用排查命令docs/faq.md — 常見問題 FAQdocs/install-troubleshooting.md — 安裝階段故障排查docs/setup-feishu.md — 飛書部署與排查scripts/health-check.sh — 定時(shí)健康檢查與告警gui/ — 可視化管理面板一句話總結(jié)先跑bash doctor.sh拿體檢報(bào)告紅色 ? 按提示修修完再跑一遍直到「 配置完美」——你的 AI 朝廷即可恢復(fù)滿朝文武在線?！久赓M(fèi)下載鏈接】danghuangshangOpen-source multi-agent collaboration system inspired by Chinese governance — deploy and coordinate specialized AI agents with OpenClaw.項(xiàng)目地址: https://gitcode.com/gh_mirrors/bo/danghuangshang創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考