跳轉到主要內容

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 警告
  • 後端當機只在較大的提示權杖數或完整代理執行階段提示中出現
  • 本機 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 傳輸很可能已經正確；後端是在較大的代理執行階段提示形態上失敗。
  • 停用工具後失敗減少但沒有消失 → 工具 schema 是壓力的一部分，但剩餘問題仍是上游模型/伺服器容量或後端錯誤。
  1. 對只支援字串的 Chat Completions 後端設定 compat.requiresStringContent: true。
  2. 對無法可靠處理 OpenClaw 工具 schema 表面的模型/後端設定 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 之間的驗證模式/權杖不相符。
  • 在需要裝置身分時使用 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 → 用戶端可以使用快取的裝置權杖執行一次受信任重試。
  • 該快取權杖重試會重用與已配對裝置權杖一併儲存的快取範圍集。明確的 deviceToken / 明確的 scopes 呼叫者則保留其請求的範圍集。
  • 在該重試路徑之外，連線驗證優先順序是先使用明確共享權杖/密碼，再使用明確 deviceToken，再使用已儲存裝置權杖，最後使用啟動權杖。
  • 在非同步 Tailscale Serve 控制 UI 路徑上，相同 {scope, ip} 的失敗嘗試會在限制器記錄失敗前先序列化。因此，來自同一用戶端的兩次錯誤並行重試，第二次嘗試可能顯示 retry later，而不是兩次單純不相符。
  • 瀏覽器來源 loopback 用戶端傳回 too many failed authentication attempts (retry later) → 來自相同正規化 Origin 的重複失敗會暫時鎖定；另一個 localhost 來源會使用不同 bucket。
  • 之後重複出現 unauthorized → 共享權杖/裝置權杖漂移；重新整理權杖設定，並視需要重新核准/輪替裝置權杖。
  • 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快取的每裝置權杖已過期或遭撤銷。使用裝置 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/簽章錯誤，請更新連線用戶端並驗證：
1

等待 connect.challenge

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

簽署承載資料

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

傳送裝置 nonce

用戶端使用相同的 challenge nonce 傳送 connect.params.device.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) vs 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 → 本機 Gateway 模式未啟用，或設定檔被覆寫且遺失 gateway.mode。修正：在你的設定中設定 gateway.mode="local"，或重新執行 openclaw onboard --mode local / openclaw setup 以重新標記預期的本機模式設定。如果你透過 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 → 使用者層級服務缺失時，存在 systemd 系統單元。在允許 doctor 安裝使用者服務前，請移除或停用重複項；如果系統單元是預期的監督程式，請設定 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 啟動，但記錄表示已還原 openclaw.json 時使用。 
openclaw logs --follow
openclaw config file
openclaw config validate
openclaw doctor
檢查：
  • Config auto-restored from last-known-good
  • gateway: invalid config was restored from last-known-good backup
  • config reload restored last-known-good config after invalid-config
  • 作用中設定旁有帶時間戳記的 openclaw.json.clobbered.* 檔案
  • 以 Config recovery warning 開頭的主代理系統事件
  • 被拒絕的設定在啟動或熱重新載入期間未通過驗證。
  • OpenClaw 將被拒絕的承載資料保留為 .clobbered.*。
  • 作用中設定已從最後驗證過的上次已知良好副本還原。
  • 下一個主代理回合會收到警告，不要盲目重寫被拒絕的設定。
  • 如果所有驗證問題都位於 plugins.entries.<id>... 之下，OpenClaw 不會還原整個檔案。Plugin 本機失敗會保持明顯，同時不相關的使用者設定會留在作用中設定內。
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.* 存在 → 外部直接編輯或啟動讀取已被還原。
  • .rejected.* 存在 → OpenClaw 擁有的設定寫入在提交前未通過結構描述或覆寫檢查。
  • Config write rejected: → 該寫入嘗試移除必要形狀、讓檔案大幅縮小，或持久化無效設定。
  • missing-meta-vs-last-good、gateway-mode-missing-vs-last-good 或 size-drop-vs-last-good:* → 啟動時將目前檔案視為被覆寫，因為它與上次已知良好備份相比遺失欄位或大小縮減。
  • Config last-known-good promotion skipped → 候選項包含已遮蔽的秘密預留位置，例如 ***。
  1. 如果已還原的作用中設定正確，請保留它。
  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 警告文字 → 此命令路徑無法取得失敗目標的驗證材料。
