Get started
Install, configure, and run your first OpenCowork agent session.
Get started
OpenCowork 是一个开源桌面平台,用来让多个 AI Agent 在你的本地项目里协作。它提供本地文件读写、Shell、代码搜索、上下文感知、子代理、团队协作以及人类审批机制。
目标用户是:希望 AI Agent 能直接在本地代码库中工作、同时保留可控权限和可见执行过程的开发者。
你可以用它做什么
- 在本地项目里和 AI 对话,并允许它读取、搜索、修改文件。
- 让 Agent 调用 Shell、MCP、浏览器、桌面控制等工具。
- 通过子代理把复杂任务拆给不同角色。
- 通过 Agent Teams 让多个成员协作完成计划。
- 配置 Cron,让 Agent 定时执行任务。
- 把 AI 接入飞书、钉钉、QQ、Telegram、Discord、WhatsApp 等消息平台。
First run
- 安装或启动应用使用 release 安装包,或在仓库根目录运行开发命令。
- 配置模型在 Settings 里添加 provider key,选择默认模型。
- 选择工作目录把一个本地项目绑定到当前会话。
- 发起任务让 Agent 搜索代码、解释文件、制定计划或执行工具。
Key directories
| 目录 | 用途 |
|---|---|
src/main/ | Electron main process、数据库、IPC、MCP、消息平台、Cron、SSH |
src/preload/ | 安全桥接层 |
src/renderer/src/ | React UI、Agent loop、工具注册、Zustand stores |
src/shared/ | 跨进程类型、事件协议、工具契约 |
resources/agents/ | 内置子代理定义 |
resources/skills/ | 内置技能 |
resources/commands/ | 内置 slash commands |