故障排除 🔧

当 OpenClaw 出现问题时,这里是修复方法。

如果您只想要快速分类方案,请先查看 FAQ 的前 60 秒。本页面深入介绍运行时故障和诊断。

状态与诊断

快速分类命令(按顺序):

命令	告诉你什么	何时使用
`openclaw status`	本地摘要:OS + 更新、网关可达性/模式、服务、代理/会话、提供商配置状态	首次检查,快速概览
`openclaw status --all`	完整本地诊断(只读、可粘贴、相对安全)包括日志尾部	需要共享调试报告时
`openclaw status --deep`	运行网关健康检查(包括提供商探测;需要可达的网关)	"已配置"不等于"工作"时
`openclaw gateway probe`	网关发现 + 可达性(本地 + 远程目标)	怀疑探测了错误的网关时
`openclaw channels status --probe`	向运行中的网关询问频道状态(可选探测)	网关可达但频道异常时
`openclaw gateway status`	监督器状态(launchd/systemd/schtasks)、运行时 PID/退出、最后一次网关错误	服务"看起来已加载"但无运行时
`openclaw logs --follow`	实时日志(运行时问题的最佳信号)	需要实际故障原因时

共享输出: 优先使用 openclaw status --all(它会隐藏令牌)。如果粘贴 openclaw status,考虑先设置 OPENCLAW_SHOW_SECRETS=0(令牌预览)。

另见:健康检查和日志记录。

常见问题

未找到提供商"anthropic"的 API 密钥

这意味着代理的认证存储为空或缺少 Anthropic 凭据。认证是按代理的,因此新代理不会继承主代理的密钥。

修复选项:

重新运行入门流程并为该代理选择 Anthropic。

或在网关主机上粘贴 setup-token:

bash

openclaw models auth setup-token --provider anthropic

或从主代理目录复制 auth-profiles.json 到新代理目录。

验证:

bash

openclaw models status

OAuth 令牌刷新失败(Anthropic Claude 订阅)

这意味着存储的 Anthropic OAuth 令牌已过期且刷新失败。如果您使用 Claude 订阅(无 API 密钥),最可靠的修复方法是切换到 Claude Code setup-token 并在网关主机上粘贴它。

推荐(setup-token):

bash

# Run on the gateway host (paste the setup-token)
openclaw models auth setup-token --provider anthropic
openclaw models status

如果您在其他地方生成了令牌:

bash

openclaw models auth paste-token --provider anthropic
openclaw models status

更多详情:Anthropic和OAuth。

控制 UI 在 HTTP 上失败("需要设备身份"/"连接失败")

