OpenClaw 突然不說話了？別慌，90%的問題都在這裏

🦞OpenClaw唔覆消息❗️輸入咩都冇用。

羣組幾乎日日都有人問呢個問題。驍哥自己都中過好幾次😅

今日驍哥將踩過嘅坑全部整理曬出嚟，下次🦞仔扭計，直接睇呢篇

先行一組"體檢命令"

無論咩情況，先將呢幾條命令行一次，等於幫🦞仔做個全身檢查 🏥

openclaw status # 總覽：頻道、會話、認證狀態
openclaw status --all # 完整報告（截圖發羣裏求助用）
openclaw gateway probe # 探測 Gateway 是否可達
openclaw gateway status # Gateway 服務 + RPC 探針
openclaw doctor # 自動診斷配置和服務問題
openclaw channels status --probe # 頻道連接狀態
openclaw logs --follow # 實時日誌（劃重點❗️這步最關鍵）

健康嘅🦞仔係咁樣 👇

☝️ openclaw gateway status 顯示 Runtime: running 和 RPC probe: ok

✌️ openclaw doctor 冇出紅色錯誤

3️⃣ openclaw channels status --probe 顯示你嘅頻道係enabled

4️⃣ openclaw logs --follow 近期冇重複彈紅色嘅報錯

邊一步唔啱，直接向下揾對應嘅場景👇

場景一：Gateway 根本冇行到

openclaw gateway status 顯示 Runtime: stopped？

Gateway 就係🦞仔嘅心臟，心臟停咗，佢當然唔會理你。呢個係羣組入面出現得最密嘅問題。

☝️ Port（埠）俾人佔咗

日誌入面見到 EADDRINUSE 或 another gateway instance is already listening。

# 找到佔用端口的進程（默認端口 18789）
lsof -i :18789
# 殺掉它
kill <PID>
# 或者直接用 --force 啓動，自動搶佔端口
openclaw gateway --force

✌️ 冇設定 gateway.mode

日誌入面見到 Gateway start blocked: set gateway.mode=local。

Gateway 唔配（config） gateway.mode 就唔俾你啟動，行一次配置嚮導就得：

openclaw configure

或者直接編輯 ~/.openclaw/openclaw.json：

{
  gateway: { mode: "local" }
}

想暫時行一次？加個 --allow-unconfigured 跳過檢查：

openclaw gateway --allow-unconfigured

3️⃣ 綁定咗外網但冇設定認證

日誌入面見到 refusing to bind gateway ... without auth。

你將 Gateway 綁咗去 lan 或 0.0.0.0，但冇設密碼。OpenClaw 唔俾你裸跑，一定要設 token 或 password：

openclaw configure
# 按提示設置 auth token 或 password

4️⃣ 設定檔寫錯咗

OpenClaw 對設定嘅校驗好嚴格。多寫咗個字段、類型唔啱、格式有錯，Gateway 直接罷工。

# 用 doctor 檢查
openclaw doctor
# 自動修復（會先備份到 ~/.openclaw/openclaw.json.bak）
openclaw doctor --repair

💡 --fix 是 --repair 嘅別名，效果一樣。

大部分情況，一條命令搞掂：

openclaw gateway restart

⚠️ 注意陷阱！呢兩個命令唔好搞亂：

openclaw gateway restart 重啟後台服務（推薦 ✅）

openclaw gateway 前台運行，閂咗終端就會停（臨時除錯用）

場景二：Gateway 行緊，但頻道冇連到

openclaw gateway status 顯示 running，但 openclaw channels status --probe 顯示頻道冇連到？

驍哥用TG，所以分享下TG相關嘅經驗💁‍♀️

Telegram 用戶睇呢度 👇

Bot Token 配錯或者失效咗：

# 驗證 Token 是否有效
curl -s "https://api.telegram.org/bot<你的Token>/getMe"

返回 "ok": false？Token 有問題。去 Telegram 揾 @BotFather 確認一下，攞到正確嘅 Token 更新設定：

