DeskClaw 开源人机协同平台本地部署与实战指南

git clone https://github.com/NoDeskAI/nodeskclaw.git

方式二：直接下载 ZIP

• 访问项目 GitHub 主页：https://github.com/NoDeskAI/nodeskclaw
• 点击绿色的'Code'按钮，选择'Download ZIP'
• 解压到指定目录，例如 D:\DeskClaw\nodeskclaw

完成后，请确保你的终端（PowerShell 或 CMD）当前目录位于 nodeskclaw 文件夹内。

四、一键启动：Docker Compose 部署

步骤 1：启动服务

打开 PowerShell（推荐）或 CMD，切换到项目目录：

cd nodeskclaw

执行一键启动命令：

docker compose up -d

这一步会自动拉取所需镜像（如 PostgreSQL、Backend、Portal 等）并启动容器。首次运行可能需要几分钟下载镜像。

步骤 2：获取初始账号密码

服务启动后，查看日志获取管理员账号：

docker compose logs nodeskclaw-backend --tail 100

在输出日志中找到类似以下内容：

======================================== Initial admin account Account: admin Password: <随机字符串> Please change your password after login ========================================

请务必记下这个密码。

步骤 3：浏览器访问平台

打开你喜欢的浏览器，访问：

http://localhost

如果 80 端口被占用，你可以修改 docker-compose.yml 文件，将 Portal 的端口映射改为其他端口，例如 8080:80，然后访问 http://localhost:8080 。

使用步骤 2 中获取的 admin 账号和密码登录，登录后系统会强制要求修改密码。

五、安装完成后的基本操作

恭喜你，你的'赛博办公室'已经在本地跑起来了。接下来的步骤是'装修办公室'和'招聘员工'：

1. 创建 Cyber Workspace（工作区）：这是你和 AI 团队共享的业务看板。

2. 添加集群。

3. 添加 AI 同事：相当于招聘员工。

4. 配置 LLM（大模型）：让 AI 拥有'大脑'。

我这里使用第三方大模型服务（如 step-3.5-flash），登录之后跟随图片中的步骤一步一步获取 API Key。

然后一一添加进去。

稍微等待一会儿，就会看到我们的第一个员工部署成功了。

下面我们通过一个具体示例来串联这些步骤。

六、实战示例：让 AI 同事每天帮你整理行业情报

场景设定

假设你是一名市场分析师或创业者，每天早上需要：

• 浏览若干行业媒体网站
• 汇总'AI Agent / 大模型应用'相关的最新动态
• 生成一份简报，包含：标题、摘要、来源链接、时间

传统做法是：开 N 个网站 -> 复制粘贴 -> 自己整理，非常耗时。

在 DeskClaw 里，我们可以创建一个'情报收集 AI 同事'，让它每天早上自动干活，你只需要在 Workspace 里看结果。

步骤 1：创建 Cyber Workspace

注：以下步骤为基于官方概念与界面设计的合理推断，具体按钮/菜单名称以实际界面为准。

1. 登录 Portal 后，进入'工作区 / Cyber Workspace'模块。

2. 点击'新建工作区'，例如：

   1. 名称：AI 行业情报站
   2. 说明：每天自动收集 AI 行业动态，生成简报

3. 保存后，你会看到一个'空白'的 Workspace，其中有：

   1. 共享黑板（Blackboard）
   2. 任务看板
   3. AI 同事列表

步骤 2：添加 AI 同事

在 Workspace 中：

1. 点击'添加 AI 同事 / New AI Partner'。
2. 保存后，这个 AI 同事会出现在 Workspace 的拓扑图中，与你形成'协作关系'。

步骤 3：为 AI 同事安装 Gene（技能包）

Gene 是 AI 同事的'能力基因'，例如：

• '网页抓取' Gene
• '文本摘要' Gene
• 'JSON 结构化输出' Gene

在 Portal 的 Gene 市场（或基因库）中，你可以：

1. 搜索类似 web-collector、news-summarizer 的 Gene。
2. 选择一个适合新闻抓取与摘要的 Gene，点击'安装到工作区'。
3. 在 AI 同事的设置中，将这个 Gene 绑定到该同事身上。

具体界面名称可能为'基因库 / GeneHub'或'技能市场'，但逻辑是一致的：从市场安装 Gene，再分配给 AI 同事。

步骤 4：配置大模型（关键！）

AI 同事需要大模型才能思考和总结。在'设置'->'模型配置'中：

1. 选择你的模型服务商。
2. 填入你的 API Key。

3. 保存配置。

步骤 5：派发第一个任务

1. 在工作区的黑板或任务栏，点击'新建任务'。
2. 填写任务描述：

'访问指定行业媒体网站，搜集与 AI 相关的最新文章，生成一份包含标题、摘要、链接的 Markdown 简报，并保存到黑板。'

七、写给 Windows 用户的特别提示

1. 性能考量：虽然 DeskClaw 可以在本地流畅运行，但如果你的任务非常繁重（如同时运行多个 AI 同事处理大量数据），可能会占用较多内存和 CPU。建议电脑至少有 16GB 内存。
2. 数据安全：所有数据都保存在本地 Docker 容器挂载的卷中。如果卸载 Docker Desktop 或删除容器，数据可能会丢失。务必定期备份重要数据。
3. 网络代理：如果你的网络环境访问 Docker Hub 或 GitHub 较慢，可以在 Docker Desktop 的设置中配置代理加速。

小结

本文演示了如何在 Windows 本地搭建 DeskClaw 人机协同工作平台。这不是一个简单的 Demo，而是一个可以随着你的需求不断进化、迭代的操作系统。

你不需要成为技术大牛，也不需要昂贵的服务器，只需一台普通的 Windows 电脑，就能拥有一个永不疲倦、持续进化的 AI 团队。

下一步，试着把你的日常重复性工作，拆解成任务，交给你的 AI 同事吧。