如果您通过普通 HTTP 打开仪表板(例如 http://<lan-ip>:18789/ 或 http://<tailscale-ip>:18789/),浏览器在非安全上下文中运行并阻止 WebCrypto,因此无法生成设备身份。

修复:

优先通过Tailscale Serve使用 HTTPS。
或在网关主机上本地打开:http://127.0.0.1:18789/。
如果必须使用 HTTP,启用 gateway.controlUi.allowInsecureAuth: true 并使用网关令牌(仅令牌;无设备身份/配对)。见控制 UI。

CI 密钥扫描失败

这意味着 detect-secrets 发现了基线中尚未包含的新候选项。遵循密钥扫描。

服务已安装但无任何运行

如果网关服务已安装但进程立即退出,服务可能显示"已加载"但实际无任何运行。

检查:

bash

openclaw gateway status
openclaw doctor

Doctor/service 将显示运行时状态(PID/最后退出)和日志提示。

日志:

首选:openclaw logs --follow
文件日志(总是):/tmp/openclaw/openclaw-YYYY-MM-DD.log(或您配置的 logging.file)
macOS LaunchAgent(如果已安装):$OPENCLAW_STATE_DIR/logs/gateway.log 和 gateway.err.log
Linux systemd(如果已安装):journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager
Windows:schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST

启用更多日志:

提高文件日志详细度(持久化 JSONL):
json
```
{ "logging": { "level": "debug" } }
```
1

提高控制台详细度(仅 TTY 输出):

json

{ "logging": { "consoleLevel": "debug", "consoleStyle": "pretty" } }

快速提示:--verbose 仅影响控制台输出。文件日志仍由 logging.level 控制。

查看/logging以获取格式、配置和访问的完整概述。

"网关启动被阻止:设置 gateway.mode=local"

这意味着配置存在但 gateway.mode 未设置(或不是 local),因此网关拒绝启动。

修复(推荐):

运行向导并将网关运行模式设置为 Local:
bash
```
openclaw configure
```
1
或直接设置:
bash
```
openclaw config set gateway.mode local
```
1

如果您本意是运行远程网关:

设置远程 URL 并保持 gateway.mode=remote:

bash

openclaw config set gateway.mode remote
openclaw config set gateway.remote.url "wss://gateway.example.com"

仅临时/开发: 传递 --allow-unconfigured 以在没有 gateway.mode=local 的情况下启动网关。

还没有配置文件? 运行 openclaw setup 创建启动配置,然后重新运行网关。

服务环境(PATH + 运行时)

网关服务使用最小 PATH运行以避免 shell/管理器杂质:

macOS:/opt/homebrew/bin、/usr/local/bin、/usr/bin、/bin
Linux:/usr/local/bin、/usr/bin、/bin

这特意排除了版本管理器(nvm/fnm/volta/asdf)和包管理器(pnpm/npm),因为服务不加载您的 shell 初始化。运行时变量如 DISPLAY 应该位于 ~/.openclaw/.env(由网关早期加载)。在 host=gateway 上执行会将您的登录 shell PATH 合并到执行环境中, 因此缺少工具通常意味着您的 shell 初始化没有导出它们(或设置 tools.exec.pathPrepend)。见/tools/exec。

WhatsApp + Telegram 频道需要 Node;不支持 Bun。如果您的服务是用 Bun 或版本管理的 Node 路径安装的,运行 openclaw doctor 迁移到系统 Node 安装。

技能在沙箱中缺少 API 密钥

症状: 技能在主机上工作但在沙箱中因缺少 API 密钥而失败。

原因: 沙箱执行在 Docker 内运行,不继承主机 process.env。

修复:

设置 agents.defaults.sandbox.docker.env(或按代理设置 agents.list[].sandbox.docker.env)
或将密钥烘焙到您的自定义沙箱镜像中
然后运行 openclaw sandbox recreate --agent <id>(或 --all)

服务运行但端口未监听

如果服务报告运行中但网关端口上没有监听, 网关可能拒绝绑定。

这里"运行中"的含义

Runtime: running 意味着您的监督器(launchd/systemd/schtasks)认为进程处于活动状态。
RPC probe 意味着 CLI 实际上可以连接到网关 WebSocket 并调用 status。
始终相信 Probe target: + Config (service): 作为"我们实际尝试了什么?"行。

检查:

gateway.mode 对于 local 和服务必须是 openclaw gateway。
如果设置了 gateway.mode=remote,CLI 默认为远程 URL。服务仍可能在本地运行,但您的 CLI 可能探测了错误的位置。使用 openclaw gateway status 查看服务解析的端口 + 探测目标(或传递 --url)。
openclaw gateway status 和 openclaw doctor 在服务看起来运行但端口关闭时显示日志中的最后一次网关错误。
非回环绑定(lan/tailnet/custom,或回环不可用时的 auto)需要认证: gateway.auth.token(或 OPENCLAW_GATEWAY_TOKEN)。
gateway.remote.token 仅用于远程 CLI 调用;它不启用本地认证。
gateway.token 被忽略;使用 gateway.auth.token。

如果 openclaw gateway status 显示配置不匹配

Config (cli): ... 和 Config (service): ... 通常应该匹配。
如果不匹配,您几乎肯定在编辑一个配置而服务正在运行另一个。
修复:从您希望服务使用的相同 openclaw gateway install --force / --profile 重新运行 OPENCLAW_STATE_DIR。

如果 openclaw gateway status 报告服务配置问题

监督器配置(launchd/systemd/schtasks)缺少当前默认值。
修复:运行 openclaw doctor 更新它(或 openclaw gateway install --force 完全重写)。

如果 Last gateway error: 提到"拒绝绑定…无认证"

您将 gateway.bind 设置为非回环模式(lan/tailnet/custom,或回环不可用时的 auto)但没有配置认证。
修复:设置 gateway.auth.mode + gateway.auth.token(或导出 OPENCLAW_GATEWAY_TOKEN)并重启服务。

如果 openclaw gateway status 显示 bind=tailnet 但未找到 tailnet 接口

网关尝试绑定到 Tailscale IP(100.64.0.0/10)但在主机上未检测到。
修复:在该机器上启动 Tailscale(或将 gateway.bind 更改为 loopback/lan)。

如果 Probe note: 显示探测使用回环

这对于 bind=lan 是预期的:网关监听 0.0.0.0(所有接口),回环仍应在本地连接。
对于远程客户端,使用真实的 LAN IP(不是 0.0.0.0)加端口,并确保配置了认证。

地址已在使用中(端口 18789)

这意味着某些东西已经在监听网关端口。

检查:

bash

openclaw gateway status

它将显示监听器和可能的原因(网关已运行、SSH 隧道)。如果需要,停止服务或选择不同的端口。

检测到额外的工作区文件夹

如果您从旧版本升级,磁盘上可能仍有 ~/openclaw。多个工作区目录可能导致混乱的认证或状态漂移,因为只有一个工作区是活动的。

修复: 保留单个活动工作区并归档/删除其余的。见代理工作区。

主聊天在沙箱工作区中运行

症状:pwd 或文件工具显示 ~/.openclaw/sandboxes/...,即使您期望主机工作区。

原因: agents.defaults.sandbox.mode: "non-main" 基于 session.mainKey(默认 "main")。群组/频道会话使用它们自己的键,因此被视为非主要并获得沙箱工作区。

修复选项:

如果您希望代理使用主机工作区:设置 agents.list[].sandbox.mode: "off"。
如果您希望在沙箱内访问主机工作区:为该代理设置 workspaceAccess: "rw"。

"代理已中止"

代理在响应过程中被中断。

原因:

用户发送了 stop、abort、esc、wait 或 exit
超时
进程崩溃

修复: 只需发送另一条消息。会话继续。

"代理在回复前失败:未知模型:anthropic/claude-haiku-3-5"

OpenClaw 有意拒绝较旧/不安全的模型(特别是那些更容易受到提示注入攻击的模型)。如果您看到此错误,该模型名称不再受支持。

修复:

为提供商选择最新模型并更新您的配置或模型别名。
如果您不确定哪些模型可用,运行 openclaw models list 或 openclaw models scan 并选择支持的模型。
检查网关日志以获取详细的失败原因。

另见:Models CLI和模型提供商。

消息未触发

检查 1: 发送者是否在允许列表中?

bash

openclaw status

在输出中查找 AllowFrom: ...。

检查 2: 对于群组聊天,是否需要提及?

bash

# The message must match mentionPatterns or explicit mentions; defaults live in channel groups/guilds.
# Multi-agent: `agents.list[].groupChat.mentionPatterns` overrides global patterns.
grep -n "agents\\|groupChat\\|mentionPatterns\\|channels\\.whatsapp\\.groups\\|channels\\.telegram\\.groups\\|channels\\.imessage\\.groups\\|channels\\.discord\\.guilds" \
  "${OPENCLAW_CONFIG_PATH:-$HOME/.openclaw/openclaw.json}"

检查 3: 检查日志

bash

openclaw logs --follow
# or if you want quick filters:
tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)" | grep "blocked\\|skip\\|unauthorized"

