OpenWork 是 Claude Cowork/Codex 的开源替代方案（桌面应用）。

核心理念

• 本地优先，云端就绪：OpenWork 可以在你的机器上一键运行，即时发送消息。
• 组合式设计：桌面应用、WhatsApp/Slack/Telegram 连接器，或服务器。选择适合你的部分，无厂商锁定。
• 可拔插性：OpenWork 基于 OpenCode 构建，因此 OpenCode 能做的功能在 OpenWork 中同样适用，即使目前还没有用户界面。
• 分享即关怀：先在本地单人使用，当你需要时再明确选择远程共享。

OpenWork 的设计理念是，你可以轻松地将智能体工作流打包成可重复、产品化的流程进行部署。

替代 UI

• OpenWork Orchestrator（CLI 主机）：在没有桌面 UI 的情况下运行 OpenCode + OpenWork 服务器。
  • 安装：npm install -g openwork-orchestrator
  • 运行：openwork start --workspace /path/to/workspace --approval auto
  • 文档：apps/orchestrator/README.md

快速开始

从 openworklabs.com/download 下载桌面应用，获取最新的 GitHub 发布，或从以下源码安装。

• macOS 和 Linux 的下载可以直接获取。
• Windows 的访问目前通过 openworklabs.com/pricing#windows-support 上的付费支持计划提供。
• 托管的 OpenWork Cloud 工作节点在完成结账后通过 Web 应用启动，然后可以通过桌面应用中的“添加工作节点” -> “连接远程”来连接。

为什么

当前用于 OpenCode 的 CLI 和 GUI 主要面向开发者，这意味着它们侧重于文件差异、工具名称，且扩展能力有限，通常需要暴露某种形式的命令行接口。

OpenWork 的设计目标是：

• 可扩展性：技能和 OpenCode 插件都是可安装的模块。
• 可审计性：展示发生了什么、何时发生以及原因。
• 权限控制：对特权流程的访问控制。
• 本地/远程：OpenWork 既可以在本地运行，也可以连接到远程服务器。

包含内容

• 主机模式：在你本地计算机上运行 OpenCode
• 客户端模式：通过 URL 连接到现有的 OpenCode 服务器。
• 会话：创建或选择会话并发送提示。
• 实时流：SSE /event 订阅，用于实时更新。
• 执行计划：将 OpenCode 待办事项渲染为时间线。
• 权限管理：显示权限请求并回复（允许一次/始终允许/拒绝）。
• 模板：保存并重新运行常用的工作流（本地存储）。
• 调试导出：当需要提交 bug 时，可以从设置 -> 调试中复制或导出运行时调试报告和开发者日志流。
• 技能管理器：
  • 列出已安装的 .opencode/skills 文件夹
  • 将本地技能文件夹导入到 .opencode/skills/<skill-name>

技能管理器

可在本地计算机或服务器上运行

快速入门

需求

• Node.js + pnpm
• Rust 工具链（用于 Tauri）：通过 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 安装
• Tauri CLI：cargo install tauri-cli
• OpenCode CLI 已安装并可在 PATH 中使用：opencode

本地开发前提条件（桌面）

在运行 pnpm dev 之前，请确保以下内容已安装并在你的 shell 中生效：

• Node + pnpm（项目使用 pnpm@10.27.0）
• Bun 1.3.9+ (bun --version)
• Rust 工具链（用于 Tauri），带有来自当前 rustup 稳定版的 Cargo（支持 Cargo.lock v4）
• Xcode 命令行工具（macOS）
• 在 Linux 上，需要 WebKitGTK 4.1 开发包，以便 pkg-config 能够解析 webkit2gtk-4.1 和 javascriptcoregtk-4.1

一分钟自检

从仓库根目录运行：

git checkout dev
git pull --ff-only origin dev
pnpm install --frozen-lockfile

which bun
bun --version
pnpm --filter @openwork/desktop exec tauri --version

安装

pnpm install

OpenWork 目前位于 apps/app（UI）和 apps/desktop（桌面外壳）。

运行（桌面）

pnpm dev

pnpm dev 现在会自动启用 OPENWORK_DEV_MODE=1，因此桌面开发会使用隔离的 OpenCode 状态，而不是你个人的全局配置/认证/数据。

运行（仅 Web UI）

pnpm dev:ui

所有仓库的 dev 入口现在都会选择相同的开发模式隔离，这样本地测试就能一致地使用 OpenWork 管理的 OpenCode 状态。

Arch 用户：

sudo pacman -S --needed webkit2gtk-4.1
curl -fsSL https://opencode.ai/install | bash -s -- --version "$(node -e "const fs=require('fs'); const parsed=JSON.parse(fs.readFileSync('constants.json','utf8')); process.stdout.write(String(parsed.opencodeVersion||'').trim().replace(/^v/,''));")" --no-modify-path

