管理 Agent

添加更多 Agent、重装、更换电脑、管理已保存的凭据和已连接的设备。

添加另一个 Agent

每个 Agent 都需要一台独立的 VPS。在 Contabo 中再订购一台服务器(第 4 步),然后运行:

officeclaws onboard --name Bob

已保存的 Contabo 和 Tailscale 凭据会被复用,所以你只需要选择新服务器。之后,用 --agent <id> 指定命令作用于哪个 Agent。运行 officeclaws agents 查看 ID。

替换或重装 Agent

要在同一台服务器上重新开始,例如设置失败后,或者你想要一个全新的 Agent,请先重装服务器。在已经设置好的服务器上再次运行 officeclaws onboard 是行不通的,因为第一次设置会关闭它的公网 SSH。--reinstall 选项也不会清除你的 VPS。

  1. 在 Contabo 控制面板 中打开这台 VPS,选择 Reinstall,然后选择 Ubuntu 24.04。服务器上的所有内容都会被清除,包括 Agent 的记忆和设置、Telegram 配置以及定时任务。

  2. 等待 Contabo 显示重装已完成。

  3. 再次运行设置,并从列表中选择同一台 VPS:

    officeclaws onboard --name Mona
  4. 完成后,请再次运行 officeclaws connect-codex。

在另一台电脑上使用 CLI

  1. 在新电脑上 安装 CLI。
  2. 运行 officeclaws login。
  3. 安装 Tailscale 并登录 同一个 tailnet。
  4. 新电脑上没有设置时安装到服务器上的 SSH 密钥,而再次运行 officeclaws onboard 也不会添加它,因为设置完成后服务器的公网 SSH 已关闭。请继续使用你当初设置 Agent 的那台电脑,或者通过 Telegram 或 [email protected] 联系支持,我们会帮你添加另一台电脑。

已保存的凭据(vault)

CLI 可以保存多组凭据,例如两个 Contabo 账号。你可以在它们之间切换:

officeclaws vault list                     # list saved credentials (values masked)
officeclaws vault list --type contabo      # filter: contabo | tailscale | telegram
officeclaws vault apply <id>               # make this set the active one
officeclaws vault rm <id>                  # delete a saved set

已连接的设备

每个连接到 Agent 控制面板的应用都是一个 “设备”。CLI 在设置过程中会自动批准自己的设备。如果你连接了其他东西,例如桌面应用或 Agent 的 Web 控制台,可能需要手动批准:

officeclaws devices list
officeclaws devices approve <request-id>
 
officeclaws pairing list
officeclaws pairing approve <request-id>
officeclaws pairing reject <request-id>

如果聊天或日志出现 1008 pairing required 错误,请运行:

officeclaws pairing repair

停止为 Agent 付费

Office Claws 不会删除服务器。要彻底停止一个 Agent,请 在你的 Contabo 账号中取消这台 VPS。要取消 Office Claws 订阅,请用注册时的邮箱发送邮件至 [email protected],或在 Telegram 上联系支持。详情请参阅 退款政策。

下一步

故障排查 →