跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

此頁是深入執行手冊。如果你想先使用快速分診流程，請從 /help/troubleshooting 開始。

​
命令階梯

請依序先執行這些命令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
預期的健康訊號：
  • openclaw gateway status 會顯示 Runtime: running、Connectivity probe: ok，以及一行 Capability: ...。
  • openclaw doctor 回報沒有阻塞性的設定/服務問題。
  • openclaw channels status --probe 顯示每個帳號的即時傳輸狀態，並在支援時顯示探測/稽核結果，例如 works 或 audit ok。

​
分歧安裝與較新設定防護

當 Gateway 服務在更新後非預期停止，或日誌顯示某個 openclaw 二進位檔比上次寫入 openclaw.json 的版本還舊時，請使用此流程。 OpenClaw 會用 meta.lastTouchedVersion 標記設定寫入。唯讀命令仍可檢查由較新版 OpenClaw 寫入的設定，但處理程序和服務變更會拒絕由較舊的二進位檔繼續執行。被封鎖的動作包含 Gateway 服務啟動、停止、重新啟動、解除安裝、強制重新安裝服務、服務模式 Gateway 啟動，以及 gateway --force 連接埠清理。 
which openclaw
openclaw --version
openclaw gateway status --deep
openclaw config get meta.lastTouchedVersion
1

修正 PATH

修正 PATH，讓 openclaw 解析到較新的安裝版本，然後重新執行該動作。
2

重新安裝 Gateway 服務

從較新的安裝版本重新安裝預期的 Gateway 服務：
openclaw gateway install --force
openclaw gateway restart
3

移除過期包裝器

移除仍指向舊 openclaw 二進位檔的過期系統套件或舊包裝器項目。
僅限有意降級或緊急復原時，才針對單一命令設定 OPENCLAW_ALLOW_OLDER_BINARY_DESTRUCTIVE_ACTIONS=1。正常操作時請保持未設定。

​
Anthropic 429 長上下文需要額外用量

當日誌/錯誤包含：HTTP 429: rate_limit_error: Extra usage is required for long context requests 時，請使用此流程。 
openclaw logs --follow
openclaw models status
openclaw config get agents.defaults.models
檢查：
  • 選取的 Anthropic Opus/Sonnet 模型具有 params.context1m: true。
  • 目前的 Anthropic 認證不符合長上下文使用資格。
  • 請求只在需要 1M beta 路徑的長工作階段/模型執行中失敗。
修正選項：
1

停用 context1m

對該模型停用 context1m，以退回正常上下文視窗。
2

使用符合資格的認證

使用符合長上下文請求資格的 Anthropic 認證，或切換到 Anthropic API 金鑰。
3

設定備援模型

設定備援模型，讓執行在 Anthropic 長上下文請求遭拒時仍可繼續。
相關：

​
本機 OpenAI 相容後端通過直接探測，但代理執行失敗

在以下情況使用此流程：
  • curl ... /v1/models 可運作
  • 微型直接 /v1/chat/completions 呼叫可運作
  • OpenClaw 模型執行只在一般代理回合失敗
