跳转到主要内容

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 传输层很可能已经正确；失败发生在后端处理更大的智能体运行时提示词形状时。
  • 禁用工具后失败减少但没有消失 → 工具模式是压力来源的一部分，但剩余问题仍是上游模型/服务器容量或后端错误。
  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
检查以下情况：
  • 私信发送者有待处理的配对。
  • 群组提及门控（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 调用方则保留其请求的作用域集合。
  • 在该重试路径之外，connect 认证优先级是：显式共享令牌/密码优先，然后是显式 deviceToken，再是已存储设备令牌，最后是引导令牌。
  • 在异步 Tailscale Serve 控制 UI 路径上，同一 {scope, ip} 的失败尝试会在限流器记录失败前被串行化。因此，来自同一客户端的两个错误并发重试可能会在第二次尝试时显示 retry later，而不是两个普通的不匹配。
  • 来自浏览器源 loopback 客户端的 too many failed authentication attempts (retry later) → 来自同一个规范化 Origin 的重复失败会被临时锁定；另一个 localhost 源使用单独的桶。
  • 该重试后仍反复出现 unauthorized → 共享令牌/设备令牌漂移；刷新令牌配置，并在需要时重新批准/轮换设备令牌。
  • gateway connect failed: → 主机/端口/URL 目标错误。

​
认证详情代码速查表

使用失败 connect 响应中的 error.details.code 来选择下一步操作：
详细代码含义推荐操作
AUTH_TOKEN_MISSING客户端没有发送必需的共享令牌。在客户端粘贴/设置令牌，然后重试。对于控制台路径：先运行 openclaw config get gateway.auth.token，然后粘贴到控制 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 网关令牌/密码进行身份验证的直接环回后端 RPC 不应依赖 CLI 的已配对设备作用域基线。如果 subagent 或其他内部调用仍因 scope-upgrade 失败，请确认调用方正在使用 client.id: "gateway-client" 和 client.mode: "backend"，并且没有强制使用显式 deviceIdentity 或设备令牌。
设备身份验证 v2 迁移检查： 
openclaw --version
openclaw doctor
openclaw gateway status
如果日志显示 nonce/签名错误，请更新连接客户端并验证它：
1

Wait for connect.challenge

客户端等待 Gateway 网关发出的 connect.challenge。
2

Sign the payload

客户端对绑定挑战的载荷进行签名。
3

Send the device nonce

客户端发送带有相同挑战 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) 与 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 → 没有有效 Gateway 网关身份验证路径（令牌/密码，或已配置的受信任代理）时绑定到了非环回地址。
  • 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 网关启动因 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 设置失败，但该命令仍尝试了直接配置/环回目标。
  • 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
查找：
  • 私信策略（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 目标解析为私信式目的地，而 agents.defaults.heartbeat.directPolicy（或单智能体覆盖项）设置为 block。
相关：

​
节点已配对，工具失败

如果节点已配对但工具失败，请隔离前台、权限和批准状态。 
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
openclaw status
查找：
  • 节点在线，并具备预期能力。
  • 摄像头/麦克风/定位/屏幕的操作系统权限授予。
  • Exec 批准和允许列表状态。
常见特征：
  • NODE_BACKGROUND_UNAVAILABLE → 节点应用必须位于前台。
  • *_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 配置可达性。
  • existing-session / user 配置的本地 Chrome 可用性。
  • unknown command "browser" 或 unknown command 'browser' → 内置浏览器插件被 plugins.allow 排除。
  • 浏览器工具缺失 / 不可用，而 browser.enabled=true → plugins.allow 排除了 browser，因此该插件从未加载。
  • 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 网关安装缺少核心浏览器运行时依赖；重新安装或更新 OpenClaw，然后重启 Gateway 网关。ARIA 快照和基础页面截图仍然可用，但导航、AI 快照、CSS 选择器元素截图以及 PDF 导出仍不可用。
  • Could not find DevToolsActivePort for chrome → Chrome MCP existing-session 尚无法附加到所选浏览器数据目录。打开浏览器检查页面，启用远程调试，保持浏览器打开，批准首次附加提示，然后重试。如果不需要登录状态，优先使用托管的 openclaw 配置。
  • No Chrome tabs found for profile="user" → Chrome MCP 附加配置没有打开的本地 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 → 仅附加配置没有可达目标，或 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 上传钩子需要快照 ref，而不是 CSS 选择器。
  • existing-session file uploads currently support one file at a time. → 在 Chrome MCP 配置上，每次调用发送一个上传文件。
  • existing-session dialog handling does not support timeoutMs. → Chrome MCP 配置上的对话框钩子不支持超时覆盖。
  • 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 配置。
  • 仅附加或远程 CDP 配置上的过期视口 / 深色模式 / 区域设置 / 离线覆盖项 → 运行 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 网关存活，但使用当前认证/url 无法访问。
openclaw devices list
openclaw pairing list --channel <channel> [--account <id>]
openclaw logs --follow
openclaw doctor
检查内容：
  • 仪表板/节点存在待处理设备批准。
  • 策略或身份变更后存在待处理私信配对批准。
常见特征：
  • device identity required → 设备认证未满足。
  • pairing required → 发送者/设备必须获批。
如果检查后服务配置和运行时仍不一致，请从同一个配置/状态目录重新安装服务元数据： 
openclaw gateway install --force
openclaw gateway restart
相关：

​
相关