文档目录远程电脑

远程电脑

三层架构里的第三层是运行电脑。一套个人网关可以登记多台运行电脑(网关 1 : N)。默认在网关本机执行工具;也可把 shell / 文件类工具路由到另一台机器上的 sandbox-agent(HTTP)。

网关保持运行时,Personal Agent 可持续对外服务;任务可打到该网关下已登记的多台运行电脑。客户端侧则是另一层关系:一个客户端可切换多套网关(见 服务网关)。

设置入口:设置 → 网关端 → 网关服务 → 电脑连接(产品文案:电脑连接)。

登记电脑

表头「电脑名称 / 添加电脑」。

  • 本机始终在列表中(不可删、无连通测试开关)。
  • 远程:填写名称 / 主机 / 端口 / 令牌(SANDBOX_TOKEN)。保存前会 probeComputer:健康检查须为 okbot-sandbox-agent,并用令牌探测 shell 接口。连不上或不匹配时不写入。
  • 可关闭远程行:关闭后不能当默认、不参与路由。
  • 下拉选择恰好一台默认电脑(本机或已启用的远程)。

电脑列表保存在网关主机;客户端「网关列表」只决定附着哪台宿主。

路由规则(简要)

  • 默认使用设置里的默认电脑;空 = 本机
  • 本轮可指定电脑;消息里点名电脑名称也可切换
  • read_skill 与文生图等仍留在桌面 / 网关主机侧执行,不随电脑切换

远程协议提供 health、shell(可 SSE)、文件读写编辑等。适合云主机、实验室机器或容器。即使在裸服务器上运行 sandbox-agent,也可在 OkBot 中登记为远程运行电脑。

与网关切换的区别

  • 网关列表(客户端):UI 附着哪台 Personal Agent 宿主(客户端 1 : N 网关,同时只连一套)
  • 电脑连接(网关端):该宿主把工具派到哪些运行电脑(网关 1 : N)

内容根据 OkBot 产品仓库整理,随版本演进更新。