Agent工坊

【Agent工坊】OpenClaw 2026.7.2 远程编程上手:云端跑 Codex,终端接回本地

昨天(7月15日)OpenClaw 发布 2026.7.2-beta.1,带来「远程编程会话」能力——你可以在云服务器上跑 Codex/Claude CLI,然后在本地终端里像 SSH 一样接进去继续写代码。本文带你从零搭一套远程编程环境。

为什么你需要远程编程会话?

AI 编程工具的痛点很明显:

场景一:你在公司,家用 Mac Mini 跑着个长时间任务。 不能关终端,不能断网,不然 Codex/Claude Code 的上下文全丢。你只能开着 tmux 硬扛。

场景二:你租了台 8×H100 的云服务器跑代码生成,但 AI CLI 工具装在本机上。 来回 scp 代码,效率打骨折。

场景三:团队共用一台开发服务器,每人开一个 SSH 连上去跑自己的 AI Agent。 会话管理是噩梦,谁断了谁的进程都分不清。

OpenClaw 2026.7.2 的远程编程会话就是来解这三个场景的。

核心机制:Cloud Workers + Session Routing

这版 OpenClaw 引入了一个新架构层:

┌─────────────────────────────────────────┐
│          Control UI(浏览器)             │
│   创建会话、选模型、看进度                  │
└──────────────┬──────────────────────────┘
               │ WebSocket / HTTP
┌──────────────▼──────────────────────────┐
│          OpenClaw Gateway               │
│   对接 Cloud Workers、路由会话             │
│   管理 "哪个 session 跑在哪台机器上"       │
└──────┬──────────────────────┬───────────┘
       │                      │
┌──────▼──────────┐  ┌───────▼───────────┐
│  Cloud Worker A  │  │  Cloud Worker B   │
│  (8×H100 GPU)    │  │  (Mac Mini M4)    │
│  跑 Codex CLI    │  │  跑 Claude Code    │
│  生成大模型代码   │  │  前端开发 + Lint   │
└──────────────────┘  └───────────────────┘

三个关键 PR 实现了这套体系:

  • #107670:Cloud worker 的 session 放置、分发和路由
  • #107086:Codex/Claude 的 catalog 会话在本地终端中打开
  • #107200:OpenCode 和 Pi 会话的终端恢复

一句话总结:Control UI 里点一下"新建 Codex 会话",Gateway 自动把任务分配到有 GPU 的 Cloud Worker 上跑;你在本地终端 openclaw session resume 就能接管那个已经跑起来的会话。

上手指南:三步搭一套远程编程环境

Step 1:部署 Cloud Worker

在云服务器上安装 OpenClaw 并注册为 worker:

# 安装 OpenClaw(云端服务器)
curl -fsSL https://openclaw.ai/install.sh | bash

# 注册为 cloud worker,连接到你的 Gateway
openclaw worker register \
  --gateway wss://your-gateway.example.com \
  --label "gpu-node-01" \
  --capabilities "codex,claude-code,opencode"

# 启动 worker 进程
openclaw worker start --daemon

Worker 会向 Gateway 宣告自己的存在和能力列表。Gateway 根据 session 类型自动匹配到合适的 worker。

Step 2:在 Control UI 中创建远程会话

打开 Control UI(http://localhost:18789 或你的 Gateway 地址):

  1. 左侧边栏 → New Session → 选择 Codex CLIClaude Code
  2. 在 "Where to run" 下拉中选 Cloud Worker(Gateway 自动列出可用节点)
  3. 选模型、设工作目录
  4. 点击创建

会话创建成功后,你会在 Control UI 的 session 列表里看到它,状态是 "Running on gpu-node-01"。

Step 3:本地终端接入远程会话

在你的本地 Mac/Linux 上:

# 列出所有远程运行的编码会话
openclaw session list --type coding

# 输出示例:
# ┌──────────┬───────────────┬──────────────┬─────────┐
# │ Session  │ Type          │ Worker       │ Status  │
# ├──────────┼───────────────┼──────────────┼─────────┤
# │ cs-7f3a  │ codex-cli     │ gpu-node-01  │ running │
# │ cs-9b2c  │ claude-code   │ mac-mini-m4  │ running │
# └──────────┴───────────────┴──────────────┴─────────┘

# 接入指定会话——就像 SSH 一样
openclaw session resume cs-7f3a

接入后,你的终端就变成了远程 Codex/Claude CLI 的交互界面。输入提示词、看输出、打断重来——和本地跑一模一样。

三种实用场景

场景 A:租 GPU 跑重活,笔记本只当终端

# 在 GPU 云服务器上运行 Codex 生成代码
openclaw session create codex \
  --worker gpu-node-01 \
  --workdir /data/projects/my-app \
  --model gpt-5-codex

# 本地 MacBook Air 接入
openclaw session resume cs-xxxx
# 现在你在轻薄本上操控着远程的 8×H100

场景 B:分布式多工具并行

# Worker A 跑 Codex 生成后端
openclaw session create codex --worker worker-a --workdir /code/backend

# Worker B 跑 Claude Code 写前端
openclaw session create claude --worker worker-b --workdir /code/frontend

# Pi session 做代码审查
openclaw session create pi --worker worker-c

然后你在本地终端里 Ctrl+Z / fg 在三个远程会话之间切换。

场景 C:恢复意外断开的会话

最实用的场景:你在 Control UI 里跑着的 Claude Code session 因为网络问题断了。

# 直接恢复,上下文、进度、未提交的代码全在
openclaw session resume cs-xxxx

v0.18.1 里修复了 "terminal sessions: preserve early keystrokes" 的 bug,现在即使断网前你正在输入,恢复后内容也不会丢。

已知限制与避坑

现象 解法
Worker 无法注册 worker register 返回 timeout 检查 Gateway 的防火墙,确保 WebSocket 端口开放
Session 恢复慢 resume 等了 30s 没反应 Worker 可能还在处理上一个 turn,等它完成后再 resume
Codex 需要登录 首次创建 Codex session 失败 在 Worker 上先 codex login 完成 OAuth
Claude session 不退后台 session 占着终端不释放 这是 2026.7.2 已知问题,Claude turns 会保持 open 等待原生后台任务,按 Ctrl+D 可以手动释放

和 Hermes Agent 的对比

远程编程这个场景,Hermes Agent v0.18.0 走的是另一个路线——background fan-outdelegate_task 后台并行子代理)。Hermes 更适合"一次性派一堆任务下去、等结果汇总"的模式;OpenClaw 的远程会话更适合"持续交互式编程"的场景。

对于一人公司 AI 创业者,两个工具可以互补:
- OpenClaw 远程会话:跑需要 GPU 的代码生成、需要持续交互的 debug
- Hermes delegate_task fan-out:同时调研多个竞品、批量生成不同平台的内容

总结

OpenClaw 2026.7.2 的远程编程会话,本质上是把 SSH + tmux + AI CLI 三件套做成了一个统一的产品体验。不再需要手动 tmux attach、不用担心断网丢上下文、不用来回 scp 文件。

对于 AI 创业者,这个能力直接省钱:你可以租一台高性能 GPU 服务器,然后从任何设备(笔记本、iPad、甚至手机)接入做 AI 辅助编程——计算在云端,交互在本端。

下一步值得关注的是:2026.7.2 目前是 beta,稳定版预计 1-2 周内发布。如果你想尝鲜,建议先在测试服务器上部署,别直接上生产环境。

快速开始curl -fsSL https://openclaw.ai/install.sh | bash && openclaw update --channel beta


AI创业 #OpenClaw #远程编程 #Agent工坊 #一人公司 #CloudWorker