// ~/.openclaw/openclaw.json
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "你的新Token"
    }
  }
}

亦可以用環境變數：TELEGRAM_BOT_TOKEN=你的Token

💡 改完設定一般唔使手動重啟，Gateway 會自己 detect 到檔案變咗然後重新 load。冇生效嘅話再行一次 openclaw gateway restart。

DNS/網絡問題連唔到 Telegram API：

日誌入面見到連接 api.telegram.org 失敗，或者 setMyCommands 網絡錯誤。國內伺服器嘛……你明嘅，大概率要 set 代理 😅

場景三：頻道連咗，但就係唔覆 message

呢個最令人癲。一切睇落正常，但🦞仔就係扮死 🤐

openclaw pairing list telegram # 把 telegram 換成你用的頻道
openclaw logs --follow # 然後給它發條消息，盯着日誌看

☝️ Pairing 冇通過（最最最常見❗️）

OpenClaw 預設開咗 pairing 模式。咩意思呢？就好似你屋企門口裝咗個門禁，新嚟嘅人要按門鐘，你喺入面撳"開門"，佢先入到嚟講嘢 🚪

新用戶第一次 send message 會收到一個 8 位配對碼，你要喺 server 上面批准，🦞仔先會理佢。

日誌入面見到 pairing request 就係呢個原因。

# 查看待審批的配對請求
openclaw pairing list telegram
# 用配對碼批准（CODE 就是那個 8 位大寫字母）
openclaw pairing approve telegram <CODE>

⚠️ 注意陷阱！配對碼 1 小時過期，每個頻道最多同時有 3 個等審批。過期咗叫對方重新 send 一條 message 就得，會生成新嘅。

驍哥自己用嘅話，直接將 DM 策略改成 open，費事次次都要批：

{
  channels: {
    telegram: {
      dmPolicy: "open",
      allowFrom: ["*"]
    }
  }
}

✌️ 羣組要 @提先至會覆

OpenClaw 預設喺羣組要 @佢 先會覆，唔係就當睇唔到（怕洗版嘛）。

日誌入面見到 drop guild message (mention required) 就係呢個。

解決方法 👇

最簡單：喺羣組 @你嘅bot 發 message。

想佢隨時都覆？改設定：

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false }
      }
    }
  }
}

亦都可以喺 chat 入面用 command 切換（淨係當前對話有效）：

/activation always    # 不需要@也回覆
/activation mention   # 恢復需要@

3️⃣ Telegram Bot 嘅私隱模式擋咗羣組消息

Telegram Bot 預設開咗 Privacy Mode，喺羣組只係收到 /命令 和 @提及 嘅消息，其他消息根本收唔到。

解決方法（二揀一）：

🅰️ 去 @BotFather → /setprivacy → 揀你嘅 Bot → Disable

🅱️ 將 Bot 設為羣管理員（管理員自動收到所有消息）

⚠️ 注意陷阱！改完私隱模式之後，一定要將 Bot 從羣組踢走，再重新拉返入嚟，Telegram 先會生效。驍哥嗰時喺呢步卡咗好耐，差啲以為係 Bug 🤪

4️⃣ Allowlist 將你擋住咗

日誌入面見到 blocked 或 allowlist 相關日誌。

openclaw doctor --repair

⚠️ 注意陷阱！升級 OpenClaw 之後特別容易中招。舊版本嘅 allowlist 可能用咗 @username 格式，新版本只認數字 ID。openclaw doctor --repair 會嘗試自動轉換（需要 Bot Token 先解析到）。

點樣查自己嘅 Telegram 數字 ID 🧏‍♀️

🅰️ 俾你嘅 Bot 發一條 message，然後 openclaw logs --follow，日誌入面嘅 from.id 就是

🅱️ 用 Bot API：`curl "https://api.telegram.org/bot/getUpdates" 

3️⃣ Telegram 嘅 @userinfobot / @getidsbot

場景四：模型相關問題

☝️ API Key 過期或額度用曬

日誌入面見到 401、403、rate limit、insufficient_quota 之類嘅錯誤。

講白咗就係冇錢或者 Key 失效咗。先去睇下錢包餘額啦 😂

openclaw logs --follow
# 看有沒有 provider / credentials 相關的錯誤

幾種常見情況 👇

🔴 API Key 過期或被撤銷咗

🔴 額度/餘額用曬

🔴 Provider 設定冇咗（日誌入面見到 No credentials found for profile "anthropic:default" 或 missingProvidersInUse）

修復：

openclaw configure

遇到 Anthropic 嘅 429 限流（HTTP 429: rate_limit_error），可能係 concurrent 太多或者額度唔夠。等一陣，或者 set 個 fallback 模型，主力死咗自動轉備用，唔會直接沉默：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/claude-sonnet-4-6"]
      }
    }
  }
}

驍哥建議都 set 一個 fallback，幾好用嘅 👍

✌️ 模型唔喺允許列表入面

日誌入面見到 Model … is not allowed。

你喺設定入面定義咗 agents.defaults.models 嘅話，呢個列表同時就係白名單。用 /model 轉到一個唔喺入面嘅模型，🦞仔就直接唔覆，連個報錯都唔俾你。

解決：將你要用嘅模型加落 models 設定入面，或者 /model 轉返去。

場景五：Cron / Heartbeat 唔觸發

Set 咗定時任務或心跳，到咗時間冇反應？

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20

☝️ Cron 排程器俾人 disable 咗

日誌入面見到 cron: scheduler disabled; jobs will not run automatically。檢查設定入面 cron 係咪 enable 咗。

✌️ 靜默時段（Quiet Hours）

日誌入面見到 heartbeat skipped with reason=quiet-hours。你可能 set 咗"安靜時間"，呢段時間內 Heartbeat 唔會觸發。

3️⃣ 主要對話正忙

日誌入面見到 requests-in-flight。🦞仔正在處理其他請求，Heartbeat 就排隊等緊。等忙完自然會觸發，唔使理。

4️⃣ Heartbeat 嘅 accountId 配錯咗

日誌入面見到 heartbeat: unknown accountId。檢查 heartbeat 設定入面嘅 account ID 啱唔啱。

萬能急救三連

上面嘅場景都對唔上？或者懶得逐個睇？試下呢三步 👇

# ☝️ 自動診斷 + 修復
openclaw doctor --repair

# ✌️ 重啓 Gateway
openclaw gateway restart

# 3️⃣ 看實時日誌，發條消息，觀察報錯
openclaw logs --follow

90% 嘅問題，呢三步就搞掂。舒服曬 ✅

仲係唔得？行一次 openclaw status --all，將完整輸出 cap 圖 send 去羣組或者 GitHub Discussions，大家幫你睇 🤝

排查速查表

驍哥俾大家整咗一張表，建議收藏 👇

小結

驍哥覺得最有用嘅排查方式就係看日誌。openclaw logs --follow 然後俾🦞仔發條 message，日誌入面會話你知 message 到底卡咗喺邊一步

養成一個習慣：每次改完設定、升級完版本，行一次 openclaw doctor。冇咁難，跟住上面嘅速查錶行就得 😎

亦可以直接去睇下官方文檔👉

https://docs.openclaw.ai/zh-CN/help/faq

咁今期就到呢度，我係🦞OpenClaw馴獸師驍哥，下期見，88👋🤓

往期實戰👇

Vibe Coding之父：OpenClaw係 AI 嘅第三階段？

點樣用OpenClaw寫出精美飛書文檔

我做嘅網站，SEO排名衝到第一，全靠呢個Skill

點樣令 OpenClaw 主動揾你傾計（發日報）？Heartbeat + Cron 終極攻略

OpenClaw之父加入OpenAI！由小鎮少年到改變世界，呢條友嘅故事比電影仲燃

點樣用OpenClaw，搭建一支"AI團隊"？

OpenClaw，俾新手嘅幾個超實用小技巧（可能大部分人都會中嘅陷阱）

由零開始搭建OpenClaw，騰訊雲+Telegram方案

點解OpenClaw咁紅？用ChatGPT、Claude Code唔香咩？

“🦞OpenClaw不回消息了❗️輸啥都沒用。”

羣裏幾乎每天都有人問這個問題。驍哥自己也踩過好幾次😅

今天驍哥把踩過的坑全整理出來了，下次🦞仔鬧脾氣，直接翻這篇

先跑一套"體檢命令"

不管啥情況，先把這幾條命令跑一遍，相當於給🦞仔做個全身體檢 🏥

openclaw status # 總覽：頻道、會話、認證狀態
openclaw status --all # 完整報告（截圖發羣裏求助用）
openclaw gateway probe # 探測 Gateway 是否可達
openclaw gateway status # Gateway 服務 + RPC 探針
openclaw doctor # 自動診斷配置和服務問題
openclaw channels status --probe # 頻道連接狀態
openclaw logs --follow # 實時日誌（劃重點❗️這步最關鍵）

健康的🦞仔長這樣 👇

☝️ openclaw gateway status 顯示 Runtime: running 和 RPC probe: ok

✌️ openclaw doctor 沒有報紅色錯誤

3️⃣ openclaw channels status --probe 顯示你的頻道是enabled

4️⃣ openclaw logs --follow 近期沒有重複刷紅的報錯

哪一步不對，直接往下翻對應的場景👇

場景一：Gateway 根本沒跑起來

openclaw gateway status 顯示 Runtime: stopped？

Gateway 就是🦞仔的心臟，心臟停了，它當然不會理你。這個是羣裏出現頻率最高的問題。

☝️ 端口被佔了

日誌裏看到 EADDRINUSE 或 another gateway instance is already listening。

# 找到佔用端口的進程（默認端口 18789）
lsof -i :18789
# 殺掉它
kill <PID>
# 或者直接用 --force 啓動，自動搶佔端口
openclaw gateway --force

✌️ 沒配置 gateway.mode

日誌裏看到 Gateway start blocked: set gateway.mode=local。

Gateway 不配 gateway.mode 就不讓啓動，跑一下配置嚮導就行：

openclaw configure

或者直接編輯 ~/.openclaw/openclaw.json：

{
  gateway: { mode: "local" }
}

就想臨時跑一下？加個 --allow-unconfigured 跳過檢查：

openclaw gateway --allow-unconfigured

3️⃣ 綁定外網但沒設認證

日誌裏看到 refusing to bind gateway ... without auth。

你把 Gateway 綁到了 lan 或 0.0.0.0，但沒設密碼。OpenClaw 不讓你裸奔，必須設 token 或 password：

openclaw configure
# 按提示設置 auth token 或 password

4️⃣ 配置文件寫錯了

OpenClaw 對配置校驗賊嚴格。多寫了個字段、類型不對、格式有誤，Gateway 直接罷工。

# 用 doctor 檢查
openclaw doctor
# 自動修復（會先備份到 ~/.openclaw/openclaw.json.bak）
openclaw doctor --repair

💡 --fix 是 --repair 的別名，效果一樣。

大部分情況，一條命令搞定：

openclaw gateway restart

⚠️ 注意坑！這兩個命令別搞混了：

openclaw gateway restart 重啓後台服務（推薦 ✅）

openclaw gateway 前台運行，關掉終端就停了（臨時調試用）

場景二：Gateway 在跑，但頻道沒連上

openclaw gateway status 顯示 running，但 openclaw channels status --probe 顯示頻道沒連上？

驍哥用的TG，所以分享下TG相關的經驗💁‍♀️

Telegram 用戶看這裏 👇

Bot Token 配錯或失效了：

# 驗證 Token 是否有效
curl -s "https://api.telegram.org/bot<你的Token>/getMe"

返回 "ok": false？Token 有問題。去 Telegram 找 @BotFather 確認一下，拿到正確的 Token 更新配置：

// ~/.openclaw/openclaw.json
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "你的新Token"
    }
  }
}

也可以用環境變量：TELEGRAM_BOT_TOKEN=你的Token

💡 改完配置一般不用手動重啓，Gateway 會自己檢測到文件變了然後重新加載。沒生效的話再跑一下 openclaw gateway restart。

DNS/網絡問題連不上 Telegram API：

日誌裏看到連接 api.telegram.org 失敗，或者 setMyCommands 網絡錯誤。國內服務器嘛……你懂的，大概率需要配代理 😅

場景三：頻道連着，但就是不回消息

這個最讓人抓狂。一切看起來都正常，但🦞仔就是裝死 🤐

openclaw pairing list telegram # 把 telegram 換成你用的頻道
openclaw logs --follow # 然後給它發條消息，盯着日誌看

☝️ Pairing 沒通過（最最最常見❗️）

OpenClaw 默認開了 pairing 模式。啥意思呢？就像你家門口裝了個門禁，新來的人得先按門鈴，你在裏面按"開門"，他才能進來說話 🚪

新用戶第一次發消息會收到一個 8 位配對碼，你得在服務器上批准，🦞仔才會搭理他。

日誌裏看到 pairing request 就是這個原因。

# 查看待審批的配對請求
openclaw pairing list telegram
# 用配對碼批准（CODE 就是那個 8 位大寫字母）
openclaw pairing approve telegram <CODE>

⚠️ 注意坑！配對碼 1 小時過期，每個頻道最多同時掛 3 個待審批。過期了讓對方重新發一條消息就行，會生成新的。

驍哥自己用的話，直接把 DM 策略改成 open，省得每次都要批：

{
  channels: {
    telegram: {
      dmPolicy: "open",
      allowFrom: ["*"]
    }
  }
}

✌️ 羣聊需要 @提及才回復

OpenClaw 默認在羣裏得 @它 才會回覆，不然就當沒看見（怕刷屏嘛）。

日誌裏看到 drop guild message (mention required) 就是這個。

解決方案 👇

最簡單：在羣裏 @你的bot 發消息。

想讓它隨時都回？改配置：

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false }
      }
    }
  }
}

也可以在聊天裏用命令切換（僅當前會話生效）：

/activation always    # 不需要@也回覆
/activation mention   # 恢復需要@

3️⃣ Telegram Bot 的隱私模式擋了羣消息

Telegram Bot 默認開着 Privacy Mode，在羣裏只能收到 /命令 和 @提及 的消息，其他消息壓根收不到。

解決方法（二選一）：

🅰️ 去 @BotFather → /setprivacy → 選你的 Bot → Disable

🅱️ 把 Bot 設為羣管理員（管理員自動收到所有消息）

⚠️ 注意坑！改完隱私模式後，必須把 Bot 從羣裏踢出去，再重新拉進來，Telegram 才會生效。驍哥當時卡在這一步卡了好久，差點以為是 Bug 🤪

4️⃣ Allowlist 把你擋了

日誌裏看到 blocked 或 allowlist 相關日誌。

openclaw doctor --repair

⚠️ 注意坑！升級 OpenClaw 後特別容易中招。舊版本的 allowlist 可能用的是 @username 格式，新版本只認數字 ID。openclaw doctor --repair 會嘗試自動轉換（需要 Bot Token 才能解析）。

怎麼查自己的 Telegram 數字 ID 🧏‍♀️

🅰️ 給你的 Bot 發條消息，然後 openclaw logs --follow，日誌裏的 from.id 就是

🅱️ 用 Bot API：`curl "https://api.telegram.org/bot/getUpdates" 

3️⃣ Telegram 的 @userinfobot / @getidsbot

場景四：模型相關問題

☝️ API Key 過期或額度用完

日誌裏看到 401、403、rate limit、insufficient_quota 之類的錯誤。

說白了就是錢沒了或者 Key 失效了。先去看看錢包餘額吧 😂

openclaw logs --follow
# 看有沒有 provider / credentials 相關的錯誤

幾種常見情況 👇

🔴 API Key 過期或被撤銷了

🔴 額度/餘額花完了

🔴 Provider 配置丟了（日誌裏看到 No credentials found for profile "anthropic:default" 或 missingProvidersInUse）

修復：

openclaw configure

碰到 Anthropic 的 429 限流（HTTP 429: rate_limit_error），可能是併發太多或者額度不夠。等一會兒，或者配個 fallback 模型，主力掛了自動切備用，不至於直接沉默：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/claude-sonnet-4-6"]
      }
    }
  }
}

驍哥建議都配一個 fallback，挺好使的 👍

✌️ 模型不在允許列表裏

日誌裏看到 Model … is not allowed。

你在配置裏定義了 agents.defaults.models 的話，這個列表同時就是白名單。用 /model 切到一個不在裏面的模型，🦞仔就直接不回了，連個報錯都不給你。

解決：把你要用的模型加到 models 配置裏，或者 /model 切回去。

場景五：Cron / Heartbeat 不觸發

設了定時任務或心跳，到點了沒動靜？

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20

☝️ Cron 調度器被禁用了

日誌裏看到 cron: scheduler disabled; jobs will not run automatically。檢查配置裏 cron 是否啓用。

✌️ 靜默時段（Quiet Hours）

日誌裏看到 heartbeat skipped with reason=quiet-hours。你可能配了"安靜時間"，這個時間段內 Heartbeat 不會觸發。

3️⃣ 主會話正忙

日誌裏看到 requests-in-flight。🦞仔正在處理別的請求，Heartbeat 就排隊等着呢。等忙完了自然會觸發，不用管。

4️⃣ Heartbeat 的 accountId 配錯了

日誌裏看到 heartbeat: unknown accountId。檢查 heartbeat 配置裏的 account ID 對不對。

萬能急救三連

上面的場景都對不上？或者懶得一個個排查？試試這三步 👇

# ☝️ 自動診斷 + 修復
openclaw doctor --repair

# ✌️ 重啓 Gateway
openclaw gateway restart

# 3️⃣ 看實時日誌，發條消息，觀察報錯
openclaw logs --follow

90% 的問題，這三步就能解決。舒服了 ✅

還是不行？跑一下 openclaw status --all，把完整輸出截圖發到羣裏或者 GitHub Discussions，大家幫你看 🤝

