OpenWorkBuddy 本地部署实战把一句话任务变成 PPT、Word、Excel 和网页摘要OpenWorkBuddy 是一个本地优先的 AI 办公 Agent。它把自然语言任务交给模型规划再通过工具操作工作区最后把 PPTX、DOCX、XLSX、HTML 等成果文件落到本机。本文介绍它适合解决的问题、桌面与服务器部署方式、模型接入、多任务与权限安全以及企业使用时必须确认的授权边界。关键词OpenWorkBuddy本地部署AI Agent企业 AgentMCPClaude CodeCodexAI 办公自动化一、为什么需要一个能交付文件的 Agent日常用 AI 办公时最常见的断点不是“模型不会回答”而是回答之后仍要人工复制内容、整理表格、制作演示文稿、检查文件和分发结果。OpenWorkBuddy 的目标是把这段流程连起来用户用自然语言描述目标Agent 规划步骤、调用工具、读取或写入工作区并把实际生成的文件交给用户检查。它支持生成 PPT、Word、Excel、网页、调研报告等成果也可以联网搜索、运行脚本、定时执行任务并通过飞书、企业微信、微信、钉钉等入口远程下达任务。与单纯聊天相比它更强调“文件有没有真实落盘、结果能不能打开验收”。二、它是不是纯本地模型这里要区分“本地运行”和“本地推理”。OpenWorkBuddy 可以运行在个人电脑或自托管服务器上会话、工作文件和配置由部署者管理但具体推理模型可以来自云端 API也可以使用 Ollama 等本地模型。项目采用 BYOK 思路用户配置自己有权使用的模型 Key也支持把本机已安装的 Claude Code 或 Codex CLI 作为执行引擎。所以“本地部署”不自动等于“所有数据都绝不出网”。如果连接云端模型或调用联网工具请按企业的数据分类要求配置模型、网络和工作区。需要完全离线时应选本地模型并关闭不需要的外部连接再在目标网络环境中自行验证。三、快速启动桌面、本机服务与服务器macOS 可以按项目 README 提供的安装脚本安装Windows 可从 Releases 下载安装包。也可以从源码运行要求 Node.js 18 或更新版本git clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy npm install npm start启动后访问本机服务页面配置模型渠道和 API Key再用一个小任务验证模型连通、文件写入和输出目录。默认数据目录是用户主目录下的 OpenWorkBuddy 文件夹容器部署则把持久化数据放在独立目录升级程序时不要删除数据目录。服务器部署可以使用 Docker 部署脚本也可以用 Docker Compose 或 PM2。服务默认绑定本机回环地址若要供团队访问应经过反向代理和 HTTPS并先注册管理员、关闭公开注册、启用命令审批再根据组织的安全要求开放访问。项目的安全文档明确提醒Agent 有运行命令、读写文件和访问网络的能力公网暴露前必须认真配置不应把默认开发配置直接当生产安全基线。四、模型、工具与可扩展能力模型配置页支持多个常用渠道及兼容接口格式。模型与生图、配音、生视频等媒体能力分别配置是否能完成某类生成任务取决于接入的模型或服务、凭据、额度和相应能力是否可用。扩展上有三条常用路径技能一个 Markdown 技能文件描述任务步骤和约束保存后可供后续任务使用适合快速沉淀团队 SOP。MCP 连接器通过标准协议把外部工具接入 Agent扩充可调用能力。Agent Plugins项目支持 Agent Plugins 1.0.0可安装同时包含技能和 MCP 的插件包具体插件仍应审查来源和权限。项目还提供 CLI桌面端、终端和服务共享配置、会话、技能、记忆和连接器。运维或自动化脚本可以使用命令行任务、会话恢复、JSON 输出和退出码不必把每个工作流都塞进 GUI。五、企业团队部署时应重点评估什么OpenWorkBuddy 有组织、成员、部门、角色、额度和操作审计等管理能力可以通过集中部署让浏览器、桌面端、手机或 CLI 连接同一服务。团队落地时建议按真实任务试点选定一个低敏感度流程准备样例文件记录耗时、人工复核点、模型费用和失败恢复方式再决定是否扩大范围。部署评估至少包括模型服务的数据处理条款、网络可达性、Key 管理与费用归属哪些目录允许 Agent 访问哪些命令需要逐步审批账号开通、离职停用、定时任务归属、备份恢复及日志保存公网反向代理、注册策略、管理员账号和密钥轮换输出质量如何由业务人员验收错误结果如何撤回或修正。不要把“有管理后台”理解成自动满足企业合规。项目文档把 SSO、目录同步、SIEM 审计外送、气隙部署、高可用等列为路线图能力对这些有硬性要求的组织需要先核对当前版本并做实际验证。六、和 Codex、Claude Code、WorkBuddy 怎么比较OpenWorkBuddy 并非把这些产品内部实现复制过来也不应被描述成所有任务上的绝对胜者。它更像一个本地优先的办公 Agent 工作台可以产出办公文件和网页具有 MCP、技能、CLI、定时任务、IM 入口与短剧画布在本机已安装对应 CLI 的情况下也可以将 Codex 或 Claude Code 接入为执行引擎。如果主要工作是仓库级代码理解、IDE 深度集成或某一云产品独有能力原产品可能更贴合。若需要自托管、模型可切换、办公文件交付、面向团队扩展的 Agent 外壳OpenWorkBuddy 值得作为候选方案进行同任务对比。所谓“平替”应通过相同输入、相同模型和相同验收标准实测而不是只看产品名称。七、AI 短剧和无限画布也是它的特色场景无限画布可把剧本、角色、场景、分镜、参考图、视频、配音和时间线放在同一工作空间。节点之间的连线表示后续生成步骤会读取的依赖素材修改单个镜头时可以围绕该镜头继续处理避免把整个项目当成一段长聊天记录。项目内置短剧技能覆盖分镜表、角色定妆、镜头首帧、图生视频、配音和拼片等环节。它提供的是工作流与画布不代表任何模型都能无条件生成高质量成片成品效果还取决于模型、素材、提示词、费用预算和人工审片。八、常见问题OpenWorkBuddy 是否必须使用某一家模型不必。项目支持多个模型渠道和兼容 API也支持本地模型不同渠道的能力、价格和效果由对应服务决定。能否部署到企业服务器给团队使用可以自托管并配置多用户与组织管理能力。部署前要配置访问控制、注册策略、权限档位、备份和安全边界。公司内部使用是否免费按项目当前 PolyForm Noncommercial 许可与授权说明公司把程序用于实际业务即使只在内部使用也需要商业授权。公司评估试用最长 30 天且不能用于实际业务。商业二次开发、SaaS、客户交付或打包售卖也应先联系权利人确认授权项目名称和商标另有边界。是否保证一句话就做出高质量短剧不应作这种保证。自然语言可以启动工作流成片质量仍受模型与素材质量、流程配置和人工审片影响。结语如果你在寻找本地部署的 AI Agent希望从自然语言任务走到可验收的文件OpenWorkBuddy 提供了一条可检查、可扩展的实现路线。建议从小任务开始先验证模型、文件目录、权限和结果质量再评估团队部署。项目主页与安装文档GitHubhttps://github.com/CatCatUncle/openworkbuddy部署文档https://github.com/CatCatUncle/openworkbuddy/blob/main/docs/部署.md功能清单https://github.com/CatCatUncle/openworkbuddy/blob/main/docs/功能清单.md商用边界https://github.com/CatCatUncle/openworkbuddy/blob/main/docs/开源与商业版边界.md商业授权咨询企业实际业务使用、个人商业用途或商业二次开发请联系 contactaijentra.com。