除錯和修復常見的 Clawdbot AI 助手問題。了解如何診斷連接問題、訊息故障和 Gateway 錯誤。

Clawdbot 故障排除概覽

本指南幫助您診斷和修復 Clawdbot 部署中的常見問題。找到連接問題、訊息故障和 Gateway 錯誤的解決方案。

常見問題

Gateway 無法啟動

症狀：Gateway 無法啟動或立即退出。

解決方案：

檢查端口可用性：

lsof -i :3010

驗證配置：

clawdbot config validate

檢查日誌：

clawdbot gateway logs

WhatsApp 連接失敗

症狀：QR 碼不顯示或連接斷開。

解決方案：

清除 WhatsApp 會話：

rm -rf ~/.clawdbot/providers/whatsapp/session

重啟 Gateway：

clawdbot gateway restart

檢查網路連接

訊息未送達

症狀：訊息已發送但未收到。

解決方案：

檢查會話狀態：

clawdbot sessions list

驗證提供者連接：

clawdbot providers status

檢查速率限制

代理無回應

症狀：代理不產生回應。

解決方案：

檢查代理狀態：

clawdbot agents status

驗證 API 金鑰：

echo $ANTHROPIC_API_KEY

檢查模型可用性

診斷命令

Gateway 狀態

# 檢查 Gateway 健康狀態
clawdbot gateway status

# 查看活躍連接
clawdbot gateway connections

# 顯示資源使用情況
clawdbot gateway stats

會話診斷

# 列出所有會話
clawdbot sessions list

# 查看會話詳情
clawdbot sessions get <session-key>

# 清除卡住的會話
clawdbot sessions clear <session-key>

提供者診斷

# 檢查提供者狀態
clawdbot providers status

# 測試提供者連接
clawdbot providers test whatsapp

# 重新連接提供者
clawdbot providers reconnect telegram

日誌分析

啟用除錯日誌

clawdbot gateway start --log-level debug

日誌位置

日誌	位置
Gateway	`~/.clawdbot/logs/gateway.log`
提供者	`~/.clawdbot/logs/providers/`
代理	`~/.clawdbot/logs/agents/`

日誌級別

級別	描述
`error`	僅錯誤
`warn`	警告和錯誤
`info`	一般資訊
`debug`	詳細除錯資訊

錯誤代碼

連接錯誤

代碼	描述	解決方案
`ECONNREFUSED`	端口未開放	檢查 Gateway 是否運行
`ETIMEDOUT`	網路逾時	檢查網路
`EAUTH`	認證失敗	驗證憑證

提供者錯誤

代碼	描述	解決方案
`WA_DISCONNECTED`	WhatsApp 已斷開	重新掃描 QR
`TG_INVALID_TOKEN`	Telegram 令牌無效	檢查令牌
`DC_MISSING_INTENTS`	Discord 意圖缺失	啟用意圖

效能問題

回應緩慢

原因：

訊息量大
上下文大小過大
網路延遲

解決方案：

啟用串流
減少上下文大小
檢查網路

記憶體使用

檢查記憶體：

clawdbot gateway stats --memory

減少記憶體：

{
  "gateway": {
    "messageBuffer": 500,
    "maxHistory": 50
  }
}

恢復程序

重置 Gateway

# 停止 Gateway
clawdbot gateway stop

# 清除狀態
clawdbot gateway reset --state

# 重新啟動
clawdbot gateway start

重置提供者

# 斷開提供者
clawdbot providers disconnect whatsapp

# 清除提供者資料
rm -rf ~/.clawdbot/providers/whatsapp

# 重新配置
clawdbot providers setup whatsapp

重置代理

# 清除代理會話
clawdbot agents reset main --sessions

# 清除代理工作區
clawdbot agents reset main --workspace

取得幫助

支援資源

文件：https://docs.clawdbotai.app
GitHub Issues：https://github.com/clawdbot/clawdbot/issues
社群 Discord：https://discord.gg/clawdbot

錯誤報告

錯誤報告中請包含：

Clawdbot 版本
作業系統
錯誤訊息
重現步驟

後續步驟

Clawdbot 配置 - 配置指南
Clawdbot 安全性 - 安全性設定
Clawdbot Gateway - Gateway 概覽

Clawdbot 故障排除

On this page