配对码未到达

如果 dmPolicy 是 pairing,未知发送者应该收到代码,他们的消息在批准前会被忽略。

检查 1: 是否已有待处理的请求在等待?

bash

openclaw pairing list <channel>

待处理的 DM 配对请求默认每个频道限 3 个。如果列表已满,在批准或过期一个之前,新请求不会生成代码。

检查 2: 请求是否已创建但未发送回复?

bash

openclaw logs --follow | grep "pairing request"

检查 3: 确认该频道的 dmPolicy 不是 open/allowlist。

图片 + 提及不工作

已知问题:当您仅发送图片和提及(没有其他文本)时,WhatsApp 有时不包含提及元数据。

解决方法: 添加一些文本和提及:

❌ @openclaw + 图片
✅ @openclaw check this + 图片

会话未恢复

检查 1: 会话文件是否存在?

bash

ls -la ~/.openclaw/agents/<agentId>/sessions/

检查 2: 重置窗口是否太短?

json

{
  "session": {
    "reset": {
      "mode": "daily",
      "atHour": 4,
      "idleMinutes": 10080 // 7 days
    }
  }
}

检查 3: 是否有人发送了 /new、/reset 或重置触发器?

代理超时

默认超时为 30 分钟。对于长时间任务:

json

{
  "reply": {
    "timeoutSeconds": 3600 // 1 hour
  }
}

