【免费下载链接】openharness
The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
openharness是一个 coding agent 的"指挥中心"（command center），它的核心能力之一就是多机协同：你的笔记本、家庭服务器和 GPU 盒子可以在同一个窗口里并排工作。本指南面向新手，带你只凭一个密码——免 SSH 密钥、免 Tailscale、免端口转发——把远处的机器链接进来，一行安装命令搞定。
为什么需要 openharness 多机协同？
大多数人的开发环境早就不是"一台电脑"了：
- 💻笔记本上跑 Claude Code、Codex 处理日常代码；
- 🗄️家庭服务器上跑 OpenCode、Hermes 之类的长跑任务；
- 🎮GPU 盒子上跑 OpenCode、本地大模型（Ollama、vLLM、MLX-LM）或训练任务。
传统的多机方案要么配置 SSH 密钥、要么部署 Tailscale、要么做端口转发，对新手很不友好。openharness 的思路完全不同：每台机器上只装一个 daemon，它主动向外拨号连接（dial out），所以任何机器都不用开放一个端口；机器之间用"每台机器一个远程密码"完成链接，全链路端到端加密。
关键细节：关闭 openharness 桌面应用后，agent 依然继续工作——因为它们跑在 daemon 管理的 tmux 会话里。
工作原理：三选一的最优路径
每台机器的 daemon 通过回环 socket 与本机应用通信，再代表本机去"链接"其他机器，并在本地终结加密。机器之间的传输，openharness 会自动选择三条路径中最优的一条：
| 路径 | 说明 |
|---|---|
| Direct | 两台机器之间的 WebRTC 通道，中间没有任何服务器，最快 |
| Cloudflare TURN | 防火墙挡住直连时，同一加密通道经 Cloudflare 边缘节点转发 |
| Harness relay | WebRTC 协商期间的兜底中继；relay 不持有密钥，只转发密文 |
完整细节可参考架构文档：docs/architecture.md，传输性能实测见 docs/performance/。
一行命令：给你的 GPU 盒子装上 daemon
前提很简单：目标机器上有Node.js ≥ 20和tmux（无头 Linux 服务器也完全支持，桌面应用不是必需品，daemon 才是）。
在 GPU 盒子的终端里依次执行（第一行就是那条"一行命令"）：
curl -fsSL https://harness.autonomous.ai/cli/install.sh | bash harness login harness remote-password set harness start这四步分别对应：安装harnessCLI → 用你的账号登录这台机器 →为这台机器设置机器间链接密码→ 启动 daemon。
💡 不需要在机器之间复制任何 token：
~/.harness下有一个持久的机器 ID，保证这台机器每次启动都归属同一条 machine 记录。
在应用里：Machines 面板完成链接
回到你主力电脑上的 openharness 应用，打开Machines → Link Machine（或底部Add a second machine），面板会给你一份两步说明：在另一台机器上装好并设好密码，然后在这里点Connect输入密码即可。
链接完成后，所有机器集中出现在Machines面板里：在线机器显示 harness 数量、CPU 和内存占用，未链接的机器旁是Connect按钮，离线机器一目了然。
面板顶部还有两个实用选项：
- Set password：为"本机"设置远程密码，让别的机器反过来链接你；
- Show in this window：选择这个窗口显示哪台机器的标签页，All machines则是"共享办公桌"视图，所有机器的 agent 并排展示。
面板的交互逻辑文档见：docs/app.md。
纯终端党：用 CLI 链接其他机器
如果你习惯终端（或者在服务器上操作），CLI 提供了与面板等价的链接能力，完整命令表见 docs/cli.md：
harness link connect <机器id> --name=gpu-box # 让本机链接另一台机器（本机终结E2EE） harness link list # 查看已链接的机器 harness link unlink <机器id> # 解除链接 harness machines list # 列出账号下的所有机器链接完成后，在指定机器上启动 agent 只需要一个@：
harness new codex @gpu-box ~/code/train # 在名为 gpu-box 的机器上、该目录启动 codex还有一个很妙的小技巧：在任意 harness 终端里执行harness remote，可以直接选择你的另一台机器（必要时当场链接），把当前终端"搬"过去——跨机切终端只需一步。
安全：relay 看到的只是密文
多机协同最让人担心的就是"中间服务器能看什么"。openharness 的答案是：所有路径端到端加密（ChaCha20-Poly1305 + X25519 会话密钥 + 固定 Ed25519 身份），relay 只转发它读不懂的字节流，不持有任何密钥。
设备层面同样不需要手动确认信任关系：每台设备（电脑、手机、应用）登录账号后自动加入设备密钥日志，新设备加入时，其他设备会主动提醒你。更多安全设计见 SECURITY.md。
常见问题速查
| 问题 | 答案 |
|---|---|
| 无头服务器能用吗？ | 能。harnessCLI + daemon 足够，桌面应用不是必需的 |
| 目标机器缺什么环境？ | Node ≥ 20 和 tmux；OpenCode、Hermes、Devin 等引擎额外需要sqlite3 |
| 防火墙很严，直连失败？ | 自动切 Cloudflare TURN，再不行走 relay 兜底，全程加密不变 |
| 怎么查状态？ | harness status查看 daemon 运行状态、机器 ID 和会话数 |
| daemon 行为不符合预期？ | harness stop && harness start重启；--repair可重新校验运行时 |
下一步 🚀
- 想深入架构：docs/architecture.md
- 想查全部 CLI 命令：docs/cli.md
- 想从源码构建（含 daemon、relay、设备固件）：docs/development.md
- 想了解终端版
hn（把每台机器的所有 harness 装进 tmux）：tui/README.md
从"一台笔记本"到"一台笔记本 + 家庭服务器 + GPU 盒子"，openharness 多机协同只多花你四行命令——链接一次，之后 ⌘P 就能在任意机器上打开任意 harness。
【免费下载链接】openharness
The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
相关推荐
Deis 集群安装指南：使用 ssh-keygen 生成 deisctl SSH 密钥对并配置免密连接
Deis 集群安装指南：使用 ssh keygen 生成 deisctl SSH 密钥对并配置免密连接 Deis（v1.x）是一个运行在 CoreOS 与 Do
后端云原生Linux 命令大全：ssh-copy-id 免密登录实战指南——把本地公钥安装到远程主机 authorized_keys
Linux 命令大全：ssh copy id 免密登录实战指南——把本地公钥安装到远程主机 authorized_keys ssh copy id 是 Open
文档教程minikube ssh-host 命令详解：获取节点 SSH 主机密钥与自动写入 known_hosts
minikube ssh host 命令详解：获取节点 SSH 主机密钥与自动写入 known_hosts 导读 minikube ssh host 是 min
云原生容器编排CLI开发工具
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
