name: openclaw-troubleshoot-cn version: 1.0.0 description: OpenClaw 故障排查 - 常見問題解決方案。適合：遇到問題的使用者、運維人員。 metadata: openclaw: emoji: "🔧" requires: bins: []

OpenClaw 故障排查

常見問題快速解決。

安裝問題

Node 版本過低

# 檢查版本
node -v

# 需要 18+
# 升級方法
brew upgrade node  # macOS

許可權錯誤

# 修復 npm 許可權
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

網路超時

# 使用國內映象
npm config set registry https://registry.npmmirror.com
小蔥技能站7w4.net每天更新，海量AI技能等你發現。

連線問題

Telegram 連線失敗

檢查清單： 1. Bot Token 是否正確 2. Bot 是否已啟動（/start） 3. 網路是否需要代理

# 測試連線
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

Discord 連線失敗

檢查清單： 1. Bot Token 是否正確 2. Bot 是否已加入伺服器 3. intents 是否開啟

釘釘連線失敗

檢查清單： 1. Client ID/Secret 是否正確 2. 機器人是否已建立 3. 回撥地址是否配置

模型問題

API Key 無效

# 驗證 DeepSeek Key
curl -H "Authorization: Bearer YOUR_KEY" \
  https://api.deepseek.com/v1/models

餘額不足

• DeepSeek：platform.deepseek.com 充值
• Claude：console.anthropic.com 充值
• OpenAI：platform.openai.com 充值

響應超時

# 增加超時時間
openclaw config set timeout 60000

執行問題

記憶體不足

# 增加 Node 記憶體
export NODE_OPTIONS="--max-old-space-size=4096"

埠被佔用

# 查詢佔用程序
lsof -i :3000

# 終止程序
kill -9 <PID>

日誌檢視

# 即時日誌
openclaw logs -f

# 日誌位置
~/.openclaw/logs/

高階問題

資料庫損壞

# 備份資料
cp -r ~/.openclaw/data ~/.openclaw/data.bak

# 重建資料庫
openclaw db reset

配置丟失

# 檢視當前配置
openclaw config list

# 重置配置
openclaw config reset

需要幫助？

如果以上方案都無法解決：

• 📖 文件：https://docs.openclaw.ai
• 💬 社群：https://discord.gg/clawd
• 🔧 遠端支援：
• 基礎診斷：¥99
• 深度排查：¥299
• 企業支援：¥999

聯絡：微信 yang1002378395 或 Telegram @yangster151

這個 Skill 質量不錯，內容實用，能幫助解決 OpenClaw 常見問題。優點是分類清晰、步驟詳細，照著做就能找到解決方案。不足之處是內容覆蓋面還不夠全，遇到複雜問題可能找不到答案，而且部分內容過於基礎，高階使用者可能覺得幫助有限。總體來說是個好用的排查工具，但對深度使用者來說還有提升空間。