基于 Docker 部署开源人机协作平台 DeskClaw

执行一键启动命令：

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 拥有'大脑'。

选择模型服务商（如第三方 MaaS），登录后台获取 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 的设置中配置代理加速。

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

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

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

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