相關：

​
Channel 已連線，但訊息未流動

如果 Channel 狀態已連線但訊息流程中斷，請聚焦在原則、權限和 Channel 特定的傳遞規則。 
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）。
  • 群組 allowlist 和提及需求。
  • 缺少 Channel 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 → 排程器計時滴答失敗；檢查檔案/記錄/執行階段錯誤。
  • heartbeat skipped 並帶有 reason=quiet-hours → 位於作用中時段範圍之外。
  • heartbeat skipped 並帶有 reason=empty-heartbeat-file → HEARTBEAT.md 存在，但只包含空白行 / markdown 標題，因此 OpenClaw 會略過模型呼叫。
  • heartbeat skipped 並帶有 reason=no-tasks-due → HEARTBEAT.md 包含 tasks: 區塊，但此計時滴答沒有任何到期工作。
  • 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 在線且具有預期能力。
  • 相機/麥克風/位置/螢幕的作業系統權限授予。
  • Exec 核准與允許清單狀態。
常見特徵：
  • NODE_BACKGROUND_UNAVAILABLE → Node app 必須位於前景。
  • *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → 缺少作業系統權限。
  • 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 profile 可連線性。
  • existing-session / user profiles 的本機 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 使用不支援的配置，例如 file: 或 ftp:。
  • browser.cdpUrl has invalid port → 設定的 CDP URL 有錯誤或超出範圍的連接埠。
  • Playwright is not available in this gateway build; '<feature>' is unsupported. → 目前的 Gateway 安裝缺少內建瀏覽器 Plugin 的 playwright-core 執行階段相依性；執行 openclaw doctor --fix，然後重新啟動 Gateway。ARIA 快照和基本頁面截圖仍可運作，但導覽、AI 快照、CSS 選擇器元素截圖和 PDF 匯出仍無法使用。
  • Could not find DevToolsActivePort for chrome → Chrome MCP existing-session 尚無法附加到選取的瀏覽器資料目錄。開啟瀏覽器檢查頁面、啟用遠端偵錯、保持瀏覽器開啟、核准第一次附加提示，然後重試。如果不需要登入狀態，建議使用受管理的 openclaw profile。
  • No Chrome tabs found for profile="user" → Chrome MCP 附加 profile 沒有開啟任何本機 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 → 僅附加 profile 沒有可連線的目標，或 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 上傳掛鉤需要快照 refs，而不是 CSS 選擇器。
  • existing-session file uploads currently support one file at a time. → 在 Chrome MCP profiles 上，每次呼叫傳送一個上傳。
  • existing-session dialog handling does not support timeoutMs. → Chrome MCP profiles 上的對話框掛鉤不支援 timeout 覆寫。
  • existing-session type does not support timeoutMs overrides. → 對 profile="user" / Chrome MCP existing-session profiles 的 act:type 省略 timeoutMs，或在需要自訂 timeout 時使用受管理/CDP 瀏覽器 profile。
  • existing-session evaluate does not support timeoutMs overrides. → 對 profile="user" / Chrome MCP existing-session profiles 的 act:evaluate 省略 timeoutMs，或在需要自訂 timeout 時使用受管理/CDP 瀏覽器 profile。
  • response body is not supported for existing-session profiles yet. → responsebody 仍需要受管理瀏覽器或原始 CDP profile。
  • 僅附加或遠端 CDP profiles 上的過期 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/密碼驗證，或正確設定的非 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
要檢查的項目：
  • 儀表板/Nodes 的待處理裝置核准。
  • 政策或身分變更後的待處理 DM 配對核准。
常見特徵：
  • device identity required → 裝置驗證未滿足。
  • pairing required → 傳送者/裝置必須先獲核准。
如果檢查後服務設定與執行階段仍不一致，請從相同 profile/狀態目錄重新安裝服務中繼資料： 
openclaw gateway install --force
openclaw gateway restart
相關：

​
相關