架构（高层次）

• 在 主机模式 下，OpenWork 运行本地主机堆栈，并将 UI 连接到它。
  • 默认运行时：openwork（从 openwork-orchestrator 安装），负责协调 opencode、openwork-server 以及可选的 opencode-router。
  • 备用运行时：direct，桌面应用直接启动 opencode serve --hostname 127.0.0.1 --port <空闲端口>。

当你选择一个项目文件夹时，OpenWork 会在本地使用该文件夹运行主机堆栈，并连接桌面 UI。这使你能够在没有远程服务器的情况下，在自己的机器上完全运行智能体工作流、发送提示并查看进度。

• UI 使用 @opencode-ai/sdk/v2/client 来：
  • 连接到服务器
  • 列出/创建会话
  • 发送提示
  • 订阅 SSE 事件（服务器发送事件用于将实时更新从服务器流式传输到 UI）
  • 读取待办事项和权限请求

文件夹选择器

文件夹选择器使用 Tauri 对话框插件。功能权限定义在：

• apps/desktop/src-tauri/capabilities/default.json

OpenCode 插件

插件是扩展 OpenCode 的 原生 方式。OpenWork 现在通过“技能”选项卡管理插件，通过读取和写入 opencode.json 来实现。

• 项目范围：<workspace>/opencode.json
• 全局范围：~/.config/opencode/opencode.json（或 $XDG_CONFIG_HOME/opencode/opencode.json）

你仍然可以手动编辑 opencode.json；OpenWork 使用与 OpenCode CLI 相同的格式：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-wakatime"]
}

有用命令

pnpm dev
pnpm dev:ui
pnpm typecheck
pnpm build
pnpm build:ui
pnpm test:e2e

故障排除

如果你需要报告桌面或会话相关的 bug，请打开设置 -> 调试，并在提交问题之前导出运行时调试报告和开发者日志。

Linux / Wayland (Hyprland)

如果 OpenWork 在启动时因 WebKitGTK 错误（例如 Failed to create GBM buffer）而崩溃，请在启动前禁用 dmabuf 或合成。尝试使用以下环境变量之一：

WEBKIT_DISABLE_DMABUF_RENDERER=1 openwork

WEBKIT_DISABLE_COMPOSITING_MODE=1 openwork

安全提示

• OpenWork 默认会隐藏模型推理过程和敏感的工具元数据。
• 主机模式默认绑定到 127.0.0.1。

贡献指南

• 在进行任何更改之前，请先阅读 AGENTS.md 以及 VISION.md、PRINCIPLES.md、PRODUCT.md 和 ARCHITECTURE.md，以充分理解项目目标。
• 在开始开发之前，请确保已安装 Node.js、pnpm、Rust 工具链和 opencode。
• 每次检出代码后运行一次 pnpm install，然后通过 pnpm typecheck 和 pnpm test:e2e（或相关子集脚本）验证您的更改，再提交 PR。
• 提交 PR 时请使用 .github/pull_request_template.md 模板，并附上确切的命令、执行结果、手动验证步骤及证据。
• 如果 CI 测试失败，请在 PR 描述中明确区分是代码相关的回归问题，还是外部/环境/认证等方面的阻塞问题。
• 新的 PRD 应按照 AGENTS.md 中描述的 .opencode/skills/prd-conventions/SKILL.md 规范，添加到 apps/app/pr/<name>.md 文件中。

社区文档：

• CODE_OF_CONDUCT.md
• SECURITY.md
• SUPPORT.md
• TRIAGE.md

首次贡献检查清单：

• 运行 pnpm install 及基准验证命令。
• 确认您的更改有明确的问题链接和范围。
• 为行为变更添加或更新测试。
• 在 PR 中包含执行的命令及其结果。
• 为面向用户的流程变更添加截图或视频。

面向团队与企业

贵公司是否有兴趣在组织内使用 OpenWork？我们非常期待与您交流！请发送邮件至 ben@openworklabs.com ，与我们探讨您的具体应用场景。

许可证

MIT — 详情请参阅 LICENSE 文件。

OpenWork 快速上手指南

OpenWork 是 Claude Cowork/Codex 的开源替代方案，一款支持本地优先、可组合的桌面端 AI 智能体工作流工具。它基于 OpenCode 构建，允许开发者在本地或远程服务器上运行可重复的智能体工作流。

环境准备

在开始之前，请确保您的系统满足以下要求并安装了必要的依赖。

系统要求

• macOS / Linux: 可直接下载桌面应用或从源码构建。
• Windows: 目前需通过付费支持计划获取（详见官网），或尝试从源码构建（需自行解决 Tauri/WebKit 兼容性问题）。
• 架构支持: 适用于主流 x86_64 及 ARM64 架构。

