PilotDeck 使用教程

项目简介

PilotDeck 是一个以「WorkSpace（工作区）」为核心的开源 AI Agent 操作系统，
由清华大学 THUNLP、面壁智能（ModelBest）、OpenBMB 与 AI9Stars 联合开发并开源。
它面向「长周期、多项目」的真实生产力工作场景——当你同时推进很多项目时，把每个项目的文件、记忆、技能彻底隔离开，
让 AI 真正成为一个能长期托管任务、还能在你离线后继续干活的生产力工具。

和 Claude Code / Cursor 这类「一次性编程」、或即问即答的助手不同，PilotDeck 把重心放在
白盒记忆、智能路由、常驻执行三大能力上，原生支持 MCP 协议，并在网页端、命令行、IM（企微 / 飞书）等多端表现一致。

💡
GitHub 地址：
https://github.com/OpenBMB/PilotDeck

官方网站：
https://pilotdeck.openbmb.cn

核心亮点

📊
真实数据：在小红书风格的社媒运营工作流中，开启智能路由后成本从 $12.58 降到 $2.83，
约为原来的 1/5；在 7 个复杂任务评测中，「强主模型 + 轻量子模型」的路由方案以约 1/6 的成本追平甚至超过前沿单模型。

如何使用

方式一：一行命令安装（推荐，macOS / Linux）

curl -fsSL https://raw.githubusercontent.com/OpenBMB/PilotDeck/main/install.sh | bash

脚本会自动安装 Node.js 22、克隆仓库、安装依赖并构建前端。完成后：

pilotdeck            # 启动服务，访问 http://localhost:3001
pilotdeck status     # 查看运行状态

方式二：源码安装（开发者）

git clone https://github.com/OpenBMB/PilotDeck.git
cd PilotDeck
npm install              # 根目录依赖（Gateway 运行时）
cd ui && npm install     # 前端 UI 依赖
cd ..

schemaVersion: 1
agent:
  model: deepseek/deepseek-v4-pro
model:
  providers:
    deepseek:
      protocol: openai
      url: https://api.deepseek.com/v1
      apiKey: sk-your-api-key

cd ui && npm run dev     # 开发模式（HMR），访问 http://localhost:5173
# 或
cd ui && npm run start   # 生产模式，访问 http://localhost:3001

方式三：Docker Compose

docker compose up -d

扩展协议

PilotDeck 采用开放插件架构，核心开源、插件可定制，一个 plugin.json 即可扩展系统：

• MCP Servers —— 一等公民集成任意 Model Context Protocol 服务器
• Tools & Skills —— 注册自定义工具，或通过 ClawHub 拉取社区技能
• Lifecycle Hooks —— 拦截 PreToolUse、UserPromptSubmit 等关键生命周期事件
• Custom Memory —— 接入你自己的记忆存储提供方

常见问题

Q: PilotDeck 和 OpenClaw / Claude Code 有什么区别？

OpenClaw、Claude Code 等更偏「一次性编程」或即问即答；PilotDeck 面向长周期、多项目的生产力工作，强调 WorkSpace 隔离、白盒记忆、智能路由和常驻后台执行，目标是让 AI 长期托管任务并自动落地成果。

Q: 为什么能省 70% 的 token 费用？

靠「智能路由」自动判断任务难度：规划等复杂环节才调用旗舰模型（如 Opus），润色、排版等简单任务自动降级给轻量子模型（如 Sonnet）。社媒运营实测成本约为全程旗舰模型的 1/5，质量基本不打折。

Q: 支持 Windows 吗？

一行命令安装脚本面向 macOS / Linux；Windows 用户可使用源码安装或 Docker Compose 方式运行。

Q: 白盒记忆的「一键回滚」是什么？

PilotDeck 内置 Dream Mode，会在空闲窗口整理/压缩记忆。和黑盒 Agent 压缩后原文即丢失不同，它支持一键回滚到压缩前的状态，记忆全程可审计、可编辑、可固定关键决策。