或使用 process 工具后台运行长命令。

WhatsApp 已断开连接

bash

# Check local status (creds, sessions, queued events)
openclaw status
# Probe the running gateway + channels (WA connect + Telegram + Discord APIs)
openclaw status --deep

# View recent connection events
openclaw logs --limit 200 | grep "connection\\|disconnect\\|logout"

修复: 网关运行后通常会自动重新连接。如果卡住,重启网关进程(无论您如何监督它),或使用详细输出手动运行:

bash

openclaw gateway --verbose

如果您已注销/取消链接:

bash

openclaw channels logout
trash "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/credentials" # if logout can't cleanly remove everything
openclaw channels login --verbose       # re-scan QR

媒体发送失败

检查 1: 文件路径是否有效?

bash

ls -la /path/to/your/image.jpg

检查 2: 是否太大?

图片:最大 6MB
音频/视频:最大 16MB
文档:最大 100MB

检查 3: 检查媒体日志

bash

grep "media\\|fetch\\|download" "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)" | tail -20

高内存使用

OpenClaw 将对话历史保存在内存中。

修复: 定期重启或设置会话限制:

json

{
  "session": {
    "historyLimit": 100 // Max messages to keep
  }
}

常见故障排除

"网关无法启动 — 配置无效"

OpenClaw 现在在配置包含未知键、格式错误的值或无效类型时拒绝启动。这是为了安全而有意为之。

使用 Doctor 修复:

bash

openclaw doctor
openclaw doctor --fix

注意:

openclaw doctor 报告每个无效条目。
openclaw doctor --fix 应用迁移/修复并重写配置。
诊断命令如 openclaw logs、openclaw health、openclaw status、openclaw gateway status 和 openclaw gateway probe 即使配置无效也仍会运行。

"所有模型失败" — 我应该先检查什么?

所尝试的提供商的凭据是否存在(认证配置文件 + 环境变量)。
模型路由:确认 agents.defaults.model.primary 和后备是您可以访问的模型。
/tmp/openclaw/… 中的网关日志以获取确切的提供商错误。
模型状态:使用 /model status(聊天)或 openclaw models status(CLI)。

我在个人 WhatsApp 号码上运行 — 为什么自聊很奇怪?

启用自聊模式并将您自己的号码加入允许列表:

json5

