第13章 Orca 运行模式详解：本地、SSH 与远程服务器

Orca 的几种运行方式 本地桌面、SSH 主机、自建 Orca 服务器以及按需分配的每工作区 VM——为每个任务选择合适的计算资源。

Orca 并不局限于你的笔记本电脑。每个 worktree 都在某个地方运行：在你面前的这台机器上，在你已有的某台设备上，在共享的常驻服务器上，或者为特定工作区即时创建的全新云 VM 中。

本页是导航地图。深入细节请参阅相关链接页面。

总览

模式 | 文件和 Agent 所在位置 | 机器所有者 | 适用场景 本地 | 你的桌面 | 你 | 日常编码、快速迭代 SSH 目标 | 通过 SSH 连接的远程主机 | 你（或你的团队） | 开发机、GPU 主机、常驻 VPS 远程 Orca 服务器 | 运行 Orca 桌面版或 orca serve 的机器 | 你（或你的团队） | 持久化共享运行时、移动端、自动化 云 VM / 每工作区环境 | 每个工作区一个一次性 VM/沙箱 | 你的云账户（自带供应商） | 隔离的、临时的 Agent 计算

Orca 不提供托管式 VPS 服务。远程模式始终使用你控制的机器和云账户。

1. 本地桌面 安装 Orca，打开项目，创建 worktree。Agent、终端和浏览器运行在与 UI 相同的机器上。

本地 Mac 上的侧边栏 worktree——每张卡片都是一个拥有独立 Agent 和分支的 worktree。

这是大多数人的默认路径。参见《你的首个 3-Agent 会话》和《Worktrees》。

2. SSH 目标 将 Orca 指向任何 SSH 主机——更强的 Mac mini、Linux VPS、GPU 主机或支持 SSH 的云沙箱。创建 worktree 时，在“运行于”下选择该主机。Agent 和 git worktree 在远程运行；编辑器、diff 和 UI 保留在你的笔记本上。

创建 worktree → 运行于——选择本地或已配置的远程主机（此处示例：通过 SSH 连接 openclaw）。

适用场景：远程主机已有代码仓库、工具和凭证，且你希望用一台笔记本上的 Orca 驱动多台设备。

设置步骤：

在 设置 → SSH 下添加主机。 测试连接（主机上必须可用 git 才能处理仓库 worktree）。 创建 worktree 并在“运行于”下选择 SSH 目标。搜索框会列出就绪的主机；对于已连接但尚未为该项目配置的主机，会显示不可选的“需要设置”行。

SSH worktree 可以在 VS Code Remote-SSH 中打开，在允许 SFTP 时下载远程文件夹，即使远程无法编译终端原生代码，文件和 git 操作依然可用。Orca 会在首次连接时自动在主机组上安装托管服务器，因此错误的 Node 版本或缺失的构建工具不再阻碍连接。详见：《SSH worktree》和《通过 SSH 在远程机器上工作》。

3. 远程 Orca 服务器 让 Orca 在你控制的机器上持续运行——旧笔记本、Mac mini、家庭服务器、云 VPS 或团队设备。将你的笔记本、浏览器客户端或手机配对到该运行时。服务器管理项目、worktree、终端和 Agent 进程；客户端即 UI。

适用场景：

希望笔记本休眠后 Agent 继续运行 移动端需重连到相同会话 自动化或后端需在稳定主机上启动会话

最简单的设置：在两台电脑上安装 Orca 和 Tailscale。在服务器上，打开 设置 → 远程 Orca 服务器 → 将此应用广告为服务器 → 新建链接，选择其 Tailscale 地址并生成访问链接。在客户端上，选择 添加服务器 并粘贴该链接。

对于无头 Linux 服务器或服务管理的 VM，可使用 orca serve 作为替代方案： `orca serve --pairing-address <可达的 tailscale-ip 或 hostname>` 完整细节参见：《远程 Orca 服务器》。

SSH 与远程 Orca 服务器对比

SSH worktree | 远程 Orca 服务器 运行时所有者 | 笔记本 Orca | 远程机器（Orca 桌面版或 orca serve） 断开连接 | Agent 在主机上继续运行；笔记本重新连接 | 完整会话状态保留在服务器 多客户端 | 一台笔记本驱动主机 | 笔记本、Web、移动端和自动化可共享同一运行时 典型设置 | 导入 SSH 配置，选择“运行于” | 分享服务器应用或运行 orca serve，然后通过 URL 配对

4. 云 VM（每工作区环境） 每个 worktree 可以启动自己的按需环境——云沙箱、VM 或本地 Docker 容器——基于检查入仓库的配方（orca.yaml + 生命周期脚本）。创建时启动；挂起/恢复/销毁时拆解。Orca 只是一个轻量封装：你的供应商账户、镜像和计费仍归你所有。

在产品 UI 中，此功能位于 设置 → 实验性功能 下，标记为 云 VM。配方依然用于创建每工作区环境。

目前用户集成的供应商包括 Vercel Sandbox、Fly、Modal、普通 SSH 主机和本地 Docker。连接方式有两种：Orca 服务器（配方启动 orca serve 并返回配对 URL）或 SSH（配方返回 Orca 拨号的连接详情）。

设置 → 实验性功能 → 云 VM——启用该功能，然后让 Agent 为仓库设置一个配方。

适用场景：需要每个任务干净隔离、一次性计算，或每个 Agent 启动时进入标准环境。

设置步骤：

在 设置 → 实验性功能 下启用 云 VM。面板包含简短的“创建云 VM”指南和配方/运行时控制。 如有需要，安装或更新 云 VM / 每工作区环境 技能。 在任意工作区中，询问你的 Agent： “使用 orca-per-workspace-env 技能为这个仓库设置每工作区环境。” 技能将引导你完成：前置条件 → 基础快照 → Agent 认证 → orca.yaml 配方 → doctor 验证。 当配方出现在 配方 下时，创建一个 worktree 并在“运行于”下选择它。 只有当 环境配方 条目存在于 orca.yaml 的主检出版本（而非仅特性分支）时，配方才会在工作区创建时显示。在迭代脚本时，仍可在任意分支运行 doctor 和实时供应。

如何选择

如果笔记本速度足够且 Agent 生命周期短，保持本地。 如果你已有 VPS 或开发机，且希望在那里运行 Agent 而不想安装第二个 Orca 运行时，使用 SSH。 如果你想要一个常驻的 Orca 运行时供移动端、浏览器和自动化使用，使用远程 Orca 服务器。 如果每个任务都需要一个由配方定义、随 worktree 销毁的全新沙箱，使用云 VM / 每工作区环境。

你可以在同一安装中混合使用多种模式：本地 worktree 用于快速编辑，SSH 用于 GPU 主机，配方用于类 CI 隔离。

相关页面

SSH worktree 远程 Orca 服务器 Worktrees 移动端 设置参考