Craft Agents：开源 Agent 桌面应用——Claude Code 的"Pro"版本？
> 一句话版本：Craft 公司做了一个开源的桌面版 Agent 应用——不再只有黑乎乎的终端，而是带收件箱、拖拽文件、多会话管理、后台任务的"漂亮版 Claude Code"。同根同源（Claude Agent SDK），但 UI 完全不在一个量级。
- 官网: https://agents.craft.do/
- GitHub: https://github.com/lukilabs/craft-agents-oss
- 许可证: Apache 2.0
- 技术栈: Electron + Bun + TypeScript
- 研究日期: 2026-04-28
一、这是什么
Craft Agents 是 Craft（craft.do） 团队开发的开源桌面 Agent 应用。
> Craft 是 macOS 上口碑极好的笔记/文档应用，以 UI 精美著称。
Craft Agents 构建在 Claude Agent SDK（和 Claude Code 完全一样的底层）之上，但用 Electron 桌面应用替代了终端界面。
它的核心主张很简单：Agent 不应该活在黑乎乎的终端里。
二、为什么值得关注
2.1 它是 Claude Code 的"老大哥"
| Claude Code | Craft Agents | |
|---|---|---|
| 底层 | Claude Agent SDK | Claude Agent SDK + Pi SDK |
| 界面 | 终端 CLI | **Electron 桌面应用** |
| 数据源 | MCP | MCP + REST API + 本地文件 |
| 会话管理 | `-c` 续传 | 收件箱式，有自定义状态 |
| 多项目 | 单项目 `.claude/` | **多工作区完全隔离** |
| 权限 | 固定模式 | **可定制规则/工作区/数据源** |
| 远程 | SSH + 终端 | 远程服务端 + Web 浏览器 |
| 文件处理 | 命令行参数 | **拖放文件、自动转换** |
| 后台任务 | 不支持 | ✅ 支持，有进度追踪 |
| 多 AI | 仅 Anthropic | Anthropic + Google + OpenAI + Codex |
Claude Code 有的它全有（核心工具、MCP、Skills、思考级别），Claude Code 没有的它也有（多数据源、收件箱、拖放、自动化）。
2.2 "Agent-native" 的开发方式
Craft 团队宣称：「我们在用 Craft Agents 开发 Craft Agents。没有代码编辑器。每个功能、每次修复、每个改进——就是对话。」
这意味着：
- 整个应用是用 AI Agent 写的
- 一切配置都是文件，Agent 可以直接编辑
- 想改什么功能，告诉 Agent 就行
2.3 零配置连接
这是最惊艳的部分。要连接一个服务，你只需要说：
> "把 Linear 加为数据源。"
Agent 会自动：
1. 查找公开 API / MCP 服务器
2. 读取文档
3. 配置凭据
4. 完成设置
不需要配置文件，不需要设置向导，不需要在浏览器来回拷贝 Token。
同样的，粘贴 OpenAPI spec、URL、甚至 API 文档截图都能自动配置。
三、架构与技术栈
技术栈
| 层级 | 技术 |
|---|---|
| 桌面框架 | Electron |
| 运行时 | Bun |
| 语言 | TypeScript |
| AI SDK | Claude Agent SDK + Pi SDK |
| 许可证 | Apache 2.0 |
项目结构
craft-agents-oss/
apps/ — 桌面应用
packages/ — 共享包
docs/ — 文档站点
scripts/ — 构建脚本
Dockerfile.server — 远程服务器部署
多提供商架构
Craft Agents 支持同时配置多个 AI 提供商，按工作区设置默认值：
- Anthropic — API Key 或 Claude Max
- Google — AI Studio
- OpenAI — ChatGPT Plus (Codex OAuth) 或 API
- GitHub Copilot
四、核心特性深度分析
4.1 Sources（数据源系统）
Craft Agents 的数据源分为三级：
| 类型 | 示例 | 能力 |
|---|---|---|
| MCP 服务器 | GitHub, Linear, Craft | 深度集成 |
| REST API | Google, Slack, Microsoft | 查询+操作 |
| 本地文件 | Obsidian vault, 代码仓库 | 文件读写 |
亮点：支持 stdio-based 本地 MCP 服务器（直接跑 npx 命令或 Python 脚本）。
4.2 权限模式（比 Claude Code 更灵活）
| 模式 | 行为 |
|---|---|
| **Explore** | 只读。安全调研。 |
| **Ask to Edit** | 每次操作前确认。 |
| **Execute** | 完全自主。 |
和 Claude Code 最大的不同：权限规则可以按工作区、按数据源级联。Shift+Tab 快速切换。
4.3 自动化系统
事件驱动自动化——设置规则让 Agent 自动触发任务：
- 标签变化触发
- 定时触发
- 工具使用触发
- 创建 Agent 会话执行
4.4 32+ Craft MCP 工具
因为 Craft 本身就是一个文档平台，Craft Agents 有深度集成：
- blocks — 文档块操作
- collections — 集合管理
- search — 全文搜索
- tasks — 任务管理
4.5 Skills
和 Claude Code 相同格式的 Agent Skills。提供了导入功能：
> "把我在 Claude Code 里的技能导进来。" → 自动迁移。
4.6 远程服务器
Dockerfile.server 支持 headless 部署
可从任何机器访问：桌面应用 / 浏览器 / CLI
五、安装与使用
一键安装
# macOS / Linux
curl -fsSL https://agents.craft.do/install-app.sh | bash
# Windows PowerShell
irm https://agents.craft.do/install-app.ps1 | iex
从源码构建
git clone https://github.com/lukilabs/craft-agents-oss.git
cd craft-agents-oss
bun install
bun run electron:start
六、与我们的关系
对 Jay 的参考价值
1. OpenClaw 的潜在借鉴方向
- Craft Agents 证明了 Claude Agent SDK 可以构建比 Claude Code 更丰富的桌面 UI
- OpenClaw 可以考虑类似的桌面端增强（目前 OpenClaw 是 CLI + Gateway）
2. Electron 桌面 UI 作为 Agent 界面
- 收件箱式会话管理、拖放文件、状态工作流——这些都是终端做不到的
- OpenClaw 是否需要一个类似的桌面前端？
3. Source 架构
- MCP + REST API + 本地文件的三级数据源设计值得学习
- OpenClaw 的 tool 系统可以借鉴这种"零配置连接"的设计
4. 多 AI 提供商支持
- Craft Agents 支持 Anthropic + Google + OpenAI + Codex
- 如果要做 OpenClaw 的桌面端，多提供商是必须的
5. Automation 系统
- 事件驱动的 Agent 自动化（标签变化、定时触发）
- OpenClaw 的 cron/job 系统已经在做类似的事情
竞品对比
| OpenClaw | Craft Agents | Claude Code | |
|---|---|---|---|
| 开源 | ✅ | ✅ Apache 2.0 | ❌ 闭源 |
| 界面 | CLI + Gateway | Electron 桌面 | 终端 CLI |
| 底层 | 自有 | Claude Agent SDK | Claude Agent SDK |
| 多提供商 | 多种模型 | 多种模型 | 仅 Anthropic |
| 远程 | ✅ 节点 | ✅ 远程服务端 | SSH |
| Agent Skills | ✅ | ✅ | ✅ |
| 自动化 | cron + 事件 | 事件驱动 | 无 |
七、评分
| 维度 | 评分 | 说明 |
|---|---|---|
| UI 设计 | ⭐⭐⭐⭐⭐ | Craft 出品，UI 品质有保障 |
| 开源质量 | ⭐⭐⭐⭐⭐ | Apache 2.0，完整代码 |
| 架构设计 | ⭐⭐⭐⭐ | 三层 Source + 权限级联 |
| 安装易用性 | ⭐⭐⭐⭐⭐ | 一行命令搞定 |
| 与 Claude Code 兼容 | ⭐⭐⭐⭐⭐ | 同 SDK，可迁移技能 |
| 文档 | ⭐⭐⭐⭐ | 完整但仍在完善 |
| 社区成熟度 | ⭐⭐⭐ | 较新，221 issues |
| 非 macOS 体验 | ⭐⭐⭐ | Craft 生态偏 macOS |
综合评分: 4.3/5
八、总结
Craft Agents 是"更好看的 Claude Code"——同根同源（Claude Agent SDK），但以一个完整的桌面应用形态呈现。
它的核心洞察是对的：Agent 的工作方式天然适合 UI 界面——多任务、后台运行、文件拖放、状态管理——这些都是终端给不了的。Craft （文档公司出身）正好擅长这个。
对于 Claude Code 用户来说，Craft Agents 基本上是"免费升级"：保留所有 Claude Code 能力（MCP、Skills、思考控制），加上 UI 增强、多数据源、自动化。而且开源可定制。
> 一句话：Claude Code 离"人人都能用的 AI Agent"只差一个漂亮界面，Craft Agents 就是这个界面。