{
  channels: {
    whatsapp: {
      selfChatMode: true,
      dmPolicy: "allowlist",
      allowFrom: ["+15555550123"],
    },
  },
}

见WhatsApp 设置。

WhatsApp 将我登出。如何重新认证?

再次运行登录命令并扫描 QR 码:

bash

openclaw channels login

`main` 上的构建错误 — 标准修复路径是什么?

git pull origin main && pnpm install
openclaw doctor
检查 GitHub issues 或 Discord
临时解决方法:检出较旧的提交

npm install 失败(allow-build-scripts / 缺少 tar 或 yargs)。现在怎么办?

如果您从源代码运行,使用仓库的包管理器:pnpm(首选)。仓库声明了 packageManager: "pnpm@…"。

典型恢复:

bash

git status   # ensure you’re in the repo root
pnpm install
pnpm build
openclaw doctor
openclaw gateway restart

原因:pnpm 是此仓库配置的包管理器。

如何在 git 安装和 npm 安装之间切换?

使用网站安装程序并使用标志选择安装方法。它就地升级并重写网关服务以指向新安装。

切换到 git 安装:

bash

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard

切换到 npm 全局:

bash

curl -fsSL https://openclaw.ai/install.sh | bash

注意:

git 流程仅在仓库干净时才会变基。先提交或暂存更改。

切换后,运行:

bash

openclaw doctor
openclaw gateway restart

Telegram 块流式传输没有在工具调用之间拆分文本。为什么?

块流式传输仅发送已完成的文本块。您看到单条消息的常见原因:

agents.defaults.blockStreamingDefault 仍然是 "off"。
channels.telegram.blockStreaming 设置为 false。
channels.telegram.streamMode 是 partial 或 block 且草稿流式传输处于活动状态 (私聊 + 主题)。在这种情况下,草稿流式传输会禁用块流式传输。
您的 minChars / 合并设置太高,因此块被合并。
模型发出一个大的文本块(没有回复中间刷新点)。

修复清单:

将块流式传输设置放在 agents.defaults 下,而不是根目录。
如果您想要真正的多消息块回复,设置 channels.telegram.streamMode: "off"。
在调试时使用更小的块/合并阈值。

见流式传输。

Discord 即使设置了 `requireMention: false` 也不在我的服务器中回复。为什么?

requireMention 仅在频道通过允许列表之后控制提及门控。默认情况下 channels.discord.groupPolicy 是允许列表,因此必须明确启用公会。如果设置了 channels.discord.guilds.<guildId>.channels,则仅允许列出的频道;省略它以允许公会中的所有频道。

修复清单:

设置 channels.discord.groupPolicy: "open" 或添加公会允许列表条目(并可选添加频道允许列表)。
在 channels.discord.guilds.<guildId>.channels 中使用数字频道 ID。
将 requireMention: false 放在 channels.discord.guilds 下面(全局或按频道)。顶级 channels.discord.requireMention 不是受支持的键。
确保机器人具有消息内容意图和频道权限。
运行 openclaw channels status --probe 获取审计提示。

文档:Discord,频道故障排除。

Cloud Code Assist API 错误:无效工具架构(400)。现在怎么办?

这几乎总是工具架构兼容性问题。Cloud Code Assist 端点接受 JSON Schema 的严格子集。OpenClaw 在当前 main 中清理/规范化工具架构,但修复尚未包含在最后一个版本中(截至 2026 年 1 月 13 日)。

修复清单:

更新 OpenClaw:
- 如果您可以从源代码运行,拉取 main 并重启网关。
- 否则,等待包含架构清理器的下一个版本。
避免不支持的关键字,如 anyOf/oneOf/allOf、patternProperties、 additionalProperties、minLength、maxLength、format 等。
如果定义自定义工具,将顶级架构保持为 type: "object" 与 properties 和简单枚举。

见工具和TypeBox 架构。

macOS 特定问题

授予权限时应用崩溃(语音/麦克风)

