當皇上故障排查手冊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」是一個以明朝內(nèi)閣制為藍本的開源多 Agent 協(xié)作系統(tǒng)一臺服務器 OpenClaw 一支 7×24 在線的AI 朝廷司禮監(jiān)接旨、內(nèi)閣出謀劃策、六部各司其職、都察院質(zhì)量把關。當朝廷「掉鏈子」——Bot 不回復、everyone 不觸發(fā)、Gateway 啟動失敗——新手不必逐行翻配置。項目內(nèi)置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 數(shù)量不匹配、缺identity.theme角色描述8工作區(qū)workspace 目錄、SOUL.md、USER.md、memory/是否存在9可選集成Notion Key 格式、Gateway 服務是否在運行其中 Discord 部分最硬核它會實際調(diào)用 Discord API驗證每個 Bot Token 是否有效、Message Content / Server Members Intent 是否開啟、Bot 是否已加入服務器且擁有 View Channels Send Messages 權限并把結(jié)果逐條打出來。3 步完成一次故障排查第 1 步跑診斷bash doctor.sh第 2 步看匯總結(jié)尾會輸出「通過 / 警告 / 錯誤」統(tǒng)計。有 ? 就按提示逐條修doctor 還會自動調(diào)用 OpenClaw 自帶的體檢openclaw doctor # 只檢查 openclaw doctor --fix # 自動修復過期配置字段如 botName→name第 3 步看日志兜底配置層面沒問題卻仍不工作就查運行日志journalctl --user -u openclaw-gateway --since today --no-pager更多命令與場景見 docs/doctor.md。高頻問題清單癥狀 → 原因 → 修復癥狀最可能的原因快速修復everyone 不觸發(fā) Bot 回復Discord Intent 未開啟見下方第 1 條飛書 Bot 不回消息事件訂閱 / 權限未配置見下方第 2 條Gateway 啟動失敗API Key 未填、JSON 錯誤、Token 無效openclaw doctor --fix 看日志Agent 報「只讀文件系統(tǒng)」sandbox 模式設為all見下方第 3 條Agent 不知道自己是誰缺identity.theme見下方第 4 條Bot 之間互相 不觸發(fā)mention 格式錯誤用用戶ID格式1?? everyone 不觸發(fā) 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等權限全部審批通過應用能力中已開啟機器人能力且應用已發(fā)布版本管理中創(chuàng)建版本配置文件每個 account 的appIdcli_開頭、appSecret已正確填寫B(tài)ot 已加入目標群聊 時從彈出列表選擇不能手打文本查日志journalctl --user -u openclaw-gateway --since 5 min ago | grep -i feishu完整清單見 docs/setup-feishu.md 與 飛書配置指南.md。3?? Agent 報「只讀文件系統(tǒng)」「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 互相 不觸發(fā) / 日志出現(xiàn) no-mentionDiscord 的 mention 必須用用戶ID格式如1482...52974純文本兵部不會觸發(fā)確認配置了allowBots: mentionsBot 互觸發(fā)需要且防消息風暴日志里其他 Bot 報no-mention是正?，F(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 分鐘跑一次它負責檢查 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/ — 可視化管理面板一句話總結(jié)先跑bash doctor.sh拿體檢報告紅色 ? 按提示修修完再跑一遍直到「 配置完美」——你的 AI 朝廷即可恢復滿朝文武在線?！久赓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），僅供參考 當皇上故障排查手冊：doctor一鍵診斷+高頻問題清單，快速修復你的AI朝廷
當皇上故障排查手冊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」是一個以明朝內(nèi)閣制為藍本的開源多 Agent 協(xié)作系統(tǒng)一臺服務器 OpenClaw 一支 7×24 在線的AI 朝廷司禮監(jiān)接旨、內(nèi)閣出謀劃策、六部各司其職、都察院質(zhì)量把關。當朝廷「掉鏈子」——Bot 不回復、everyone 不觸發(fā)、Gateway 啟動失敗——新手不必逐行翻配置。項目內(nèi)置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 數(shù)量不匹配、缺identity.theme角色描述8工作區(qū)workspace 目錄、SOUL.md、USER.md、memory/是否存在9可選集成Notion Key 格式、Gateway 服務是否在運行其中 Discord 部分最硬核它會實際調(diào)用 Discord API驗證每個 Bot Token 是否有效、Message Content / Server Members Intent 是否開啟、Bot 是否已加入服務器且擁有 View Channels Send Messages 權限并把結(jié)果逐條打出來。3 步完成一次故障排查第 1 步跑診斷bash doctor.sh第 2 步看匯總結(jié)尾會輸出「通過 / 警告 / 錯誤」統(tǒng)計。有 ? 就按提示逐條修doctor 還會自動調(diào)用 OpenClaw 自帶的體檢openclaw doctor # 只檢查 openclaw doctor --fix # 自動修復過期配置字段如 botName→name第 3 步看日志兜底配置層面沒問題卻仍不工作就查運行日志journalctl --user -u openclaw-gateway --since today --no-pager更多命令與場景見 docs/doctor.md。高頻問題清單癥狀 → 原因 → 修復癥狀最可能的原因快速修復everyone 不觸發(fā) Bot 回復Discord Intent 未開啟見下方第 1 條飛書 Bot 不回消息事件訂閱 / 權限未配置見下方第 2 條Gateway 啟動失敗API Key 未填、JSON 錯誤、Token 無效openclaw doctor --fix 看日志Agent 報「只讀文件系統(tǒng)」sandbox 模式設為all見下方第 3 條Agent 不知道自己是誰缺identity.theme見下方第 4 條Bot 之間互相 不觸發(fā)mention 格式錯誤用用戶ID格式1?? everyone 不觸發(fā) 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等權限全部審批通過應用能力中已開啟機器人能力且應用已發(fā)布版本管理中創(chuàng)建版本配置文件每個 account 的appIdcli_開頭、appSecret已正確填寫B(tài)ot 已加入目標群聊 時從彈出列表選擇不能手打文本查日志journalctl --user -u openclaw-gateway --since 5 min ago | grep -i feishu完整清單見 docs/setup-feishu.md 與 飛書配置指南.md。3?? Agent 報「只讀文件系統(tǒng)」「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 互相 不觸發(fā) / 日志出現(xiàn) no-mentionDiscord 的 mention 必須用用戶ID格式如1482...52974純文本兵部不會觸發(fā)確認配置了allowBots: mentionsBot 互觸發(fā)需要且防消息風暴日志里其他 Bot 報no-mention是正?，F(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 分鐘跑一次它負責檢查 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/ — 可視化管理面板一句話總結(jié)先跑bash doctor.sh拿體檢報告紅色 ? 按提示修修完再跑一遍直到「 配置完美」——你的 AI 朝廷即可恢復滿朝文武在線?！久赓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），僅供參考