github.com/OpenCoworkAI/open-cowork @v3.3.1
Chat with this repoWhat it actually does AI analysis from the code graph — generated when you open this
README
🚀 Open Cowork: 你的私人 AI 智能助手桌面应用
• Claude Cowork 的开源实现 • 一键安装
English Docs • 核心特性 • 演示视频 • 下载安装 • 快速开始 • 技能库
Open Cowork 是一款免费开源的 AI 智能助手桌面应用，支持 Windows 和 macOS 一键安装，无需任何编程知识。它将 Claude Code、OpenAI、Gemini、DeepSeek 等多种 AI 模型封装为友好的图形界面，提供虚拟机级别的沙盒隔离（Windows 使用 WSL2，macOS 使用 Lima）、内置 Skills 技能系统（可生成 PPTX、DOCX、XLSX、PDF 文档）、MCP 协议集成（连接浏览器、Notion 等桌面应用）、GUI 自动化操作，以及通过飞书和 Slack 进行远程控制。Open Cowork 是 Claude Cowork 的开源实现，让每个人都能轻松使用 AI 驱动的桌面自动化。
📖 简介
Open Cowork 是 Claude Cowork 的开源实现，提供 Windows 和 macOS 一键安装包，无需任何编程知识。
它为 AI 提供了一个沙盒化的工作环境，可以管理文件、通过内置的 Skills 系统生成专业文件（PPTX、DOCX、XLSX等）和 通过MCP链接桌面APP（浏览器、Notion等）进行人机协作等等。
[!WARNING] 免责声明：Open Cowork 仅作为一个 AI 协作工具，请对它的操作保持谨慎。特别是在授权文件修改或删除等操作时，请务必自行审查风险，我们支持了基于VM的sandbox隔离，但是某些操作可能仍存风险。
✨ 核心特性
| MCP & Skills | 远程控制 | 图形界面操作 | |
|---|---|---|---|
| Claude Cowork | ✓ | ✗ | ✗ |
| OpenClaw | ✓ | ✓ | ✗ |
| OpenCowork | ✓ | ✓ | ✓ |
- 一键安装，开箱即用：提供 Windows 和 macOS 预构建安装包，无需配置环境，下载即可开始使用。。
- 灵活模型支持：支持 Claude、OpenAI 兼容接口，以及国产大模型 GLM、MiniMax、Kimi 等。使用你的 OpenRouter、Anthropic等API Key，灵活配置。更多模型持续接入中！
- 远程控制：可以接入飞书等协作平台和远程服务，实现工作流自动化和跨平台操作。
- 图形界面操作：可以控制和操作电脑上的各种桌面 GUI 应用程序。推荐使用 Gemini-3-Pro 模型以获得最佳的 GUI 理解和控制效果。
- 智能文件管理：可以在工作区内读取、写入和整理文件。
- Skills 系统：内置 PPTX、DOCX、PDF、XLSX 生成和处理工作流。支持自定义技能的添加与删除。
- MCP外部服务支持：通过 MCP Connectors 连接器集成浏览器、Notion、自定义等应用，扩展 AI 能力。
- 多模态交互输入：支持直接拖拽文件和图片到输入框，实现无缝的多模态交互。
- 实时追踪：在 Trace Panel 中观察 AI 推理和工具调用过程。
- 安全可控的工作环境：所有操作限制在你选择的工作区文件夹内。
- 虚拟机级别安全隔离：基于 WSL2 (Windows) 和 Lima (macOS) 的虚拟机隔离，所有命令在隔离的虚拟机中执行，保障宿主机安全。
- UI优化：灵活优美的UI设计、切换系统语言、完善的MCP/Skills/Tools调用展示。
🎬 演示
观看 Open Cowork 实战演示 ：
1. 文件夹收纳整理 📂
https://github.com/user-attachments/assets/dbeb0337-2d19-4b5d-a438-5220f2a87ca7
2. 从文件生成 PPT 📊
https://github.com/user-attachments/assets/30299ded-0260-468f-b11d-d282bb9c97f2
3. 从文件生成 XLSX 表格 📉
https://github.com/user-attachments/assets/f57b9106-4b2c-4747-aecd-a07f78af5dfc
📦 下载与安装
方式一：Homebrew（macOS，推荐）
brew tap OpenCoworkAI/tap
brew install --cask --no-quarantine open-cowork
--no-quarantine可跳过 macOS Gatekeeper 验证，避免"无法验证开发者"的弹窗。
方式二：下载安装包
请访问我们的 Release 页面 下载最新版本。
| 平台 | 文件类型 |
|---|---|
| Windows | .exe |
| macOS (Apple Silicon) | .dmg |
方式三：源码编译
适合想要贡献代码或进行二次开发的开发者：
git clone https://github.com/OpenCoworkAI/open-cowork.git
cd open-cowork
npm install
npm run rebuild
npm run dev
构建安装包：npm run build
安全配置：🔒 沙盒支持
Open Cowork 提供多级沙盒保护，确保系统安全：
| 级别 | 平台 | 技术 | 说明 |
|---|---|---|---|
| 基础 | 全平台 | 路径守卫 | 文件操作限制在工作区文件夹内 |
| 增强 | Windows | WSL2 | 命令在隔离的 Linux 虚拟机中执行 |
| 增强 | macOS | Lima | 命令在隔离的 Linux 虚拟机中执行 |
- Windows (WSL2)：检测到 WSL2 后，所有 Bash 命令自动路由到 Linux 虚拟机，工作区双向同步。
- macOS (Lima)：安装 Lima (
brew install lima) 后，命令在挂载了/Users的 Ubuntu 虚拟机中运行。 - 回退模式：如果没有可用的虚拟机，命令将在本机执行，受路径限制保护。
配置方法（可选、推荐）
-
Windows：如已安装 WSL2，会自动检测。安装 WSL2
-
macOS： 如已安装 lima，会自动检测。lima安装指令如下：
brew install lima
# Open Cowork 会自动创建和管理 Lima 虚拟机（内部 Lima 实例名：'claude-sandbox'）
🚀 快速开始
1. 获取 API Key
你需要一个 API Key 来驱动 Agent。我们支持 OpenRouter、Anthropic 以及多家高性价比的国产大模型。
| 服务商 | 获取 Key / Coding Plan | Base URL (必填) | 推荐模型 Model |
|---|---|---|---|
| OpenRouter | OpenRouter | https://openrouter.ai/api |
claude-4-5-sonnet |
| Anthropic | Anthropic Console | 默认 | claude-4-5-sonnet |
| 智谱 AI | GLM Coding Plan (⚡️国产特惠) | https://open.bigmodel.cn/api/anthropic |
glm-4.7, glm-4.6 |
| MiniMax | MiniMax Coding Plan | https://api.minimaxi.com/anthropic |
minimax-m2 |
| Kimi | Kimi Coding Plan | https://api.kimi.com/coding/ |
kimi-k2 |
2. 配置应用
- 打开应用，点击左下角 ⚙️ 设置。
- 填入你的 API Key。
- 关键步骤：根据上表修改 Base URL (如使用智谱/MiniMax等)。
- 输入想要使用的 Model 名称。
3. 开始协作
- 选择工作区：选择一个文件夹，授权 Claude 在其中工作。
- 输入指令：
"读取当前文件夹下的 financial_report.csv，并帮我生成一份包含 5 页幻灯片的 PPT 总结报告。"
📝 重要提示
- macOS 安装问题：如果直接下载 DMG 安装后提示”无法验证开发者”，推荐使用 Homebrew 安装以避免此问题：
bash brew tap OpenCoworkAI/tap && brew install --cask --no-quarantine open-cowork或者前往 系统设置 > 隐私与安全性 点击”仍要打开”。 - 网络连接：对于
WebSearch等联网工具，可能需要开启代理软件的“虚拟网卡 (TUN模式)”功能才能正常访问。 - Notion连接器使用: 除了设置Notion token之外，还需要在根页面添加连接。更多指引请看https://www.notion.com/help/add-and-manage-connections-with-the-api。
🧰 技能库
Open Cowork 内置技能位于 .claude/skills/，并支持用户自行添加/自定义技能，包含：
pptx：PowerPoint 生成docx：Word 文档处理pdf：PDF 处理与表单xlsx：Excel 电子表格支持skill-creator：技能开发工具包
🏗️ 架构概览
open-cowork/
├── src/
│ ├── main/ # Electron 主进程 (Node.js)
│ │ ├── index.ts # 主入口文件
│ │ ├── claude/ # Agent SDK 与运行器
│ │ │ └── agent-runner.ts # AI 代理执行逻辑
│ │ ├── config/ # 配置管理
│ │ │ └── config-store.ts # 持久化设置存储
│ │ ├── db/ # 数据库层
│ │ │ └── database.ts # SQLite/数据持久化
│ │ ├── ipc/ # IPC 处理器
│ │ ├── memory/ # 内存管理
│ │ │ └── memory-manager.ts
│ │ ├── sandbox/ # 安全与路径解析
│ │ │ └── path-resolver.ts # 沙盒化文件访问
│ │ ├── session/ # 会话管理
│ │ │ └── session-manager.ts
│ │ ├── skills/ # 技能加载与管理
│ │ │ └── skills-manager.ts
│ │ └── tools/ # 工具执行
│ │ └── tool-executor.ts # 工具调用处理
│ ├── preload/ # Electron 预加载脚本
│ │ └── index.ts # 上下文桥接设置
│ └── renderer/ # 前端 UI (React + Tailwind)
│ ├── App.tsx # 根组件
│ ├── main.tsx # React 入口
│ ├── components/ # UI 组件
│ │ ├── ChatView.tsx # 主聊天界面
│ │ ├── ConfigModal.tsx # 设置对话框
│ │ ├── ContextPanel.tsx # 文件上下文显示
│ │ ├── MessageCard.tsx # 聊天消息组件
│ │ ├── PermissionDialog.tsx
│ │ ├── Sidebar.tsx # 导航侧边栏
│ │ ├── Titlebar.tsx # 自定义窗口标题栏
│ │ ├── TracePanel.tsx # AI 推理追踪
│ │ └── WelcomeView.tsx # 引导页面
│ ├── hooks/ # 自定义 React Hooks
│ │ └── useIPC.ts # IPC 通信 Hook
│ ├── store/ # 状态管理
│ │ └── index.ts
│ ├── styles/ # CSS 样式
│ │ └── globals.css
│ ├── types/ # TypeScript 类型
│ │ └── index.ts
│ └── utils/ # 工具函数
├── .claude/
│ └── skills/ # 默认技能定义
│ ├── pptx/ # PowerPoint 生成
│ ├── docx/ # Word 文档处理
│ ├── pdf/ # PDF 处理与表单
│ ├── xlsx/ # Excel 电子表格支持
│ └── skill-creator/ # 技能开发工具包
├── resources/ # 静态资源 (图标、图片)
├── electron-builder.yml # 构建配置
├── vite.config.ts # Vite 打包配置
└── package.json # 依赖与脚本
🗺️ 路线图
详见 ROADMAP.md。
已完成： 安装包 · 文件系统沙盒 · VM 隔离 (WSL2/Lima) · 技能 (PPTX/DOCX/PDF/XLSX) · MCP 连接器 · 多模型支持 · 富文本输入 · 中英文界面
即将推出： 记忆优化 · Linux 支持 · 插件系统 · Computer Use · 正式版发布
❓ 常见问题
Open Cowork 是什么？ Open Cowork 是一款免费开源的桌面应用，为用户提供本地 AI 智能助手工作空间。它将 AI 模型（Claude、GPT、Gemini、DeepSeek 等）封装为图形界面，提供 Windows 和 macOS 一键安装包，无需命令行或编程知识。
Open Cowork 和 Claude Cowork 有什么区别？ Open Cowork 是 Claude Cowork 的开源实现，在此基础上增加了多模型支持（不只是 Claude）、GUI 自动化操作、飞书/Slack 远程控制，以及虚拟机级别的沙盒隔离。详见功能对比表。
支持哪些 AI 模型？ 支持 Claude（通过 Anthropic 或 OpenRouter）、OpenAI 兼容接口，以及国产大模型包括智谱 GLM、MiniMax、Kimi 等。任何提供 OpenAI 兼容 API 的服务商都可以配置使用。
Open Cowork 免费吗？ 是的。Open Cowork 本身完全免费，采用 MIT 开源协议。你只需为所选 AI 模型服务商的 API 调用付费。
支持 Linux 吗？ 目前提供 Windows 和 macOS 的预构建安装包。Linux 用户可以通过源码编译方式使用，详见源码编译章节。
沙盒隔离是怎么工作的？ Open Cowork 提供多级安全保护：所有平台均有基础的路径限制，Windows 和 macOS 还支持虚拟机级别隔离（分别使用 WSL2 和 Lima）。启用虚拟机后，所有命令在隔离的 Linux 环境中执行，保护你的宿主机系统安全。
什么是 Skills？如何创建自定义技能？
Skills 是内置的工作流模板，用于完成特定任务，如生成 PPTX、DOCX、PDF 或 XLSX 文件。Open Cowork 在 .claude/skills/ 目录下预置了默认技能，并提供 skill-creator 工具帮助你构建自定义技能。
什么是 MCP？怎么使用？ MCP（Model Context Protocol，模型上下文协议）让 AI 能连接外部工具和服务。Open Cowork 支持 MCP 连接器，可对接浏览器、Notion 等桌面应用，将 AI 的能力扩展到文件管理和编程之外。
如何设置飞书或 Slack 远程控制？ Open Cowork 支持通过飞书和 Slack 进行远程控制，你可以在协作平台上发送指令并接收执行结果。请在应用设置中查看远程控制配置选项。
数据安全吗？会不会把数据发送到外部服务器？ Open Cowork 完全在本地运行，你的文件保留在你的工作区内。唯一的外部通信是与你配置的 AI 模型 API（如 Anthropic、OpenRouter）之间的交互。没有任何数据被发送到 Open Cowork 的服务器。
🛠️ 贡献指南
欢迎任何形式的贡献！无论是新技能、UI 修复还是安全改进：
- Fork 本仓库。
- 创建分支 (
git checkout -b feature/NewSkill)。 - 提交 PR。
💬 加入社群
欢迎加入我们的社区交流：
- Discord：加入 Discord 服务器 — 实时聊天、技术支持与开发讨论。
- 微信：扫描下方二维码加入微信交流群（中文社区）。
📄 许可证
MIT © Open Cowork Team
Made with ❤️ by the Open Cowork Team with the help of opus4.5
Extension points exported contracts — how you extend this code
SandboxExecutor (Interface)Core symbols most depended-on inside this repo
logShape
Languages
Modules by API surface
For agents
$ claude mcp add open-cowork \
-- python -m otcore.mcp_server <graph>