如果在隐私提示上点击"允许"时应用消失或显示"Abort trap 6":

修复 1:重置 TCC 缓存

bash

tccutil reset All bot.molt.mac.debug

修复 2:强制新 Bundle ID 如果重置不起作用,在scripts/package-mac-app.sh中更改 BUNDLE_ID(例如添加 .test 后缀)并重新构建。这会强制 macOS 将其视为新应用。

网关卡在"正在启动..."

应用连接到端口 18789 上的本地网关。如果卡住:

修复 1:停止监督器(首选) 如果网关由 launchd 监督,杀死 PID 只会重新生成它。先停止监督器:

bash

openclaw gateway status
openclaw gateway stop
# Or: launchctl bootout gui/$UID/bot.molt.gateway (replace with bot.molt.<profile>; legacy com.openclaw.* still works)

修复 2:端口忙(找到监听器)

bash

lsof -nP -iTCP:18789 -sTCP:LISTEN

如果是无监督进程,先尝试优雅停止,然后升级:

bash

kill -TERM <PID>
sleep 1
kill -9 <PID> # last resort

修复 3:检查 CLI 安装 确保全局 openclaw CLI 已安装并匹配应用版本:

bash

openclaw --version
npm install -g openclaw@<version>

调试模式

获取详细日志:

bash

# Turn on trace logging in config:
#   ${OPENCLAW_CONFIG_PATH:-$HOME/.openclaw/openclaw.json} -> { logging: { level: "trace" } }
#
# Then run verbose commands to mirror debug output to stdout:
openclaw gateway --verbose
openclaw channels login --verbose

日志位置

日志	位置
网关文件日志(结构化)	`/tmp/openclaw/openclaw-YYYY-MM-DD.log`(或 `logging.file`)
网关服务日志(监督器)	macOS:`$OPENCLAW_STATE_DIR/logs/gateway.log` + `gateway.err.log`(默认:`~/.openclaw/logs/...`;配置文件使用 `~/.openclaw-<profile>/logs/...`) Linux:`journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager` Windows:`schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST`
会话文件	`$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/`
媒体缓存	`$OPENCLAW_STATE_DIR/media/`
凭据	`$OPENCLAW_STATE_DIR/credentials/`

健康检查

bash

# Supervisor + probe target + config paths
openclaw gateway status
# Include system-level scans (legacy/extra services, port listeners)
openclaw gateway status --deep

# Is the gateway reachable?
openclaw health --json
# If it fails, rerun with connection details:
openclaw health --verbose

# Is something listening on the default port?
lsof -nP -iTCP:18789 -sTCP:LISTEN

# Recent activity (RPC log tail)
openclaw logs --follow
# Fallback if RPC is down
tail -20 /tmp/openclaw/openclaw-*.log

重置所有内容

核选项:

bash

openclaw gateway stop
# If you installed a service and want a clean install:
# openclaw gateway uninstall

trash "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
openclaw channels login         # re-pair WhatsApp
openclaw gateway restart           # or: openclaw gateway

⚠️ 这会丢失所有会话并需要重新配对 WhatsApp。

获取帮助

首先检查日志:/tmp/openclaw/(默认:openclaw-YYYY-MM-DD.log,或您配置的 logging.file)
在 GitHub 上搜索现有 issues
提交新 issue,包括:
- OpenClaw 版本
- 相关日志片段
- 重现步骤
- 您的配置(隐藏密钥!)

"你试过关闭再打开吗?" — 每个 IT 人员

🦞🔧

浏览器未启动(Linux)

如果您看到 "Failed to start Chrome CDP on port 18800":

最可能的原因: Ubuntu 上的 Snap 打包的 Chromium。

快速修复: 改为安装 Google Chrome:

bash

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb

然后在配置中设置:

json

{
  "browser": {
    "executablePath": "/usr/bin/google-chrome-stable"
  }
}

