跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashSaaSAI

基于 Docker 部署 DeskClaw 人机协同办公平台

DeskClaw 是一款开源的人机共管运营平台，支持在单机通过 Docker Compose 快速部署。文章演示了从安装 Docker Desktop、克隆项目代码、启动服务到配置大模型及创建任务的全流程。用户可构建 Cyber Workspace，添加 AI 同事并分配技能包，实现自动化行业情报整理等场景，无需昂贵服务器即可拥有持续进化的 AI 团队。

XiaoPingzi发布于 2026/4/5更新于 2026/9/871 浏览
基于 Docker 部署 DeskClaw 人机协同办公平台

DeskClaw（NoDeskAI/nodeskclaw）是一个开源的人机共管运营平台：

人在上面定策略、派任务，AI 同事在后台不停干活，所有协作都在一个可视化的'Cyber Workspace'里完成——不是简单的聊天框，而是一块共享的业务看板。

这篇文章会带你用 Docker Compose 在单机上把完整平台跑起来，并演示一个真实场景：

'让 AI 同事帮你每天自动整理行业情报'。

一、整体部署与使用流程

下面这张流程图，是从'准备服务器'到'AI 同事真正干活'的完整链路：

文章配图

后面所有章节，都是围绕这张图展开的详细操作。

二、项目背景：DeskClaw 在解决什么问题？

官方对 DeskClaw 的定位很清晰：

'The open-source platform where humans and AI run businesses together — from strategy to execution.'

核心几个概念：

  • Cyber Workspace（赛博工作区） 人和 AI 共享的运营看板，六边形拓扑展示团队关系，共享'黑板'和任务委派，是业务实际发生的地方。

  • Gene System（基因系统） 可以理解为'AI 同事的技能包'，来自公共市场或企业私有库，可按需加载、组合、持续进化。

  • Elastic Scale（弹性扩缩容） 支持在 Kubernetes 或本地 Docker 一键部署/扩容 AI 运行实例，平台帮你搞定基础设施，你专注运营决策。

简单说：

你定'做什么'，AI 同事负责'怎么做'，DeskClaw 把两者捏合成一个真正的团队。

三、环境准备：Docker Desktop 是唯一核心

在 Windows 上运行 DeskClaw，最核心的工具就是 Docker Desktop。它会在你的 Windows 上通过 WSL2（Windows Subsystem for Linux）虚拟化出一个轻量级的 Linux 内核，用来跑容器。

步骤 1：安装 Docker Desktop
  1. 下载安装包 访问 Docker 官网下载页面：https://www.docker.com/products/docker-desktop/ 点击'Download for Windows'下载安装程序。

文章配图

  1. 安装与配置 双击运行安装程序，确保勾选 'Use WSL 2 instead of Hyper-V'（推荐，性能更好）。 安装完成后，重启电脑。
  2. 启动与验证 重启后，启动'Docker Desktop'应用。首次启动可能需要几分钟初始化。 左下角状态栏显示 'Engine running' 绿色图标，即表示 Docker 引擎已就绪。

文章配图

步骤 2：准备代码目录与项目文件

你可以选择两种方式获取代码：

方式一：Git Clone（推荐，方便后续更新）

  • 下载并安装 Git for Windows（如果尚未安装）：https://git-scm.com/download/win
  • 在电脑上新建一个文件夹，例如 D:\DeskClaw
  • 在该文件夹内右键点击空白处，选择'Open Git Bash here'或'在终端中打开'
  • 输入以下命令克隆项目：
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 团队共享的业务看板。

文章配图

  1. 添加集群。

文章配图

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

文章配图

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

文章配图

配置大模型 API Key，例如使用主流 MaaS 服务，登录之后跟随图片中的步骤一步一步获取 api。

文章配图

然后一一添加进去。

文章配图

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

文章配图

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

六、实战示例：让 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。

文章配图

  1. 保存配置。

文章配图

步骤 5：派发第一个任务
  1. 在工作区的黑板或任务栏，点击'新建任务'。
  2. 填写任务描述：

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

文章配图

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

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

小结：从'试玩 Demo'到'真正做事'

今天，我们只用了几分钟，就在 Windows 本地搭建起了一个真正的'人机协同工作平台'。这不是一个简单的 Demo，而是一个可以随着你的需求不断进化、迭代的操作系统。

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

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

目录

  1. 一、整体部署与使用流程
  2. 二、项目背景：DeskClaw 在解决什么问题？
  3. 三、环境准备：Docker Desktop 是唯一核心
  4. 步骤 1：安装 Docker Desktop
  5. 步骤 2：准备代码目录与项目文件
  6. 四、一键启动：Docker Compose 部署
  7. 步骤 1：启动服务
  8. 步骤 2：获取初始账号密码
  9. 步骤 3：浏览器访问平台
  10. 五、安装完成后的基本操作
  11. 六、实战示例：让 AI 同事每天帮你整理行业情报
  12. 场景设定
  13. 步骤 1：创建 Cyber Workspace
  14. 步骤 2：添加 AI 同事
  15. 步骤 3：为 AI 同事安装 Gene（技能包）
  16. 步骤 4：配置大模型（关键！）
  17. 步骤 5：派发第一个任务
  18. 七、写给 Windows 用户的特别提示
  19. 小结：从“试玩 Demo”到“真正做事”

更多推荐文章

查看全部
  • 链表数据结构详解：结构、操作与应用
  • 从三年前端到 CS 硕士：在韩国亚大读研的收获与反思
  • 利用 AI Ping 统一接口降低大模型成本并优化选型效率
  • 预训练语言模型与 BERT 实战应用详解
  • 大模型 NLP 开发：行业趋势、核心技能与学习路径
  • Microi 吾码低代码平台技术架构与集成实践
  • AI 赋能产品经理：工作流提效与职业转型实战
  • MC.JS WEBMC1.8 实战：构建在线多人沙盒游戏
  • Kimi2.5 核心技术：注意力残差
  • Java MD5 加密算法原理与实现
  • 双指针算法：快慢指针判断快乐数
  • 前端错误处理实战：try/catch 与 Promise 用法
  • 大模型后处理校准方法：RARR、CRITIC 与 PURR 解析
  • 大模型方向产品经理面试经验与答案解析
  • GitCode 克隆代码认证失败，需改用个人访问令牌或 SSH
  • C++ 哈希表核心机制：unordered 系列容器、位图与布隆过滤器实战
  • CentOS 7 安装 Nginx
  • 基于 Web 的远程文件管理系统设计与实现开题答辩记录
  • EgoPoseFormer v2：AR/VR 第一视角人体动作捕捉技术解析
  • Diffusion Transformer (DiT) 详解：从 U-Net 到 ViT，应用于视频生成与机器人动作预测

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

  • Markdown转HTML

    将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online