1. 核心痛点：为什么不用 Claude Cowork？
Claude Cowork 订阅费每月 200，且数据全在云端，是个黑盒。我选择 OpenWork 的理由很直接：
- 省钱：MIT 协议开源，只付 API 费。
- 隐私：默认绑定
127.0.0.1，文件读写全在本地。 - 透明：计划（Plan）、步骤（Steps）、审计日志（Audit Log）全部可见，拒绝黑盒操作。
2. 系统架构
OpenWork 采用“薄 UI + 厚引擎”设计。UI 是 Tauri，引擎是 Go 写的 OpenCode。
3. 快速部署
3.1 普通用户（二进制安装）
- 下载：去 Release 页面找
.dmg(macOS),.msi(Windows) 或.deb/.rpm(Linux)。 - 配置：启动后选择 Host 模式，填入你的 API Key。
- 运行：输入自然语言任务（如：“整理 Downloads 文件夹并生成报告”）。
3.2 开发者（源码构建）
环境必须先配齐：Node.js, pnpm, Rust, Tauri CLI, 和 opencode CLI。
# 1. 安装引擎
npm i -g opencode
# 2. 拉取代码并启动
git clone https://github.com/different-ai/openwork.git
cd openwork
pnpm install
pnpm dev
4. 实战配置与 SDK 调用
4.1 Host 模式启动逻辑
UI 通过 SDK 启动本地引擎，我通常直接在代码里控制 Session。
import { createOpencode } from '@opencode-ai/sdk/v2';
const opencode = await createOpencode({
hostname: '127.0.0.1',
port: 4096,
config: {
model: 'anthropic/claude-3-5-sonnet-20241022'
}
});
const { client } = opencode;
// 创建任务
await client.session.create({
purpose: "Clean up my desktop and group files by extension"
});
4.2 权限控制
OpenWork 遵循最小权限原则。任何越权操作都会触发提示，我必须显式回复：
client.permission.reply({
requestID: "req_123",
reply: 'once' // 或 'always', 'reject'
});
5. 竞品横评
| 维度 | OpenWork | Claude Cowork | Eigent |
|---|---|---|---|
| 成本 | 仅 API 计费 | 200/月 | 仅 API 计费 |
| 隐私 | 本地沙箱 + 127.0.0.1 | 云端处理 | 本地 |
| 模型 | 自由切换 (GPT/Claude/Ollama) | 仅限 Claude | 多模型支持 |
| 透明度 | 步骤级审计日志 | 结果导向 (黑盒) | 中等 |
6. 避坑指南
6.1 Linux 桌面崩溃
如果你在 Wayland (如 Hyprland) 下遇到 WebKitGTK 崩溃，直接加环境变量启动，别去翻文档，这是最快的：
WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 openwork
6.2 任务可靠性
我实测发现，处理超大文件夹或复杂 Excel 时，OpenWork 的稳定性略逊于 Claude 原生工具。
- 建议：生产环境关键任务先用
opkg编写专门的 Skill 封装，不要全指望 LLM 临场发挥。 - 权限建议：别为了省事给根目录权限，只给指定的 Workspace Root，否则 Agent 乱删文件你哭都来不及。
6.3 总结
想省钱、要隐私、爱折腾的工程师，选 OpenWork。只想点一下就完事的非技术人员，老实交钱用 Claude 原生版。