curl http://127.0.0.1:1234/v1/models
curl http://127.0.0.1:1234/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"<id>","messages":[{"role":"user","content":"hi"}],"stream":false}'
openclaw infer model run --model <provider/model> --prompt "hi" --json
openclaw logs --follow
檢查：
  • 直接微型呼叫成功，但 OpenClaw 執行只在較大的提示下失敗
  • 即使直接 /v1/chat/completions 可使用相同裸模型 id 運作，仍出現 model_not_found 或 404 錯誤
  • 後端錯誤指出 messages[].content 預期是字串
  • 使用 OpenAI 相容本機後端時，間歇出現 incomplete turn detected ... stopReason=stop payloads=0 警告
  • 只在較大的提示 Token 數量或完整代理執行階段提示下出現的後端當機
  • 本機 MLX/vLLM 風格伺服器出現 model_not_found → 確認 baseUrl 包含 /v1，對 /v1/chat/completions 後端而言 api 是 "openai-completions"，且 models.providers.<provider>.models[].id 是裸的供應商本機 id。選取時加一次供應商前綴，例如 mlx/mlx-community/Qwen3-30B-A3B-6bit；目錄項目則保持為 mlx-community/Qwen3-30B-A3B-6bit。
  • messages[...].content: invalid type: sequence, expected a string → 後端拒絕結構化 Chat Completions 內容片段。修正：設定 models.providers.<provider>.models[].compat.requiresStringContent: true。
  • incomplete turn detected ... stopReason=stop payloads=0 → 後端完成了 Chat Completions 請求，但該回合沒有傳回使用者可見的助理文字。OpenClaw 會對可安全重播的空白 OpenAI 相容回合重試一次；若持續失敗，通常表示後端正在發出空白/非文字內容，或抑制最終答案文字。
  • 直接微型請求成功，但 OpenClaw 代理執行因後端/模型當機而失敗（例如某些 inferrs 建置上的 Gemma）→ OpenClaw 傳輸很可能已正確；後端在較大的代理執行階段提示形狀上失敗。
  • 停用工具後失敗範圍縮小但未消失 → 工具結構描述是壓力來源之一，但剩餘問題仍是上游模型/伺服器容量或後端錯誤。
  1. 對僅支援字串的 Chat Completions 後端設定 compat.requiresStringContent: true。
  2. 對無法可靠處理 OpenClaw 工具結構描述表面的模型/後端設定 compat.supportsTools: false。
  3. 盡可能降低提示壓力：較小的工作區啟動內容、較短的工作階段歷史、較輕量的本機模型，或具備更強長上下文支援的後端。
  4. 如果微型直接請求持續通過，但 OpenClaw 代理回合仍在後端內部當機，請將其視為上游伺服器/模型限制，並使用已接受的酬載形狀在上游提交重現案例。
相關：

​
沒有回覆

如果通道已啟動但沒有任何回應，重新連線任何項目之前，請先檢查路由與政策。 
openclaw status
openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw config get channels
openclaw logs --follow
檢查：
  • DM 傳送者的配對待處理。
  • 群組提及閘控（requireMention、mentionPatterns）。
  • 通道/群組允許清單不相符。
