【开源推荐】OpenWorkBuddy本地部署的 AI 办公 Agent3 分钟跑起来附完整安装教程标签AI Agent / 开源项目 / 本地部署 / 数据安全 / 办公自动化 / DeepSeek / Ollama一、这是什么OpenWorkBuddy是一个跑在自己电脑上的 AI 办公助理。项目地址https://github.com/CatCatUncle/openworkbuddy一句话说明它的区别你说一句话它自己规划、动手、验收把 PPT / Word / Excel / 网页落到你硬盘上。它给你的是能打开的文件不是一段聊天记录。项目信息截至 2026-09-26来自 GitHub 公开接口项值Star203Fork46主要语言JavaScript建仓时间2026-08-10最后推送2026-09-25开源协议PolyForm Noncommercial 1.0.0二、为什么选它三个核心卖点卖点 1本地优先数据不出电脑会话、文件、模型 Key全部落在本机~/OpenWorkBuddy服务默认只监听 127.0.0.1只有你这台机器能访问接本机Ollama可以做到完全不出网卸载不删数据对处理合同、财务表、未发布方案、客户名单这些敏感材料的人来说这一点是刚需。卖点 2开源可审计代码是透明的闭源产品说我们很安全你只能信开源产品你可以真的去读代码。这个项目的模型路由、工具调用、文件验收、记忆、权限、本地 Trace全在同一个仓库里。读代码路线从server.js进去再看agent.js怎么编排模型和工具。卖点 3真交付文件不是我帮你在聊天框里写好了是磁盘上真的多了一个 .pptx。而且有个很硬的机制说写了文件却不在磁盘上当场拦下重做。三、安装教程三种方式任选一种方式一macOS 一键安装最简单打开终端粘贴这一行curl-fsSLhttps://raw.githubusercontent.com/CatCatUncle/openworkbuddy/main/install-mac.sh|bash一个弹窗都没有。第一次打开被系统拦截怎么办证书还在申请包是 ad-hoc 签名系统拦的是没见过的开发者不是文件有毒。提示无法验证弹窗点「完成」→ 系统设置 → 隐私与安全性 → 拉到底点「仍要打开」或者把 .app 拖进「应用程序」后执行xattr-drcom.apple.quarantine /Applications/OpenWorkBuddy.app提示已损坏签名被网盘/解压工具弄坏了重新下载一次双击没反应看日志~/OpenWorkBuddy/logs/boot.log方式二Windows去项目的Releases页面下载安装版-win-setup.exex64 / ARM 通用免安装版-win-x64-portable.exe不让装软件的环境用被拦截就点「更多信息」→「仍要运行」。方式三源码运行开发者推荐环境要求Node.js 18零构建gitclone https://github.com/CatCatUncle/openworkbuddy.gitcdopenworkbuddynpminstallnpmrun app# 桌面版# 或者npmstart# → http://localhost:3800测试不需要 API Key 也能全绿npmtest四、配置模型填个 Key 就能用进设置 → 模型挑预设粘 Key保存即生效。支持OpenAI / Anthropic / OpenRouter / DeepSeek / 通义 / 智谱 / Kimi / 火山方舟 / Ollama生图、配音、生视频另有一张配置表。⚠️注意Key 只存在config.json已经在.gitignore里了但别手滑提交。一个省钱技巧如果你本机已经装了Claude Code或Codex可以一键拿它当发动机openworkbuddy engines use claude-code跑在你已经付过钱的订阅上不烧 API 额度。五、CLI 用法命令行党看这里npmlink# 一次性装成全局命令也可以直接 node cli.js ...openworkbuddy帮我写一份本周周报# 单发跑完就退openworkbuddy# 交互连续对话打 / 出命令菜单caterror.log|openworkbuddy这是什么问题# 管道管道内容当材料送进去openworkbuddy-q生成本周周报周报.md# 文件里只有周报没有进度条常用子命令命令作用sessions看历史会话resume接着上次往下做engines换执行引擎doctor环境体检pair扫码把手机连上来worktree多分支并行退出码是说实话的0成功1任务失败2参数写错130CtrlC所以openworkbuddy doctor npm start这种写法能真正拦住没配好的机器。另外单发和管道模式下不会反问你放脚本和 cron 里不会卡住。六、加技能有多简单存一个 Markdown 文件这是我觉得最香的设计skills/ 你的技能名/ skill.md存盘后下一条任务就生效——不改代码、不重启、不打包。也就是说把公司的内部流程写成 md 文件Agent 就会照做了。社区技能装之前会先过一遍静态体检危险的默认不装。但作者提醒它不是杀毒装前自己读一眼 skill.md。七、部署给团队用gitclone https://github.com/CatCatUncle/openworkbuddy.gitcdopenworkbuddybashdeploy.sh--domainbuddy.example.com# Docker 自动 HTTPS多租户、席位、额度离职一键收权限第一个注册的账号就是超管对想把数据关在内网的企业这是关键能力。八、安全机制这块很实在Agent 手里有 shell所以它做了几层防护机制说明命令审批危险命令要人点头文件黑名单某些路径不许碰URL 白名单限制访问范围审计日志记下都干了什么四档权限按场景收紧或放宽静态体检装技能前先安检危险默认不装无人值守终端前没人时审批当场拒可用--allow预先放行放公网前先读安全文档默认配置只为本机调。九、协议与商用重要别踩坑PolyForm Noncommercial 1.0.0用途是否需要授权自己用免费学习用免费非营利用免费公司内部使用需要商业授权拿去赚钱需要商业授权买授权不解锁功能——只有这一份代码。不存在免费版阉割的套路。部署配置、脚本、技能模板等另按 MIT 发布见LICENSE-ECOSYSTEM.md生态部分更宽松。十、适合谁用适合关心数据安全、代码透明的技术团队想学习 Agent 主循环实现的开发者/研究者想在企业内做 AI 落地但过不了安全关的IT 负责人想二次开发做自己产品、想找 FDE 落地的创业团队不太适合完全不想配 Key、不想看文档的人需要大厂级 SLA 售后的大公司不过可以单独谈合作十一、联系方式商用 / 二次开发 / FDE 合作作者是开发者猫叔前大厂 Agent 工程师常驻深圳。可接业务企业 AI 内训、企业私有化部署、行业智能体、AI 数字化全案、AI 搜索优化GEO、Agent 项目落地、FDE 驻场工程。服务过的客户类型跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企。邮箱contactaijentra.com微信agi_smith总结OpenWorkBuddy 值得一试的三个理由本地优先—— 数据不出电脑能接 Ollama 完全离线开源自审计—— 代码透明Agent 主循环全在仓库里真交付文件—— PPT/Word/Excel/网页真生成有验收机制项目地址https://github.com/CatCatUncle/openworkbuddy觉得有用的话去项目主页点个 star。这类项目能持续维护下去靠的就是这个。本文项目数据203 star / 46 fork / 最后推送 2026-09-25截至 2026 年 9 月 26 日来自 GitHub 公开 API。OpenWorkBuddy 是独立开源项目与腾讯及其 WorkBuddy 产品无任何关联。
