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。它通过 WSL2 虚拟化出一个轻量级的 Linux 内核来运行容器。
安装 Docker Desktop
访问 Docker 官网下载页面，点击 Download for Windows 下载安装程序。运行安装程序时，确保勾选 Use WSL 2 instead of Hyper-V，推荐开启以获得更好的性能。安装完成后重启电脑。
启动应用后，左下角状态栏显示 Engine running 绿色图标即表示引擎就绪。
准备代码目录
获取代码有两种方式：
方式一：Git Clone（推荐）
新建文件夹如 D:\DeskClaw，右键选择 Git Bash 打开终端，输入以下命令：
git clone https://github.com/NoDeskAI/nodeskclaw.git
方式二：直接下载 ZIP 访问 GitHub 主页，点击 Code 按钮选择 Download ZIP，解压到指定目录。
完成后，请确保终端当前目录位于 nodeskclaw 文件夹内。
一键启动：Docker Compose 部署
启动服务
切换到项目目录并执行一键启动命令：
cd nodeskclaw
docker compose up -d
这一步会自动拉取 PostgreSQL、Backend、Portal 等镜像并启动容器。首次运行可能需要几分钟下载镜像。
获取初始账号密码
服务启动后，查看日志获取管理员账号：
docker compose logs nodeskclaw-backend --tail 100
在输出中找到类似 Initial admin account 的内容，记下随机生成的密码。登录后系统会强制要求修改密码。
浏览器访问
打开浏览器访问 http://localhost。如果 80 端口被占用，可修改 docker-compose.yml 文件，将 Portal 的端口映射改为其他端口，例如 8080:80，然后访问 http://localhost:8080。