常見特徵：
  • drop guild message (mention required → 群組訊息在被提及前會被忽略。
  • pairing request → 傳送者需要核准。
  • blocked / allowlist → 傳送者/通道已被政策篩除。
相關：

​
儀表板控制 UI 連線能力

當儀表板/控制 UI 無法連線時，請驗證 URL、驗證模式與安全上下文假設。 
openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --json
檢查：
  • 正確的探測 URL 和儀表板 URL。
  • 用戶端與 Gateway 之間的驗證模式/Token 不相符。
  • 在需要裝置身分時使用 HTTP。
  • device identity required → 非安全上下文或缺少裝置驗證。
  • origin not allowed → 瀏覽器 Origin 不在 gateway.controlUi.allowedOrigins 中（或你正從非 loopback 瀏覽器來源連線，且沒有明確允許清單）。
  • device nonce required / device nonce mismatch → 用戶端未完成以挑戰為基礎的裝置驗證流程（connect.challenge + device.nonce）。
  • device signature invalid / device signature expired → 用戶端針對目前握手簽署了錯誤的酬載（或過期的時間戳記）。
  • AUTH_TOKEN_MISMATCH 且 canRetryWithDeviceToken=true → 用戶端可使用快取的裝置 Token 執行一次受信任重試。
  • 該快取 Token 重試會重用與已配對裝置 Token 一起儲存的快取範圍集。明確 deviceToken / 明確 scopes 呼叫者則保留其要求的範圍集。
  • 在該重試路徑之外，連線驗證優先順序為明確共享 Token/密碼優先，接著是明確 deviceToken，再來是已儲存的裝置 Token，最後是啟動 Token。
  • 在非同步 Tailscale Serve 控制 UI 路徑上，來自相同 {scope, ip} 的失敗嘗試會在限制器記錄失敗之前被序列化。因此，來自相同用戶端的兩次錯誤並行重試，可能會在第二次嘗試顯示 retry later，而不是兩次單純的不相符。
  • 來自瀏覽器來源 loopback 用戶端的 too many failed authentication attempts (retry later) → 來自相同正規化 Origin 的重複失敗會被暫時鎖定；另一個 localhost 來源會使用獨立的儲存桶。
  • 該重試後仍反覆出現 unauthorized → 共享 Token/裝置 Token 漂移；請重新整理 Token 設定，必要時重新核准/輪替裝置 Token。
  • gateway connect failed: → 錯誤的主機/連接埠/url 目標。

​
驗證詳細代碼速查表

使用失敗 connect 回應中的 error.details.code 來選擇下一個動作：
詳細資訊代碼意義建議動作
AUTH_TOKEN_MISSING用戶端未傳送必要的共用權杖。在用戶端貼上/設定權杖後重試。Dashboard 路徑：openclaw config get gateway.auth.token，然後貼到 Control UI 設定中。
AUTH_TOKEN_MISMATCH共用權杖與 Gateway 驗證權杖不符。如果 canRetryWithDeviceToken=true，允許一次受信任的重試。快取權杖重試會重用已儲存核准的權限範圍；明確的 deviceToken / scopes 呼叫者會保留要求的權限範圍。如果仍然失敗，請執行權杖漂移復原檢查清單。
AUTH_DEVICE_TOKEN_MISMATCH快取的每裝置權杖已過期或遭撤銷。使用 devices CLI 輪替/重新核准裝置權杖，然後重新連線。
PAIRING_REQUIRED裝置身分需要核准。檢查 error.details.reason 是否為 not-paired、scope-upgrade、role-upgrade 或 metadata-upgrade，並在存在時使用 requestId / remediationHint。核准待處理要求：openclaw devices list，然後執行 openclaw devices approve <requestId>。權限範圍/角色升級會在你檢閱要求的存取權後使用相同流程。
使用共用 Gateway 權杖/密碼驗證的直接 loopback 後端 RPC，不應依賴 CLI 的已配對裝置權限範圍基準。如果子代理程式或其他內部呼叫仍因 scope-upgrade 失敗，請確認呼叫者使用的是 client.id: "gateway-client" 和 client.mode: "backend"，且未強制指定明確的 deviceIdentity 或裝置權杖。
裝置驗證 v2 遷移檢查： 
openclaw --version
openclaw doctor
openclaw gateway status
如果記錄顯示 nonce/signature 錯誤，請更新連線用戶端並驗證：
1

等待 connect.challenge

用戶端等待 Gateway 發出的 connect.challenge。
2

簽署承載資料

用戶端簽署與 challenge 綁定的承載資料。
3

傳送裝置 nonce

用戶端傳送 connect.params.device.nonce，並使用相同的 challenge nonce。
如果 openclaw devices rotate / revoke / remove 被意外拒絕：
  • 已配對裝置權杖工作階段只能管理自己的裝置，除非呼叫者同時具備 operator.admin
  • openclaw devices rotate --scope ... 只能要求呼叫者工作階段已持有的操作者權限範圍
相關：

​
Gateway 服務未執行

服務已安裝但程序無法持續執行時使用此項。 
openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --deep   # also scan system-level services
尋找：
  • Runtime: stopped 並附有結束提示。
  • 服務設定不相符（Config (cli) 與 Config (service)）。
  • 連接埠/監聽器衝突。
  • 使用 --deep 時出現額外的 launchd/systemd/schtasks 安裝。
  • Other gateway-like services detected (best effort) 清理提示。
  • Gateway start blocked: set gateway.mode=local 或 existing config is missing gateway.mode → local Gateway 模式未啟用，或設定檔被覆寫並遺失 gateway.mode。修正：在你的設定中設定 gateway.mode="local"，或重新執行 openclaw onboard --mode local / openclaw setup，以重新標記預期的 local 模式設定。如果你透過 Podman 執行 OpenClaw，預設設定路徑是 ~/.openclaw/openclaw.json。
  • refusing to bind gateway ... without auth → 非 loopback 綁定缺少有效的 Gateway 驗證路徑（權杖/密碼，或已設定時的受信任 Proxy）。
  • another gateway instance is already listening / EADDRINUSE → 連接埠衝突。
  • Other gateway-like services detected (best effort) → 存在過時或並行的 launchd/systemd/schtasks 單元。大多數設定應每台機器保留一個 Gateway；如果你確實需要多個，請隔離連接埠 + 設定/狀態/工作區。請參閱 /gateway#multiple-gateways-same-host。
  • doctor 顯示 System-level OpenClaw gateway service detected → user-level 服務缺失，但存在 systemd system 單元。在允許 doctor 安裝使用者服務前，請移除或停用重複項；如果該 system 單元是預期的監督程式，請設定 OPENCLAW_SERVICE_REPAIR_POLICY=external。
  • Gateway service port does not match current gateway config → 已安裝的監督程式仍固定舊的 --port。執行 openclaw doctor --fix 或 openclaw gateway install --force，然後重新啟動 Gateway 服務。
相關：

​
Gateway 拒絕無效設定

Gateway 啟動因 Invalid config 失敗，或熱重新載入記錄顯示 已略過無效編輯時使用此項。 
openclaw logs --follow
openclaw config file
openclaw config validate
openclaw doctor
尋找：
  • Invalid config at ...
  • config reload skipped (invalid config): ...
  • Config write rejected: ...
  • 作用中設定旁的帶時間戳記 openclaw.json.rejected.* 檔案
  • 如果 doctor --fix 修復了損壞的直接編輯，則會有帶時間戳記的 openclaw.json.clobbered.* 檔案
  • 設定在啟動、熱重新載入或 OpenClaw 擁有的寫入期間未通過驗證。
  • Gateway 啟動會安全失敗，而不是重寫 openclaw.json。
  • 熱重新載入會略過無效的外部編輯，並保持目前的執行階段設定作用中。
  • OpenClaw 擁有的寫入會在提交前拒絕無效/破壞性承載資料，並儲存 .rejected.*。
  • openclaw doctor --fix 負責修復。它可以移除非 JSON 前置內容，或還原最後已知良好副本，同時將被拒絕的承載資料保留為 .clobbered.*。
CONFIG="$(openclaw config file)"
ls -lt "$CONFIG".clobbered.* "$CONFIG".rejected.* 2>/dev/null | head
diff -u "$CONFIG" "$(ls -t "$CONFIG".clobbered.* 2>/dev/null | head -n 1)"
openclaw config validate
openclaw doctor
  • .clobbered.* 存在 → doctor 在修復作用中設定時保留了損壞的外部編輯。
  • .rejected.* 存在 → OpenClaw 擁有的設定寫入在提交前未通過 schema 或覆寫檢查。
  • Config write rejected: → 寫入嘗試移除必要結構、大幅縮小檔案，或保留無效設定。
  • config reload skipped (invalid config): → 直接編輯驗證失敗，並被執行中的 Gateway 忽略。
  • Invalid config at ... → Gateway 服務啟動前，啟動已失敗。
  • missing-meta-vs-last-good、gateway-mode-missing-vs-last-good 或 size-drop-vs-last-good:* → OpenClaw 擁有的寫入因相較於最後已知良好備份遺失欄位或大小而遭拒絕。
  • Config last-known-good promotion skipped → 候選內容包含已遮蔽的秘密預留位置，例如 ***。
  1. 執行 openclaw doctor --fix，讓 doctor 修復帶前置內容/被覆寫的設定，或還原最後已知良好設定。
  2. 只從 .clobbered.* 或 .rejected.* 複製預期的鍵，然後使用 openclaw config set 或 config.patch 套用。
  3. 重新啟動前執行 openclaw config validate。
  4. 如果你手動編輯，請保留完整 JSON5 設定，而不是只保留你想變更的部分物件。
相關：

​
Gateway 探測警告

當 openclaw gateway probe 觸達某些目標，但仍列印警告區塊時使用此項。 
openclaw gateway probe
openclaw gateway probe --json
openclaw gateway probe --ssh user@gateway-host
尋找：
  • JSON 輸出中的 warnings[].code 和 primaryTargetId。
  • 警告是否與 SSH 後援、多個 Gateway、缺少權限範圍，或無法解析的驗證參照有關。
常見特徵：
  • SSH tunnel failed to start; falling back to direct probes. → SSH 設定失敗，但命令仍嘗試直接探測已設定/loopback 目標。
  • multiple reachable gateways detected → 超過一個目標回應。這通常代表有意的多 Gateway 設定，或過時/重複的監聽器。
  • Read-probe diagnostics are limited by gateway scopes (missing operator.read) → 連線成功，但詳細 RPC 受權限範圍限制；請配對裝置身分，或使用具備 operator.read 的憑證。
  • Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → 連線成功，但完整診斷 RPC 集逾時或失敗。將此視為可觸達但診斷降級的 Gateway；比較 --json 輸出中的 connect.ok 和 connect.rpcOk。
  • Capability: pairing-pending 或 gateway closed (1008): pairing required → Gateway 已回應，但此用戶端仍需配對/核准，才能進行一般操作者存取。
  • 未解析的 gateway.auth.* / gateway.remote.* SecretRef 警告文字 → 在此命令路徑中，失敗目標無法取得驗證材料。
相關：

​
頻道已連線，但訊息未流動

如果頻道狀態為已連線，但訊息流已停止，請聚焦於原則、權限和頻道特定的傳遞規則。 
openclaw channels status --probe
openclaw pairing list --channel <channel> [--account <id>]
openclaw status --deep
openclaw logs --follow
openclaw config get channels
尋找：
  • DM 政策（pairing、allowlist、open、disabled）。
  • 群組允許清單與提及要求。
  • 缺少頻道 API 權限/範圍。
常見特徵：
  • mention required → 訊息因群組提及政策而被忽略。
  • pairing / 待核准追蹤 → 傳送者尚未核准。
  • missing_scope、not_in_channel、Forbidden、401/403 → 頻道驗證/權限問題。
相關：

​
Cron 與 Heartbeat 傳遞

如果 Cron 或 Heartbeat 未執行或未傳遞，請先驗證排程器狀態，再驗證傳遞目標。 
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
檢查：
  • Cron 已啟用且存在下一次喚醒。
  • 作業執行歷程狀態（ok、skipped、error）。
  • Heartbeat 略過原因（quiet-hours、requests-in-flight、cron-in-progress、lanes-busy、alerts-disabled、empty-heartbeat-file、no-tasks-due）。
  • cron: scheduler disabled; jobs will not run automatically → Cron 已停用。
  • cron: timer tick failed → 排程器 tick 失敗；檢查檔案/日誌/執行階段錯誤。
  • heartbeat skipped 搭配 reason=quiet-hours → 不在作用中時段視窗內。
  • heartbeat skipped 搭配 reason=empty-heartbeat-file → HEARTBEAT.md 存在但只包含空白行/Markdown 標題，因此 OpenClaw 會略過模型呼叫。
  • heartbeat skipped 搭配 reason=no-tasks-due → HEARTBEAT.md 包含 tasks: 區塊，但這次 tick 沒有任何到期任務。
  • heartbeat: unknown accountId → Heartbeat 傳遞目標的帳戶 ID 無效。
  • heartbeat skipped 搭配 reason=dm-blocked → Heartbeat 目標解析為 DM 樣式目的地，而 agents.defaults.heartbeat.directPolicy（或每個 agent 的覆寫）設定為 block。
相關：

​
Node 已配對，工具失敗

如果 Node 已配對但工具失敗，請隔離前景、權限與核准狀態。 
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
openclaw status
檢查：
  • Node 在線上且具備預期功能。
  • 攝影機/麥克風/定位/螢幕的 OS 權限授權。
  • Exec 核准與允許清單狀態。
常見特徵：
  • NODE_BACKGROUND_UNAVAILABLE → Node app 必須在前景。
  • *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → 缺少 OS 權限。
  • SYSTEM_RUN_DENIED: approval required → exec 核准待處理。
  • SYSTEM_RUN_DENIED: allowlist miss → 命令被允許清單封鎖。
相關：

​
瀏覽器工具失敗

當瀏覽器工具動作失敗但 Gateway 本身健康時，請使用這些檢查。 
openclaw browser status
openclaw browser start --browser-profile openclaw
openclaw browser profiles
openclaw logs --follow
openclaw doctor
檢查：
  • 是否設定 plugins.allow 並包含 browser。
  • 有效的瀏覽器可執行檔路徑。
  • CDP 設定檔可連線性。
  • existing-session / user 設定檔的本機 Chrome 可用性。
  • unknown command "browser" 或 unknown command 'browser' → 內建瀏覽器 Plugin 被 plugins.allow 排除。
  • 瀏覽器工具缺少/不可用，但 browser.enabled=true → plugins.allow 排除 browser，因此 Plugin 從未載入。
  • Failed to start Chrome CDP on port → 瀏覽器程序啟動失敗。
  • browser.executablePath not found → 設定的路徑無效。
  • browser.cdpUrl must be http(s) or ws(s) → 設定的 CDP URL 使用不支援的 scheme，例如 file: 或 ftp:。
  • browser.cdpUrl has invalid port → 設定的 CDP URL 有錯誤或超出範圍的連接埠。
  • Playwright is not available in this gateway build; '<feature>' is unsupported. → 目前的 Gateway 安裝缺少核心瀏覽器執行階段相依性；重新安裝或更新 OpenClaw，然後重新啟動 Gateway。ARIA 快照與基本頁面截圖仍可運作，但導覽、AI 快照、CSS selector 元素截圖與 PDF 匯出仍不可用。
  • Could not find DevToolsActivePort for chrome → Chrome MCP existing-session 尚無法連接到所選瀏覽器資料目錄。開啟瀏覽器檢查頁面、啟用遠端偵錯、保持瀏覽器開啟、核准第一次連接提示，然後重試。如果不需要登入狀態，請優先使用受管理的 openclaw 設定檔。
  • No Chrome tabs found for profile="user" → Chrome MCP attach 設定檔沒有開啟中的本機 Chrome 分頁。
  • Remote CDP for profile "<name>" is not reachable → 設定的遠端 CDP 端點無法從 Gateway 主機連線。
  • Browser attachOnly is enabled ... not reachable 或 Browser attachOnly is enabled and CDP websocket ... is not reachable → attach-only 設定檔沒有可連線的目標，或 HTTP 端點有回應，但 CDP WebSocket 仍無法開啟。
  • fullPage is not supported for element screenshots → 截圖請求將 --full-page 與 --ref 或 --element 混用。
  • element screenshots are not supported for existing-session profiles; use ref from snapshot. → Chrome MCP / existing-session 截圖呼叫必須使用頁面擷取或快照 --ref，不能使用 CSS --element。
  • existing-session file uploads do not support element selectors; use ref/inputRef. → Chrome MCP 上傳 hook 需要快照 ref，而不是 CSS selector。
  • existing-session file uploads currently support one file at a time. → 在 Chrome MCP 設定檔上，每次呼叫傳送一個上傳。
  • existing-session dialog handling does not support timeoutMs. → Chrome MCP 設定檔上的對話框 hook 不支援逾時覆寫。
  • existing-session type does not support timeoutMs overrides. → 在 profile="user" / Chrome MCP existing-session 設定檔上，對 act:type 省略 timeoutMs；或在需要自訂逾時時使用受管理/CDP 瀏覽器設定檔。
  • existing-session evaluate does not support timeoutMs overrides. → 在 profile="user" / Chrome MCP existing-session 設定檔上，對 act:evaluate 省略 timeoutMs；或在需要自訂逾時時使用受管理/CDP 瀏覽器設定檔。
  • response body is not supported for existing-session profiles yet. → responsebody 仍需要受管理瀏覽器或原始 CDP 設定檔。
  • attach-only 或遠端 CDP 設定檔上的過期 viewport / 深色模式 / locale / 離線覆寫 → 執行 openclaw browser stop --browser-profile <name>，關閉作用中的控制工作階段並釋放 Playwright/CDP 模擬狀態，而不重新啟動整個 Gateway。
相關：

​
如果你升級後某些東西突然壞掉

大多數升級後故障是設定漂移，或現在開始強制執行更嚴格的預設值。 
openclaw gateway status
openclaw config get gateway.mode
openclaw config get gateway.remote.url
openclaw config get gateway.auth.mode
要檢查的項目：
  • 如果 gateway.mode=remote，CLI 呼叫可能會以遠端為目標，而你的本機服務是正常的。
  • 明確的 --url 呼叫不會回退到已儲存的認證。
常見特徵：
  • gateway connect failed: → URL 目標錯誤。
  • unauthorized → 端點可連線，但驗證錯誤。
openclaw config get gateway.bind
openclaw config get gateway.auth.mode
openclaw config get gateway.auth.token
openclaw gateway status
openclaw logs --follow
要檢查的項目：
  • 非 loopback 繫結（lan、tailnet、custom）需要有效的 Gateway 驗證路徑：共用 token/password 驗證，或正確設定的非 loopback trusted-proxy 部署。
  • 舊鍵如 gateway.token 不會取代 gateway.auth.token。
常見特徵：
  • refusing to bind gateway ... without auth → 非 loopback 繫結缺少有效的 Gateway 驗證路徑。
  • Connectivity probe: failed 但執行階段正在執行 → Gateway 存活，但目前 auth/url 無法存取。
openclaw devices list
openclaw pairing list --channel <channel> [--account <id>]
openclaw logs --follow
openclaw doctor
要檢查的項目：
  • dashboard/nodes 的待核准裝置。
  • 政策或身分變更後待核准的 DM 配對。
常見特徵：
  • device identity required → 裝置驗證未滿足。
  • pairing required → 傳送者/裝置必須核准。
如果檢查後服務設定與執行階段仍不一致，請從相同的設定檔/狀態目錄重新安裝服務 metadata： 
openclaw gateway install --force
openclaw gateway restart
相關：

​
相關