一、这个项目解决的是什么问题
我电脑上常年开着三个终端窗口,一个跑 Codex,一个跑 Claude,第三个跑 Grok。三个都在干活,可我不知道谁在等输入、谁卡住了、谁已经跑完。想让它们互相递一个文件,只能手动拷到某个目录再告诉另一个路径。终端一关,上下文全丢。
OpenBot 就是冲这个来的。它把每个 AI 命令行客户端当成一个队友,给每个队友一间独立办公室:独立工作目录、独立会话、独立消息队列。一个窗口里能看见谁在跑、谁在等、谁跑完了,也能让它们互相发消息、发文件、发图片。项目自己的说法是本地优先的 AI 队友工作台,数据落在本机 SQLite 里。
它不绑定某一家模型。Codex、Claude Code、Grok CLI、OpenCode、Gemini、Cursor CLI、Cline、Kimi Code、Devin、Copilot CLI、Mistral Vibe、Hermes,都能接进来,还有一些通过 ACP 协议接。这条是它跟单一厂商客户端最大的区别:你手上有什么订阅,就用什么。
二、核心设计机制
最核心的一条是一个 agent 一个工作区。每个 agent 落在 ~/OpenBot/Agents/
第二条是本地事件日志。它把所有动作写进 Electron userData 下的 openbot.db,agent、会话、provider 会话绑定、队列、表情回应、附件索引都在里面。所以关掉再打开,队列还在,会话还在。它自己强调崩溃安全的持久化,队列支持暂停、继续、取消。
第三条是 provider 适配。Codex 走本地 App Server 的 stdio JSONL,Claude 走 Agent SDK 的 stream JSON,其余的走各自的 CLI 加 ACP。它倾向于用自己下载并固定版本的 CLI,你不用动系统里那份;也可以用 OPENBOT_ 开头的一批环境变量指到自己装的那份。
第四条是内嵌浏览器。它不是外挂一个 Chrome,而是一个沙箱化的 WebContentsView,agent 能开页面、读页面、点页面,下载落到 ~/OpenBot/Downloads。这个浏览器用独立的 Electron session,拿不到 window.openbot,也碰不到本地托管的附件。
三、功能拆解
队列是最好用的一块。先进先出,可以暂停、继续、取消,也能扛住崩溃。我经常一次塞五条任务进去,然后去干别的,回来一条条看结果。
频道聊天是另一块。几个 agent 和人可以在同一个频道里,一个任务有明确的 owner,可以显式委派,历史共享。控制项是 Stop、Resume、Reassign、Archive、Restore 这几个,都摆在同一处。
Computer Use 是可选项。macOS、Windows、Linux 都支持,靠发布包里带的 cua-driver 二进制,OpenBot 把它当自己的子进程起,再交给每个 provider。macOS 上要单独给屏幕录制和辅助功能权限。
还有本地技能库。让某个 agent 把一套重复流程整理成技能,它会准备一个带 SKILL.md 的目录并调用 create_skill,技能进共享库并对这个 agent 生效。别的 agent 要到设置里的 Skills 下面 Local skills 自己加。技能有版本,改库里的不会自动更新已安装的副本。
主题是一堆 json 文件。放在数据目录的 themes 文件夹里,设置的外观页里就能选,改文件不用重启。它读不到完整合法的颜色就忽略这个文件,回落到上次保存的选择。
另外还有一个从 Grok Bot 导入 agent 的入口,在服务器设置的 Import 里。导入带名字、指令、头像、技能、例程和记忆,聊天历史不带。
四、适合谁,不适合谁
适合手上同时有两三个 AI 订阅、天天开着好几个终端的人。适合想让 agent 之间互相递活、递文件的人。也适合需要关掉再打开还能接着跑的人。
不适合只想跟一个模型聊天的人,那是杀鸡用牛刀。不适合把这东西当隔离沙箱用的人,它的定位恰好相反,下面会说。也不适合要商用又完全不打算买授权的人。
五、几个需要提前知道的限制
第一,权限非常宽。项目文档里有一段警告写得很直白:agent 以 danger-full-access 加 approvalPolicy 为 never 运行,首次启动同意之后,它们可以读写文件、跑命令、用网络、控制内嵌浏览器,不会再逐次问你。它自己说得很清楚,这不是安全边界,是当前的产品决定。所以只跑你信的任务,留好备份。
第二,许可不是标准开源。它用的是 PolyForm Noncommercial 1.0.0,非商业用途可以改可以分发,商业用途要单独找版权方拿授权。授权可以在设置的 Billing 页里买,分单人版和 2 到 10 人的团队版,也可以直接发邮件问。0.1.11 及更早的版本还是 Apache-2.0。
第三,本地优先不等于离线。Codex 连 OpenAI,Claude 连 Anthropic,Grok 连 xAI,Gemini 连 Google,访问的网页要走网络,插件也可能连自己的服务。数据落在本地,模型调用不落本地。
第四,平台细节不少。macOS 13 起,Apple silicon 和 Intel 都行;Windows 10 起只支持 x64;Linux 是 AppImage,x64 和 arm64 都有,不需要 libfuse2。Ubuntu 23.10 以后和 Debian 13 上,非特权用户命名空间被 AppArmor 限制了,不装那份 profile 就会在启动时退出。
第五,远程桌面只在 Linux x64 的 X11 会话下可用,Wayland 不行,arm64 的 AppImage 根本没打包。Gemini 登录还需要桌面浏览器和 xdg-utils,纯服务器没有桌面就完不成。
六、项目现状
版本 v0.75.0,星标 9537。项目自己说已经可以用于生产,新版本几乎每天一个。发布是按 tag 走的,macOS 出签名公证过的 arm64 和 x64,Windows 出签名过的 x64,Linux 出未签名的 x64 和 arm64 AppImage,发完还会推一个 Docker 镜像。
代码结构是 Electron 主进程加 SolidJS 渲染层,账户 API 跑在 Cloudflare Workers 上,用 D1 存账户和团队隧道。界面文本除了英文还有 14 种语言,阿拉伯语和希伯来语走从右到左布局。这些细节以项目文档为准。
七、常见问题
问:一定要有账号才能用吗?
答:不是。本地用不需要账号。账户是可选的,用一次性邮箱验证码登录,主要为了多设备或者团队协作。
问:它会不会自己偷偷上传我的文件?
答:本地数据和诊断导出是从账户菜单手动触发的。但要注意,agent 调模型时上下文要发给对应厂商,这跟上传文件是两件事。
问:能让几个 agent 一起干一件事吗?
答:可以。频道里可以有一个任务 owner,然后显式委派给别的 agent,历史是共享的,随时能收手。
问:Windows 上装完提示缺命令怎么办?
答:先把原生 CLI 装好,确保 codex、claude 或者 grok 在 PowerShell 里能直接调起来,登录完再重启 OpenBot。Claude Code 还需要 Git for Windows。
问:商业项目能用吗?
答:要单独授权。非商业用途在 PolyForm Noncommercial 1.0.0 下可以直接用,商用得买或者谈。
问:agent 会不会删我的文件?
答:有这个可能。它以完全访问权限跑,没有逐次确认。备份和只跑可信任务是文档里反复强调的两件事。
下载地址
夸克网盘(永久有效):https://pan.quark.cn/s/7383c396d258
本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。






















暂无评论内容