排查速查表

驍哥給大家整了一張表，建議收藏 👇

小結

驍哥覺得最管用的排查方式就是看日誌。openclaw logs --follow 然後給🦞仔發條消息，日誌裏會告訴你消息到底卡在了哪一步

養成一個習慣：每次改完配置、升級完版本，跑一遍 openclaw doctor。沒那麼難，跟着上面的速查表走就行 😎

也可以直接去看下官方文檔👉

https://docs.openclaw.ai/zh-CN/help/faq

那本期就這樣，我是🦞OpenClaw馴獸師驍哥，下期見，88👋🤓

往期實踐👇

Vibe Coding之父：OpenClaw是 AI 的第三階段？

如何用OpenClaw，寫出精美飛書文檔

我做的網站，SEO排名衝到了第一，就靠這個Skill

如何讓 OpenClaw 主動找你搭話（發日報）？Heartbeat + Cron 終極攻略

OpenClaw之父加入OpenAI！從小鎮少年到改變世界，這哥們的故事比電影還燃

如何用OpenClaw，搭建一支"AI團隊"？

OpenClaw，給新人的幾個超實用小技巧（可能大部分人都會踩的坑）

從零搭建OpenClaw，騰訊雲+Telegram方案

為啥OpenClaw火成這樣？用ChatGPT、Claude Code不香嗎？