跑在你自己电脑上的 AI 办公助理。
交代一句话，它自己规划、动手、验收，把 PPT / Word / Excel / 网页落到你硬盘上。
给你的是能打开的文件，不是一段聊天记录。
A local-first AI office agent that hands you files, not chat logs. · English
▶ 三分钟跑起来 · 下载安装包 · 功能清单 · 文档 · 交流群 · 变更记录
自己用、学习用、非营利用 免费；公司里用要授权，一句话讲清 ↓
| 你说一句 | 它交给你 |
|---|---|
| 帮我出一份 Q3 复盘 PPT，数据用这个 Excel | 读表 → 算 → 一个能直接放的 .pptx |
| 调研国内 AI 陪伴产品，出一份报告 | 联网搜 → 逐个打开读 → Markdown / Word |
| 把这份材料做成手机上能看的网页 | 写 HTML → 起本机服务 → 扫码就能看（成品） |
| 每天 9 点抓行业新闻，做成晨报发我飞书 | 定时任务 + IM 推送，错过了会补跑 |
Note
多任务并行、目标验收、👍👎 进自进化、双层记忆、权限档位、IM 远程指挥、桌面宠物…… 全部能力见 功能清单。
|
📄 文件是真的。 PPT / Word / Excel / 网页都真生成，成果面板里点开就能验收。说写了文件却不在磁盘上，当场拦下重做。 |
🔌 模型随便换，东西全在你手里。 DeepSeek / 通义 / 智谱 / Kimi / OpenRouter / Ollama 界面点一下就切；本机装了 Claude Code / Codex 的，一键拿它当发动机，不用另买 token。会话、文件、Key 全在本机，默认只听 |
|
🧩 加个能力 = 丢一个 Markdown 文件。 存成 |
🔍 也适合拿来读懂 Agent。 模型路由、工具调用、文件验收、记忆、权限、本地 Trace 全在同一个仓库里：一条真实任务，从它为什么这么做到最后交了什么，你都看得见。 |
macOS（一个弹窗都没有）：
curl -fsSL https://raw.githubusercontent.com/CatCatUncle/openworkbuddy/main/install-mac.sh | bashWindows：Releases 下 -win-setup.exe（x64 / ARM 通用）；不让装软件就用免安装版 -win-x64-portable.exe。
源码（Node.js 18+，零构建）：
git clone https://github.com/CatCatUncle/openworkbuddy.git
cd openworkbuddy && npm install
npm run app # 桌面版；或 npm start → http://localhost:3800填一个模型 Key，然后说人话就行。数据都在 ~/OpenWorkBuddy，卸载不删。字号、主题在右上角头像 →「外观」。
第一次打开被系统拦住
证书还在申请，包是 ad-hoc 签名：系统拦的是「没见过的开发者」，不是文件有毒。
- macOS 无法验证：弹窗点「完成」→ 系统设置 → 隐私与安全性 → 拉到底点「仍要打开」。或者把 .app 拖进「应用程序」后跑
xattr -dr com.apple.quarantine /Applications/OpenWorkBuddy.app。网上「右键 → 打开」只对 macOS 14 及更早有效。 - macOS 已损坏：签名被网盘/解压工具弄坏了，重下一次。
- Windows：「更多信息」→「仍要运行」。
- 双击没反应：看
~/OpenWorkBuddy/logs/boot.log→ 安装与启动
「同一个人，换四个场景，手里举块写着字的牌子——要像随手拍的，别像 AI 图」
难的不是画人，是四张里得是同一个人、牌子上的中文不能糊。它先出一张，再用看图工具真去读自己刚生的那张（不是凭记忆吹），确认了才照这个方向铺开其余三张。
「做个湖南旅游攻略网站，14 个市州一个都不能少」
https://hunan-travel.pages.dev/ —— 点开就能逛。一个 HTML 加一个图片文件夹，不挂任何外部 CDN，扔到静态托管上就是一个站。这不是截图拼的示意图，是它交出来的那份东西本身。
「每天早上七点，把今天的天气和该注意的事发到我飞书」
一句话排出来的定时任务，人不在电脑前也照跑；每趟调了哪些工具、为什么这么说，都在「自动化 → 运行记录」里点得开。飞书 / 企微 / 钉钉 / Telegram 同一条路。
怎么做到的、本机 Claude Code 当发动机长什么样 → 三个案例，拆开讲
剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。连线不是装饰——它表示下一步生成真会去读的角色、首帧和声音。改哪个镜头，只有那个镜头重跑。
左侧点「无限画布」就能开始。空白处拖拽平移，Shift+拖拽框选，Shift/⌘ 点节点加选减选，底部对话框里能 @ 引用任意节点和素材。
git clone https://github.com/CatCatUncle/openworkbuddy.git && cd openworkbuddy
bash deploy.sh --domain buddy.example.com # Docker + 自动 HTTPS多租户、席位、额度、离职一键收权限都有。起来先注册管理员——第一个注册的就是超管。 → 部署 · 运维手册 · 多人协作
设置 → 模型，挑预设（OpenAI / Anthropic / OpenRouter / DeepSeek / 通义 / 智谱 / Kimi / 火山方舟 / Ollama），粘 Key，保存即生效。生图、配音、生视频另有一张表。对照表 → 配置模型
Important
Key 只存在 config.json，已在 .gitignore 里，别手滑提交。
openworkbuddy 跟桌面版共用同一份配置、技能、记忆、连接器和会话——终端里起的活儿，手机和网页上看得见、插得上话；桌面上做到一半，终端里 openworkbuddy resume 接着往下走。
npm link # 一次性：装成全局命令（也可以直接 node cli.js …）
openworkbuddy "帮我写一份本周周报" # 单发：跑完就退
openworkbuddy # 交互：连续对话，打一个 / 出命令菜单
cat error.log | openworkbuddy "这是什么问题" # 管道：管道内容当材料送进去
openworkbuddy -q "生成本周周报" > 周报.md # 文件里只有周报，没有进度条
openworkbuddy engines use claude-code # 换执行引擎：跑在你已经付过钱的订阅上，不烧 API 额度单发和管道模式下不会反问你，脚本和 cron 里不会卡住。退出码说实话：0 成功、1 任务失败、2 参数写错、130 Ctrl+C，所以 openworkbuddy doctor && npm start 拦得住没配好的机器。
sessions / resume / engines / doctor / pair（扫码把手机连上来）/ worktree，以及 --mode --perm -C -f --json 等全部参数 → 命令行用法
flowchart TB
subgraph Entry["你的设备"]
Desktop["桌面端 / Web"]
CLI["openworkbuddy CLI"]
IM["飞书 / 微信等远程入口"]
end
Entry --> Runtime["OpenWorkBuddy 本地运行时\n会话 · 权限 · 项目 · API"]
Runtime --> Agent["Agent 编排\n规划 · 工具调用 · 文件验收"]
Agent <--> Models["模型路由\n云端 LLM / Ollama / Claude Code / Codex"]
Agent <--> Capabilities["能力层\nMarkdown Skills · 专家 · MCP · Plugins"]
Agent <--> Workspace["本机工作区\n文件 · 素材 · 项目上下文 · 记忆"]
Agent --> Canvas["可执行无限画布\n剧本 · 角色 · 镜头 · 素材 · 时间线"]
Agent --> Trace["本地 Trace\n模型 · 工具 · 耗时 · Token · 输入输出"]
Trace -. 可选 .-> Langfuse["Langfuse"]
这张图也是读代码的路线：从 server.js 进去，再看 agent.js 怎么编排模型和工具。细节 → 实现细节
- 09-25 命令行能打多行：粘贴不自动发，
\回车或Ctrl+J换行，Ctrl+G开编辑器，Ctrl+R搜历史；跑着报用时和 token，Esc 停 - 09-25 命令行：Plan 出完计划直接挑「开干 / 接着改」；
!命令自己跑 shell；终端前没人时审批当场拒，--allow预先放行；规范读到仓库根 - 09-25 回答里提到的文件，只要工作目录里有就能点开，不再只认这一轮刚生成的
- 09-24 命令行审批改成 ↑↓ 挑、回车确定；工具调用像 Claude Code 那样
● Shell(命令)下面挂└ 输出 - 09-24 画布出视频：上游已经收下的那一单出错不再自动重跑，免得扣两次钱；带上卡上写的时长、画幅、分辨率
- 09-24 画布里对话当场进任务历史、显示运行中；输入框提示
@引用文件、/调用技能 - 09-23 改 Windows 换行（CRLF）或 Tab 缩进的文件，写回去跟着文件原来的走；等输入的命令不再空等到超时
- 09-23 命令行
/cost：这个会话一共花了多少 token、约多少钱 - 09-23 命令行加
/review、自定义斜杠命令、--model等开关；能配钩子；workflow按文件分步跑 - 09-23 写代码更顺手：按名找文件、一个文件改多处、读后被改就拦、后台跑命令，进度清单没打勾不许收工
更早的看 变更记录。
它能跑命令、读写文件、上网，所以有命令审批、文件黑名单、URL 白名单、审计日志和四档权限。装别人的技能前会先过一遍静态体检，危险的默认不装——但它不是杀毒，装前自己读一眼 skill.md。
放公网前先读 安全，默认配置只为本机调。
用崩了、有想法、想一起改，进飞书群直接说：
- 用崩了、卡住了，开个 issue，哪怕只贴一句报错——你以为「只有我遇到」的坑，多半所有人都在踩。贴之前扫一眼，别把 API Key 带上。
- 10 分钟 写个技能：一个 Markdown 存成
skills/<名字>/skill.md，存盘即生效，模板在这 - 一晚上 挑个 issue 改：
npm install && npm start就跑起来，npm test不用 API Key 也能全绿
项目结构、测试、PR 规范都在 参与贡献。不用先开 issue 问，直接发 PR。
在找 Claude Cowork、Codex、WorkBuddy、豆包办公、千问办公的开源替代，或者想给 DeepSeek 找一个 agent 外壳（harness）？每一家都写了一页老实对比，也写了什么时候还是用它更合适：
| 你在用 / 在找 | 对比页 |
|---|---|
| Claude Cowork | Claude Cowork 开源替代：本机运行、模型随便换 |
| Codex | Codex 办公版替代：交付的是文件，还能拿 Codex 当发动机 |
| WorkBuddy | WorkBuddy 开源替代：本机运行的 AI 办公助理 |
| 豆包办公 | 豆包办公开源替代：也能用豆包模型 |
| 千问办公 | 千问办公开源替代：通义模型照样用 |
| DeepSeek | DeepSeek agent 外壳：填上 Key 就能干活 |
OpenWorkBuddy 是独立开源项目，跟上面这些公司都没有关联。
| 文档 | 一句话 | 文档 | 一句话 |
|---|---|---|---|
| 功能清单 | 全部能力、技能与工具 | 部署 | 服务器 / Docker / 反代 |
| 案例 | 上面那几张图怎么做出来的 | 多人协作 | 多租户、账号、权限、额度 |
| 安装与启动 | 安装包、源码、常见卡壳 | 安全 | 审批闸门、黑白名单、审计 |
| 配置模型 | 各家 base_url / 模型名对照 | 数据同步与搬家 | 数据存哪、换电脑怎么搬 |
| 命令行用法 | CLI 参数、管道、--json、cron |
开源与商业版边界 | 买授权到底买到什么 |
| 扩展 | 写技能、接 MCP、装插件、建专家 | 路线图 | 接下来做什么、怎么算做完 |
| IM 与定时任务 | 飞书 / QQ / 企微 / 微信 / 钉钉 | 变更记录 | 一句话一条，最新在上 |
| 实现细节 | agent 主循环怎么转的 | 参与贡献 | 项目结构、测试、提 PR |
| 安全基线 | 数据落在哪、谁看得见、哪些没做到 | 远程访问 | 手机/外网连本机，两个开关默认关着 |
- toolward —— 给 agent 用的技能 / MCP 连接器静态安检：37 条规则分六族，零运行时依赖。
npm i -g toolward装上，OpenWorkBuddy 自动把它当第二把尺子用，不装也完全不影响。同样是 PolyForm Noncommercial。
自己用、学习用、非营利用免费；拿去赚钱（含公司内部用）需要商业授权。 协议 PolyForm Noncommercial 1.0.0，商用怎么谈见 COMMERCIAL-LICENSE.md。买授权不解锁功能——只有这一份代码。部署配置、脚本、技能模板等另按 MIT 发布（LICENSE-ECOSYSTEM.md）。
Copyright (c) 2026 开发者猫叔
独立开源项目，与腾讯及其 WorkBuddy 产品无任何关联，不含其代码或素材；对接的 IM 均走公开接口。借鉴来源见 NOTICE.md。有问题请开 Issue。
顺手把它转给一个天天手搓 PPT、周报、会议纪要的同事，比一百次曝光管用。
感谢每一个动手改过这个项目的人。想加入他们：参与贡献。
前大厂 Agent 工程师，有丰富的 Agent 落地实践经验。
- ✔️ 服务过跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企等客户的 AI 解决方案
- ✔️ 企业 AI 内训 ｜ 企业私有化部署 ｜ 行业智能体 ｜ AI 数字化全案 ｜ AI 搜索优化 ｜ Agent 项目落地
常驻深圳，欢迎前来交流和考察。
FDE（驻场工程）、Agent 项目落地及其他企业 AI 业务合作，请直接邮件联系：contact@aijentra.com