OpenChamber 教程:跨端 Agent 工作台完全指南
【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址: https://gitcode.com/gh_mirrors/op/openchamber
这篇 OpenChamber 教程从一条安装命令讲起,带你看清这款开源 Agent 工作台怎么跑起来:让 AI 编码 Agent 持续在轨干活、多个模型并行对比、桌面 Web 手机随时接力。
OpenChamber 帮你解决什么问题
把任务交给 AI 编码工具之后,多数人都有三种焦虑:Agent 回一句就停,得反复敲 continue;同一个任务换个模型可能更好,但你得手动重来一遍;离开工位之后,活儿就没人盯着了。
OpenChamber 就是冲着这三件事来的。它用 OpenCode 作为运行编码 Agent 的内核(一个开源的 AI 编码代理,你已有 OpenCode 账号即可直接用),自己则负责完整的工作流:发起任务、盯着 Agent 别跑偏、审查改动、跨设备接力、把变更交付出去。用一句话概括就是——让 Agent 干活,控制权留在你手里,从哪里都能交付。
需要说明的是,OpenChamber 是独立项目,与 OpenCode 团队没有隶属关系。仓库里各端实现独立成包,日常你感知不到,但想读源码时可以直接按端找:桌面应用看 packages/electron/,Web 与 CLI 服务端看 packages/web/,VS Code 扩展看 packages/vscode/。
三步跑起来:OpenChamber 安装快速步骤
如果你不想要桌面应用,Web/PWA 方式最快,只要三步:
- 备好运行环境:CLI 要求 Node.js 24.14+(桌面版例外,它捆绑了匹配的 OpenCode CLI,什么都不用装)。
- 一行安装:安装脚本会探测你当前的包管理器(pnpm、bun、yarn、npm 都能识别),装的是 npm 包
@openchamber/web,提供可执行文件openchamber;如果已经装过,它会自动转成openchamber update,避免换个包管理器重装把 PATH 弄乱。
# 一行安装(自动适配你的包管理器) curl -fsSL https://raw.githubusercontent.com/openchamber/openchamber/main/scripts/install.sh | bash # 启动服务,并设置 UI 访问密码 openchamber --ui-password be-creative-here- 打开浏览器:CLI 会打印一个地址,通常是
http://localhost:3000,看到 OpenChamber 的会话列表就说明跑通了。装完后别忘了让 OpenCode 保持运行:opencode serve。
想装桌面版更省事:从官方 Releases 页下载对应平台的构建,Linux 提供 AppImage、deb 与 rpm,装完即开,不需要单独装 OpenCode。
日常运维常用这几条命令,一行一个:
openchamber status # 查看服务状态 openchamber logs # 查看日志 openchamber stop # 停止服务 openchamber update # 更新到最新版 openchamber connect-url --qr # 生成本地配对二维码 openchamber tunnel start --provider cloudflare --mode quick --qr # 快速隧道并输出二维码 openchamber startup enable # 设置开机自启亮点功能精选
9 项能力里挑最见功夫的四个先讲,其余稍后一段带过。
让 Agent 自己跑完目标:Session Goals
普通用法下,Agent 每回一条消息就停一次,你得手动推进。Session Goals 把一句提示词变成"终点线":在 composer 点一下目标按钮,你写的第一条消息就成为目标,之后 OpenChamber 在每轮回复后用一个小而便宜的审计模型检查进度,判定继续、完成还是卡住——判定继续就自动发续写提示,目标可验证达成后完成并通知你;只有审计模型连续三次判定"卡住"(确实需要你输入)目标才会转为 blocked,偶尔一次小颠簸不会终结目标。
划重点:这个循环跑在 OpenChamber 服务器进程里,不在浏览器标签页。你关掉页面、锁屏,Agent 照样推进,目标落定时才给你一次通知。还有硬保险丝可选:token 预算、自动续写次数上限、回合出错即停。
多模型并行对比同一任务:Multi-run 与 Fusion
同一个任务到底哪个模型做得好?Multi-run 让你从同一个表单最多挑 5 个模型,每个模型拿到独立会话,同时用你的提示词开跑。勾选isolate runs(隔离运行)后,每个 run 会得到独立的 worktree 会话与分支——worktree 可以理解为 git 给同一仓库开的平行工作副本,这样几个 run 互不触碰同一个文件;非 git 目录这个选项会自动关闭。
跑完你逐一打开每个 run 阅读,留好的、弃差的;或者直接用Fusion,把几个 run 里各自最强的部分合并进一个新会话。单个 run 启动失败也不影响其余 run,只是最终会话数比你点的少。
把大 diff 变成导览:Changes Walkthrough
diff 按文件路径排序,几乎从来不是理解变更的正确顺序。Changes Walkthrough 让 AI 把相关改动重新分组成一串stops(站点),按"后一站建立在前一站之上"的先后排好,每个 stop 解释代码现在做了什么、和以前有何不同。
它会打注意力标签但不评质量:Key change提示你这里驱动了其余变更、值得精读,Context是可以略过的支撑性改动;唯一会报问题是Outdated(描述的代码已变)和Not covered(diff 里有 stop 没覆盖到的变更)。审查范围可选 All uncommitted、Staged、Unstaged、This branch、Pull request,各范围独立缓存互不丢失;结果按 diff 内容加模型加语言做缓存键,恢复旧工作树状态就能免费取回旧 walkthrough。生成跑在服务器端,刷新页面或关面板都不打断。
在会话旁边看运行中的应用:Preview
启动 dev server 后,点应用顶部的 globe 按钮,OpenChamber 靠检查本机实际监听的端口自动发现它,直接内嵌打开,不用另开浏览器标签页。远程场景更妙:桌面应用会在本地开一个端口把连接穿透到远程 dev server,热重载照常。配合内置浏览器面板,你还可以指向页面上任意元素,把截图、样式、坐标和浏览器报错一起发给 Agent——再也不用解释"就这个,这里,有问题"。
其余能力简而言之:连接 GitHub 后可以从 issue 或 PR 直接开 session、代你开与更新 PR;定时任务支持 daily/weekly/once/cron,还能把 cron 任务写成 markdown 文件放进.agents/loops/目录,存进仓库、随时可改;侧边栏汇总各会话的 working/waiting/finished/failed 状态、审批、provider 限额与 token 花费;会话旁边还能随手记 notes 和 todos。
多端怎么衔接:跨设备 Agent 开发配置
所有端打开的是同一批项目与同一批会话。配对的推荐方式是扫一次性二维码:在跑 OpenChamber 的机器上进入 Settings → Remote Instances → Connect to this server → Add a device,给设备命名并选使用范围——This computer only(本机应用)、Home network only(Wi-Fi 直连)、Anywhere(家外也可用,流量走 Private Relay 端到端加密中继,不用开任何端口)——然后 Create QR code,另一端扫码即连上。二维码被兑换即失效,未使用会自动过期;每台设备独立 token,随时可撤销。
| 端 | 适合干什么 |
|---|---|
| Desktop | 全功能工作区:多窗口、Mini Chat、远程机器与 SSH、原生通知 |
| Web / PWA | 浏览器即开即用,可安装成应用,靠后台通知保持最新 |
| VS Code | 会话紧贴代码,选区直接发给 Agent,结果在编辑器里打开 |
| iOS / Android | 离开工位看进度、回答问题、触摸操作终端 |
| CLI / Server | 跑在工位机或服务器上,定时任务、管理远程访问 |
移动端装好应用后扫同一个码就能接入;PWA 则无需应用商店,桌面浏览器点地址栏 Install 即可。目标完成、Agent 在等你输入时,桌面与移动端都会收到推送提醒。
暴露到网络前的安全底线
🔒 四条底线,部署前过一遍:
- 默认只绑定 localhost,只有确实需要局域网访问才加
--lan,且仅限可信网络; - 开了网络访问就务必配
--ui-password强密码,README 里的be-creative-here只是占位示例; - 计划暴露公网时用隧道(Cloudflare/Ngrok 等)加上强密码,而不是裸奔直连;
- 配对设备随时可撤销,Private Relay 可随时禁用,禁用即切断经它连接的所有设备。
延伸阅读
按主题挑了几篇最值得读的仓库内指南:
- 上手:快速开始
- 远程访问:设备配对、Private Relay 原理
- 功能深挖:Multi-run 与 Fusion、Session Goals
- 安全运维:安全基线、自托管反向代理
有 bug 直接提 issue,功能建议先去讨论区对齐方向再动手;贡献前读一下 CONTRIBUTING.md。项目采用 MIT 许可证,代码随取随用。
【免费下载链接】openchamberAgentic Development Environment based on OpenCode AI agent项目地址: https://gitcode.com/gh_mirrors/op/openchamber
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考