完整指南: 见browser-linux-troubleshooting

故障排除 🔧 ​

状态与诊断 ​

常见问题 ​

未找到提供商"anthropic"的 API 密钥 ​

OAuth 令牌刷新失败(Anthropic Claude 订阅) ​

控制 UI 在 HTTP 上失败("需要设备身份"/"连接失败") ​

CI 密钥扫描失败 ​

服务已安装但无任何运行 ​

"网关启动被阻止:设置 gateway.mode=local" ​

服务环境(PATH + 运行时) ​

技能在沙箱中缺少 API 密钥 ​

服务运行但端口未监听 ​

地址已在使用中(端口 18789) ​

检测到额外的工作区文件夹 ​

主聊天在沙箱工作区中运行 ​

"代理已中止" ​

"代理在回复前失败:未知模型:anthropic/claude-haiku-3-5" ​

消息未触发 ​

配对码未到达 ​

图片 + 提及不工作 ​

会话未恢复 ​

代理超时 ​

WhatsApp 已断开连接 ​

媒体发送失败 ​

高内存使用 ​

常见故障排除 ​

"网关无法启动 — 配置无效" ​

"所有模型失败" — 我应该先检查什么? ​

我在个人 WhatsApp 号码上运行 — 为什么自聊很奇怪? ​

WhatsApp 将我登出。如何重新认证? ​

main 上的构建错误 — 标准修复路径是什么? ​

npm install 失败(allow-build-scripts / 缺少 tar 或 yargs)。现在怎么办? ​

如何在 git 安装和 npm 安装之间切换? ​

Telegram 块流式传输没有在工具调用之间拆分文本。为什么? ​

Discord 即使设置了 requireMention: false 也不在我的服务器中回复。为什么? ​

Cloud Code Assist API 错误:无效工具架构(400)。现在怎么办? ​

macOS 特定问题 ​

授予权限时应用崩溃(语音/麦克风) ​

网关卡在"正在启动..." ​

调试模式 ​

日志位置 ​

健康检查 ​

重置所有内容 ​

获取帮助 ​

浏览器未启动(Linux) ​

故障排除 🔧

状态与诊断

常见问题

未找到提供商"anthropic"的 API 密钥

OAuth 令牌刷新失败(Anthropic Claude 订阅)

控制 UI 在 HTTP 上失败("需要设备身份"/"连接失败")

CI 密钥扫描失败

服务已安装但无任何运行

"网关启动被阻止:设置 gateway.mode=local"

服务环境(PATH + 运行时)

技能在沙箱中缺少 API 密钥

服务运行但端口未监听

地址已在使用中(端口 18789)

检测到额外的工作区文件夹

主聊天在沙箱工作区中运行

"代理已中止"

"代理在回复前失败:未知模型:anthropic/claude-haiku-3-5"

消息未触发

配对码未到达

图片 + 提及不工作

会话未恢复

代理超时

WhatsApp 已断开连接

媒体发送失败

高内存使用

常见故障排除

"网关无法启动 — 配置无效"

"所有模型失败" — 我应该先检查什么?

我在个人 WhatsApp 号码上运行 — 为什么自聊很奇怪?

WhatsApp 将我登出。如何重新认证?

`main` 上的构建错误 — 标准修复路径是什么?

npm install 失败(allow-build-scripts / 缺少 tar 或 yargs)。现在怎么办?

如何在 git 安装和 npm 安装之间切换?

Telegram 块流式传输没有在工具调用之间拆分文本。为什么?

Discord 即使设置了 `requireMention: false` 也不在我的服务器中回复。为什么?

Cloud Code Assist API 错误:无效工具架构(400)。现在怎么办?

macOS 特定问题

授予权限时应用崩溃(语音/麦克风)

网关卡在"正在启动..."

调试模式

日志位置

健康检查

重置所有内容

获取帮助

浏览器未启动(Linux)