一、为什么企业一定要走本地部署这条路先说结论只要你的公司在处理客户数据、源代码、财务信息AI 工具的本地部署就不是可选项是必然选项。原因分三层① 数据主权。数据、文件、API Key 全在本地默认只监听127.0.0.1。这是金融、制造、国央企行业过合规的前提。② 成本可控。云端 AI 按 token 计费是浮动支出没法做预算本地部署 自有模型是固定投入。③ 能力沉淀。员工摸索出的工作流是公司资产。留在云端平台账号里人走了就散了。对一个技术负责人来说还有第四个理由可维护、可审计、可二次开发。黑盒 SaaS 你只能等供应商排期。二、选型自研 vs 采购 vs 开源底座我按这三个选项做过对比结论很明确。方案前期投入可定制性数据边界风险完全自研3–5 人 × 半年100%完全自主做出来了没人长期维护烂尾率高商业 SaaS低低黑盒数据在厂商被锁死涨价没办法开源底座二次开发1–2 人 × 数周高扩展点开放完全自主需搞定授权合规自研最贵的地方不是开发成本是维护成本。Agent 不是一个做完就完了的产品——模型更新要适配、工具报错要兜底、提示词要迭代。你搭起来的不是系统是一个要长期养的活物。我的建议找能满足 80% 需求的底座自己做剩下 20%。三、为什么选 OpenWorkBuddy 当底座3.1 基础件齐全评估一个 Agent 底座先看它有没有替你把不产生业务价值但必须做的部分做完Agent 主循环规划 → 工具调用 → 观察 → 继续工具调用框架文件验收机制说写了文件磁盘上必须有记忆系统权限控制审计日志多模型路由会话持久化 / 断点续跑 / 并发任务这些它都有而且是在一个仓库里全摊开的textserver.js → agent.js → 模型路由 / 能力层 / 工作区 / Trace想搞懂 Agent 主循环怎么转从这两个文件进去就行。3.2 技术栈对二次开发友好Node.js 18零构建。bashgit clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy npm install npm run app # 桌面版 # 或 npm start # → http://localhost:3800没有复杂的编译链、没有构建等待、没有沉重的工程配置。改完存盘就见效——对抽两个人做二次开发这种规模的团队这一条能省掉大量前期成本。3.3 四个明确的扩展点这是它最值钱的设计。扩展点位置用途门槛Skillsskills/名字/skill.md加业务能力会写文档即可MCP标准协议接外部工具/数据源懂协议Plugins插件目录改 Agent 行为需写代码Enginesopenworkbuddy engines换执行引擎一条命令四、部署全流程4.1 本机试跑先评估再上内网bashgit clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy npm install npm run app # 桌面版 npm start # 或 → http://localhost:3800填一个模型 Key 即可。数据落在~/OpenWorkBuddy卸载不删。模型可选界面「设置 → 模型」点一下切换BYOKtextOpenAI / Anthropic / OpenRouter / DeepSeek / 通义 / 智谱 / Kimi / 火山方舟 / Ollama本地模型如果要做完全离线的内网部署走 Ollama 这一路。生图、配音、生视频的模型另有一张配置表。⚠️ Key 只存在config.json已在.gitignore里。别手滑提交。4.2 服务器部署团队用bashgit clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy bash deploy.sh --domain buddy.example.com # Docker 自动 HTTPS关键提醒起来之后先注册管理员——第一个注册的账号自动成为超管。配套文档docs/部署.md—— 服务器 / Docker / 反代deploy/README.md—— 运维手册docs/多人协作.md—— 多租户、账号、权限、额度4.3 内网/无公网场景几个要点模型走 Ollama本地加载不出网默认监听127.0.0.1需要局域网访问时改监听地址但不要直接暴露公网URL 白名单限制 Agent 能访问的域名无公网场景可以直接全禁文件黑名单把密钥目录、财务数据目录加进去权限档按部门给不同的权限档位4.4 关键配置企业管控部署完之后这些是企业必须配的席位给谁开账号额度每个员工的用量上限——防止单人烧光部门预算权限回收离职一键收权限审计运行记录每趟调了哪些工具、为什么这么说都能点开看五、实测几个典型场景5.1 软著材料一键生成挂上软著技能把代码仓库作为输入产出程序鉴别材料文档鉴别材料说明书在线表单所需字段文本软著代理费市场价几千到上万而流程本身高度标准化。5.2 AI 短剧无限画布剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。关键设计连线表示生成关系改哪个镜头只有那个镜头重跑。画布交互text空白处拖拽 → 平移 Shift 拖拽 → 框选 Shift / ⌘ 点击 → 加减选 底部输入框 → 引用任意节点和素材对短剧工作室这一条直接省掉改一处、重算一季的成本。5.3 音视频分离给一个视频链接分离人声与背景音乐。作者实测用DeepSeek模型耗时约为 Codex 方案的一半。5.4 定时任务 IM 推送每天早上抓行业新闻做晨报推到飞书 / 企微 / 钉钉。人不在电脑前也照跑错过了会补跑。配置入口「自动化」运行记录可查每趟的工具调用。六、命令行适合做自动化和集成CLI 与桌面版共用同一份配置、技能、记忆、连接器和会话bashnpm link # 一次性装成全局命令 openworkbuddy 帮我写一份本周周报 # 单发跑完就退 openworkbuddy # 交互 cat error.log | openworkbuddy 这是什么问题 # 管道 openworkbuddy -q 生成本周周报 周报.md # 静默只出结果 openworkbuddy engines use claude-code # 换执行引擎 openworkbuddy doctor # 环境自检 openworkbuddy sessions / resume # 会话管理 openworkbuddy pair # 扫码把手机连上来退出码语义可直接用于 CI / 脚本text0 成功 1 任务失败 2 参数写错 130 CtrlC单发和管道模式不会反问脚本和 cron 里不会卡住。七、二次开发上手7.1 加一个业务技能最低门槛textskills/ └── 客户提案生成/ └── skill.md存盘后下一条任务就生效——不改代码、不重启、不打包。这一步不需要会编程。业务专家自己就能沉淀能力财务写审核规则、销售写跟进话术、法务写合同检查点。7.2 接内部系统MCP走标准 MCP 协议把 ERP / CRM / 工单系统接进来让 Agent 能读内部数据、写内部记录。7.3 换执行引擎bashopenworkbuddy engines use claude-code本机装了 Claude Code / Codex 的可以拿它当发动机跑在已付费订阅上不额外烧 API 额度。八、安全清单上线前必查这个 Agent 手里有 shell能跑命令、读写文件、上网。上线前逐条核对[ ] 命令审批开了吗危险命令要人工确认[ ] 文件黑名单配了吗密钥、财务目录[ ] URL 白名单配了吗[ ] 权限档设对了吗按部门最小权限[ ] 审计日志能查吗[ ] 装第三方技能前做静态体检了吗[ ] 是否默认只听127.0.0.1[ ] 放公网的是否读过docs/安全.md官方明确说明默认配置只为本机调试设计。放公网前务必先读安全文档。它还提供了姊妹项目toolward——给 Agent 用的技能/MCP 连接器静态安检37 条规则分六族零运行时依赖。npm i -g toolward装上OpenWorkBuddy 自动把它当第二把尺子。九、授权商用之前必须确认的事协议是 PolyForm Noncommercial 1.0.0text个人使用 → 免费 学习使用 → 免费 非营利使用 → 免费 公司内部使用 → 需要商业授权有一个细节值得说清楚买授权不解锁功能代码只有这一份。也就是说未授权版本和授权版本功能完全一样——差别只在合不合规。这个表态反而说明作者是认真做长期生意的不靠功能阉割逼单靠合法性和服务。需要商业授权、企业私有化部署、二次开发合作、FDE驻场工程textcontactaijentra.com作者背景常驻深圳前大厂 Agent 工程师服务过跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企等客户。业务范围企业 AI 内训 / 企业私有化部署 / 行业智能体 / AI 数字化全案 / AI 搜索优化 / Agent 项目落地。写邮件时把行业、规模、要解决的问题、是否二次开发、数据安全要求写清楚能直接拿到方案。十、总结企业本地部署 Agent 系统OpenWorkBuddy 是我目前评估下来完成度最高的开源选项。理由收敛成五条交付物可验收——文件真落盘说写了没写会被当场拦下企业后台完整——多租户、席位、额度、离职收权限扩展成本极低——加能力就是加一个 Markdown 文件技术栈友好——Node.js零构建改完存盘见效维护节奏稳定——2026 年 8 月建仓至今几乎每天提交本地部署的 Agent 软件 本地部署的模型是注重数据安全的企业绕不开的方向。以前这个方向要么自己从零搭要么忍数据风险。现在有一个完成度够高的开源底座了。基于它做二次开发同样是目前性价比最高的路径。项目地址https://github.com/CatCatUncle/openworkbuddy商业授权contactaijentra.com