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