# open-cowork
**Repository Path**: cherng/open-cowork
## Basic Information
- **Project Name**: open-cowork
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
🚀 Open Cowork: 你的私人 AI 智能助手桌面应用
• Claude Cowork 的开源实现 • 一键安装
English Docs •
核心特性 •
演示视频 •
下载安装 •
快速开始 •
技能库
---
## 📖 简介
**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
---
## 📦 下载与安装
### 方式一：下载安装包（推荐）
请访问我们的 [Release 页面](https://github.com/OpenCoworkAI/open-cowork/releases) 下载最新版本。
| 平台 | 文件类型 |
|------|----------|
| **Windows** | `.exe` |
| **macOS** (Apple Silicon) | `.dmg` |
### 方式二：源码编译
适合想要贡献代码或进行二次开发的开发者：
```bash
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](https://lima-vm.io/) (`brew install lima`) 后，命令在挂载了 `/Users` 的 Ubuntu 虚拟机中运行。
- **回退模式**：如果没有可用的虚拟机，命令将在本机执行，受路径限制保护。
**配置方法（可选、推荐）**
- **Windows**：如已安装 WSL2，会自动检测。[安装 WSL2](https://docs.microsoft.com/zh-cn/windows/wsl/install)
- **macOS**：
如已安装 lima，会自动检测。lima安装指令如下：
```bash
brew install lima
# Open Cowork 会自动创建和管理 'claude-sandbox' 虚拟机
```
---
## 🚀 快速开始
### 1. 获取 API Key
你需要一个 API Key 来驱动 Agent。我们支持 **OpenRouter**、**Anthropic** 以及多家高性价比的**国产大模型**。
| 服务商 | 获取 Key / Coding Plan | Base URL (必填) | 推荐模型 Model |
|-------|------------------------|-----------------|---------------|
| **OpenRouter** | [OpenRouter](https://openrouter.ai/) | `https://openrouter.ai/api` | `claude-4-5-sonnet` |
| **Anthropic** | [Anthropic Console](https://console.anthropic.com/) | 默认 | `claude-4-5-sonnet` |
| **智谱 AI** | [GLM Coding Plan](https://bigmodel.cn/glm-coding) (⚡️国产特惠) | `https://open.bigmodel.cn/api/anthropic` | `glm-4.7`, `glm-4.6` |
| **MiniMax** | [MiniMax Coding Plan](https://platform.minimaxi.com/subscribe/coding-plan) | `https://api.minimaxi.com/anthropic` | `minimax-m2` |
| **Kimi** | [Kimi Coding Plan](https://www.kimi.com/membership/pricing) | `https://api.kimi.com/coding/` | `kimi-k2` |
### 2. 配置应用
1. 打开应用，点击左下角 ⚙️ **设置**。
2. 填入你的 **API Key**。
3. **关键步骤**：根据上表修改 **Base URL** (如使用智谱/MiniMax等)。
4. 输入想要使用的 **Model** 名称。
### 3. 开始协作
1. **选择工作区**：选择一个文件夹，授权 Claude 在其中工作。
2. **输入指令**：
> "读取当前文件夹下的 financial_report.csv，并帮我生成一份包含 5 页幻灯片的 PPT 总结报告。"
### 📝 重要提示
1. **macOS 安装问题**：安装后若打不开，提示隐私安全问题，请前往 **系统设置 > 隐私与安全性** 进行授权（点击“仍要打开”）。若仍被拦截，可运行：
```bash
sudo xattr -rd com.apple.quarantine "/Applications/Open Cowork.app"
```
2. **网络连接**：对于 `WebSearch` 等联网工具，可能需要开启代理软件的“虚拟网卡 (TUN模式)”功能才能正常访问。
3. **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 # 依赖与脚本
```
---
## 🗺️ 路线图
- [x] **核心**：稳定的 Windows & macOS 安装包
- [x] **安全**：完整的文件系统沙盒
- [x] **技能**：支持 PPTX, DOCX, PDF, XLSX + 自定义技能管理
- [x] **虚拟机沙盒**：WSL2 (Windows) 和 Lima (macOS) 隔离支持
- [x] **MCP Connectors**：支持自定义连接器集成外部服务
- [x] **丰富输入**：聊天框支持文件上传和图片输入
- [x] **多模型**：OpenAI 兼容接口支持（持续迭代中）
- [x] **界面优化**：UI 增强，支持中英文切换
- [ ] **记忆优化**：改进长会话的上下文管理和跨会话记忆。
- [ ] **全新特征**：敬请期待！
---
## 🛠️ 贡献指南
欢迎任何形式的贡献！无论是新技能、UI 修复还是安全改进：
1. Fork 本仓库。
2. 创建分支 (`git checkout -b feature/NewSkill`)。
3. 提交 PR。
---
## 💬 加入社群
欢迎扫码加入微信群交流：
---
## 📄 许可证
MIT © Open Cowork Team
---
Made with ❤️ by the Open Cowork Team with the help of opus4.5