OCOpenCowork
Get startedInstallChannelsAgentsCapabilitiesSkillsModelsPlatformsOpsReferenceHelp

Install

Install OpenCowork, verify local dependencies, and start the desktop app or docs site.

Install

OpenCowork 是 Electron 桌面应用。开发环境需要 Node.js 18 或更高版本;发布版本通过 GitHub Releases 分发。

Windows native modules

Windows 上 node-pty 会被 postinstall 脚本跳过;better-sqlite3@jitsi/robotjsssh2 等 native modules 仍需要按 Electron 版本 rebuild。

Desktop release

https://github.com/AIDotNet/OpenCowork/releases/latest

选择与你系统匹配的安装包:

PlatformPackage
Windows.exe installer
macOS.dmg
LinuxAppImage or .deb

From source

git clone https://github.com/AIDotNet/OpenCowork.git
cd OpenCowork
npm install
npm run postinstall
npm run dev

首次启动时,Vite 会编译较多 React 模块,可能需要约 30 秒。之后会明显更快。

Build installers

npm run typecheck
npm run build
npm run build:win

Verify

npm run typecheck
npm run lint

Local data directory

运行时数据默认保存在:

~/.open-cowork/

这里会包含:

  • data.db:SQLite 数据库。
  • config:本地配置。
  • agents/:用户可编辑 agent。
  • commands/:用户命令。
  • prompts/:提示词。

这个目录包含用户本地数据,不应提交到 Git 仓库。

Docs site

文档站点在 docs/ 目录中,是独立的 Fumadocs + Next.js 应用:

cd docs
npm install
npm run dev

On this page