前置依赖

您需要安装以下开发工具链：

1. Node.js & pnpm

   • 推荐 Node.js 最新 LTS 版本。
   • 项目指定使用 pnpm@10.27.0。

   npm install -g pnpm
   

2. Bun (版本 1.3.9+)

   curl -fsSL https://bun.sh/install | bash
   # 验证版本
   bun --version
   

3. Rust 工具链 (用于 Tauri 桌面端构建)

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   source $HOME/.cargo/env
   

4. Tauri CLI

   cargo install tauri-cli
   

5. OpenCode CLI

   • 必须安装 opencode 命令并确保其在 PATH 环境变量中可用。

   # 官方安装脚本
   curl -fsSL https://opencode.ai/install | bash
   

   国内加速提示: 如果官方脚本连接缓慢，可尝试手动下载二进制文件或配置 Rust/Cargo 国内镜像源（如 rust.crates.io 镜像）以加速依赖下载。

6. Linux 额外依赖 (仅限 Linux 用户)

   • 需要 WebKitGTK 4.1 开发包。
   • Ubuntu/Debian:

     sudo apt-get install libwebkit2gtk-4.1-dev
     

   • Arch Linux:

     sudo pacman -S --needed webkit2gtk-4.1
     

   • macOS: 确保已安装 Xcode Command Line Tools (xcode-select --install)。

安装步骤

您可以选择直接使用预编译的桌面应用，或从源码构建进行开发。

方式一：下载桌面应用（推荐普通用户）

1. 访问 OpenWork 下载页面 或 GitHub Releases。
2. 根据您的操作系统下载对应的安装包。
3. 安装并启动应用。
   • 注：Windows 用户若无法直接下载，可参考官网付费支持方案或采用方式二源码构建。

方式二：从源码构建（开发者）

适合需要定制功能或贡献代码的开发者。

1. 克隆仓库

   git clone https://github.com/different-ai/openwork.git
   cd openwork
   git checkout dev
   git pull --ff-only origin dev
   

2. 安装依赖

   pnpm install --frozen-lockfile
   

3. 环境 sanity 检查 运行以下命令确保环境配置正确：

   which bun
   bun --version
   pnpm --filter @openwork/desktop exec tauri --version
   

4. 构建与运行

   • 开发模式运行桌面端 (自动隔离配置，不影响全局 OpenCode 状态):

     pnpm dev
     

   • 仅运行 Web UI:

     pnpm dev:ui
     

   • 生产环境构建:

     pnpm build
     

方式三：使用 CLI 编排器 (无界面模式)

如果您只需要后端服务而不需要桌面 UI：

npm install -g openwork-orchestrator
openwork start --workspace /path/to/workspace --approval auto

基本使用

OpenWork 的核心设计理念是“本地优先”，您可以在本地机器上快速启动智能体工作流。

1. 启动应用

• 如果是桌面版，双击启动图标。
• 如果是源码开发版，运行 pnpm dev。

2. 选择工作区

• 启动后，使用 Folder Picker 选择一个本地项目文件夹。
• OpenWork 将在该目录下初始化本地 Host 栈，并自动连接 UI。
• 此时，它会在本地运行 opencode 服务，无需远程服务器即可处理任务。

3. 创建会话与发送指令

• 在界面中点击 New Session 或选择现有会话。
• 在输入框中输入自然语言指令（Prompt），例如：“重构当前目录下的 utils 函数”或“为这个项目编写单元测试”。
• 系统将实时流式传输（SSE）执行计划、文件修改 diffs 以及权限请求。

4. 管理权限与技能

• 权限控制: 当智能体需要执行敏感操作（如写入文件、执行命令）时，界面会弹出请求。您可以选择 Allow Once（允许一次）、Always（总是允许）或 Deny（拒绝）。
• 技能管理 (Skills):
  • 进入 Settings -> Skills 标签页。
  • 查看已安装的 .opencode/skills 插件。
  • 导入本地技能文件夹以扩展功能。
  • OpenWork 通过读写项目根目录的 opencode.json 来管理插件配置：

    {
      "$schema": "https://opencode.ai/config.json",
      "plugin": ["opencode-wakatime"]
    }
    

5. 远程协作 (可选)

• 默认情况下，服务绑定在 127.0.0.1。
• 若需连接远程服务器：在桌面端点击 Add a worker -> Connect remote，输入远程 OpenCode 服务器的 URL 即可。

6. 调试与导出

• 遇到问题时，前往 Settings -> Debug。
• 导出运行时调试报告 (Runtime Debug Report) 和开发者日志流，以便提交 Issue 或自行排查。

---

提示：首次运行时，请确保网络通畅以下载必要的模型或插件资源。对于国内用户，如遇网络阻塞，建议配置相应的代理或使用国内镜像源加速依赖安装。