故障排查

从这里开始：开启调试输出后重新运行命令。额外的细节通常能显示出问题所在。

OFFICECLAWS_DEBUG=1 officeclaws <command>

账号与订阅

This account has no active subscription 运行 officeclaws subscribe 并完成付款。等一分钟，然后再次运行 officeclaws onboard。如果你在网站上用另一个邮箱付款，请 联系支持，我们会把付款关联到你的账号。

not logged in — run: officeclaws login 运行 officeclaws login。

Contabo

输入凭据后出现 contabo: … 四个值中有一个不正确。最常见的错误是用网站密码代替了单独的 API 密码。参见 第 4 步。

no VPSes found on your account 服务器尚未交付，或者凭据属于另一个 Contabo 账号。请在 my.contabo.com 检查服务器是否显示为运行中。

设置长时间停留在 “Waiting for the VPS” 设置过程中，Office Claws 会通过 Contabo 安装它的 SSH 密钥，随后 Contabo 会重启服务器。这最多可能需要 30 分钟。请不要中断。如果你在中途停止，Contabo 可能会再锁定服务器 5–15 分钟。

Tailscale

Tailscale daemon is not running 打开 Tailscale 应用并连接，然后重试。

认证密钥错误（invalid key、API key does not exist） 密钥已过期、已被吊销，或者是一次性密钥且已被使用过。创建一个新的可重复使用密钥，然后运行 officeclaws onboard --tailscale-authkey tskey-auth-…。

Agent 显示 offline，或聊天提示无法连接

• 检查你电脑上的 Tailscale 是否已连接：tailscale status。
• 检查 Agent 的服务器是否出现在你的 tailnet 中。它会列在 login.tailscale.com/admin/machines。
• 你的电脑和 Agent 必须在 同一个 tailnet 中。
• 在 Contabo 面板中检查 VPS 是否在运行。
• 用了几个月后突然不能用了？很可能是服务器的 Tailscale 密钥过期了。通过 Contabo 的 VNC 控制台以 root 身份登录 VPS，使用你订购服务器时设置的 root 密码（openclaw 用户在那里无法使用 sudo），然后运行 tailscale up。或者从干净的服务器重新开始，参见 管理 Agent。为避免再次发生，请 关闭密钥过期。

Agent 与聊天

Agent 不回复，或者出现 rpc final event had no text 或断开连接 你很可能已经达到 ChatGPT 套餐的 Codex 用量上限。等待额度重置，或升级你的 ChatGPT 套餐。如果提示 Agent 未连接到模型，请运行 officeclaws connect-codex。

1008 pairing required 运行 officeclaws pairing repair。

Codex 登录超时 请在 5 分钟内、在同一台电脑的浏览器中完成登录。然后再次运行 officeclaws connect-codex。

Telegram 机器人不回复

• 运行 officeclaws telegram show，检查是否显示 enabled : true。
• 在 pairing 模式下，你需要先批准自己的账号。参见 Telegram。
• 确保没有其他程序在使用同一个机器人 token。

仍然无法解决？

1. 收集日志：
   • 你的 Agent：officeclaws logs --lines 500
   • 设置过程：你电脑上 ~/.openclaw/logs 中最新的文件
2. 在 Telegram 上联系我们：t.me/getfrontendeddm。请附上你运行的命令、错误信息和日志。请先删除其中的所有密钥、token 或密码。