DeskClaw(NoDeskAI/nodeskclaw)是一个开源的人机共管运营平台。在这个平台上,人类负责制定策略和派发任务,AI 同事在后台自动执行,所有协作都在可视化的'赛博工作区'中完成。它不是简单的聊天框,而是一块共享的业务看板。
本文将带你用 Docker Compose 在单机上把完整平台跑起来,并演示一个真实场景:让 AI 同事帮你每天自动整理行业情报。
一、整体部署与使用流程
从准备环境到 AI 同事真正干活,完整的链路如下:

后续章节将围绕这张图展开详细操作。
二、项目背景:DeskClaw 解决什么问题?
官方定位是:'人与 AI 共同运营业务的开源平台'。核心概念包括:
- Cyber Workspace(赛博工作区):人和 AI 共享的运营看板,展示团队关系,是业务实际发生的地方。
- Gene System(基因系统):AI 同事的技能包,来自公共市场或私有库,可按需加载组合。
- Elastic Scale(弹性扩缩容):支持在 Kubernetes 或本地 Docker 一键部署扩容 AI 运行实例。
简单说,你定'做什么',AI 同事负责'怎么做',DeskClaw 把两者捏合成一个真正的团队。
三、环境准备:Docker Desktop 是唯一核心
在 Windows 上运行 DeskClaw,最核心的工具就是 Docker Desktop。它会在你的 Windows 上通过 WSL2 虚拟化出一个轻量级的 Linux 内核,用来跑容器。
安装 Docker Desktop
- 访问 Docker 官网下载页面,点击'Download for Windows'下载安装程序。
- 双击运行安装程序,确保勾选'Use WSL 2 instead of Hyper-V'(推荐,性能更好)。安装完成后重启电脑。
- 启动'Docker Desktop'应用,首次启动可能需要几分钟初始化。左下角状态栏显示'Engine running'绿色图标,即表示 Docker 引擎已就绪。
准备代码目录与项目文件
你可以选择两种方式获取代码:
方式一:Git Clone(推荐,方便后续更新)
- 下载并安装 Git for Windows。
- 在电脑上新建一个文件夹,例如
D:\DeskClaw。 - 在该文件夹内右键点击空白处,选择'Open Git Bash here'或'在终端中打开'。
- 输入以下命令克隆项目:
git clone https://github.com/NoDeskAI/nodeskclaw.git
方式二:直接下载 ZIP
- 访问项目 GitHub 主页,点击绿色的'Code'按钮,选择'Download ZIP'。
- 解压到指定目录,例如
D:\DeskClaw\nodeskclaw。
完成后,请确保你的终端当前目录位于 nodeskclaw 文件夹内。
四、一键启动:Docker Compose 部署
启动服务
打开 PowerShell(推荐)或 CMD,切换到项目目录:
cd nodeskclaw
执行一键启动命令:


