Docker 部署私人 AI 电脑助手 Moltbot

因为 Moltbot 的权限很高，对运行的主机而言，存在文件误删等风险，所以建议用 docker 部署，可以把权限关在笼子里。虽然自主性可能会受限，需要手动确认某些操作，但好处是作为 NAS 用户，不用再单独去购买 Mac mini 或 VPS。

目前最推荐的方式是使用官方镜像配合 docker-compose 进行部署。

准备工作

• 一台支持 Docker 的机器（NAS、服务器、PC）
• Docker + Docker Compose 已安装
• 建议提前准备好大模型的 API Key：Claude / MiniMax 等的 API Key（至少一个）

创建目录

通过 SSH 登录到您的服务器，执行下面的命令创建目录：

# 新建文件夹 moltbot 和子目录
mkdir -p /data/docker/moltbot/{config,data}
# 进入 moltbot 目录
cd /data/docker/moltbot
# 确保权限正确（node 用户 UID 1000）
chown -R 1000:1000 {config,data}

创建 docker-compose.yml

将以下内容保存为 docker-compose.yml 文件：

version: '3.8'
services:
  moltbot-gateway:
    image: ghcr.io/moltbot/moltbot:main
    container_name: moltbot-gateway
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./config:/home/node/.clawdbot
      - ./data:/home/node/clawd
    environment:
      - HTTP_PROXY=http://<proxy_ip>:<proxy_port>
      - HTTPS_PROXY=http://<proxy_ip>:<proxy_port>
      - NO_PROXY="localhost,127.0.0.1,::1"
    shm_size: 2g
    command: node /app/dist/index.js gateway --port 18789
  
  moltbot-cli:
    image: ghcr.io/moltbot/moltbot:main
    container_name: moltbot-cli
    network_mode: "service:moltbot-gateway"
    volumes:
      - ./config:/home/node/.clawdbot
      - ./data:/home/node/clawd
    entrypoint: ["node", "dist/index.js"]

moltbot-gateway 容器参数说明

• 关于挂载目录，因为 Clawdbot 之前改名为了 Moltbot，使用 /home/node/.clawdbot，容器中有提示要改为 /home/node/.moltbot，但是真用 /home/node/.moltbot，在执行 onboarding 时又无法生成 moltbot.json；
• 环境变量中的网络代理设置是非必须的，主要解决跟国外的聊天软件的联通问题，如果你用国内的飞书等，可以不需要设置；

moltbot-cli 容器参数说明

• 网络模式非常重要，也是最关键的，代码中似乎使用硬编码，在连接 moltbot-gateway 时，用的地址是 127.0.0.1，只有设置了 network_mode: "service:moltbot-gateway"，才能共享 moltbot-gateway 容器的网络栈和端口；
• 挂载目录需要和 moltbot-gateway 保持一致；

首次运行 onboarding

# 运行设置
docker compose run --rm -it moltbot-cli onboard

交互向导出现后，按提示完成，会在 config 目录中生成 moltbot.json 设置文件。

第一步的 I understand this is powerful and inherently risky. Continue? 必须选择 Yes。

Onboarding mode 可以选择 QuickStart。

接下来选择模型，免费额度用于测试应该是可以的。

验证方式用了 OAuth。

稍等一会儿会出现一个链接，将其复制到浏览器中，用自己的账号登录。

验证通过后，选中模型，默认的就可以。

接下来选择通信软件，填入对应的 Bot Token。

1. 在 Telegram 里搜索 @BotFather
2. 给它发送 /newbot
3. 给你的机器人起个名字（随便起，好记就行）
4. 把 BotFather 给你的 token 复制下来
5. 回到 SSH 终端，粘贴这个 token

接下来会设置 skills 和 hooks。可以先跳过，后面随时可以加。

看到 Onboarding complete. 就设置完成了。

启动 gateway 服务

设置完成后，就可以启动 gateway 服务：

# 启动 gateway 服务
docker-compose up -d moltbot-gateway

使用

上一步的 onboarding 设置中，会看到 Dashboard 的地址。

如果访问 http://<your_nas_ip>:18789/?token=<your token>，页面会显示错误 disconnected (1008): control ui requires HTTPS or localhost (secure context)。

反代

建议使用反向代理方案实现外网访问。

在反向代理中的设置如下：

还需要将下面的代码填入到反向代理的 Advanced 中：

location /telegram-webhook {
  proxy_pass http://<your_nas_ip>:18789//telegram-webhook;
  proxy_method POST;
  proxy_set_header Content-Type $content_type;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header Host $host;
}

修改 moltbot.json

现在访问 https://<your_domain>/?token=<your token>，如果显示需要配对 disconnected (1008): pairing required。

需要给 moltbot.json 增加写权限，否则修改不会生效。

需要给 moltbot.json 加一行 "trustedProxies": [<your_proxy_container_ip>, <your_host_ip>]，也就是受信任的地址，需要考虑整个链路上的 IP，可能包括：

• moltbot-gateway 的 IP
• 反向代理容器的 IP
• 家宽的公网 IP 等；

当然最好的办法还是查看 moltbot-gateway 容器的日志，看看哪个地址不受信任。

访问 Web 控制台（Control UI）

现在访问 https://<your_domain>/?token=<your token>。

显示需要配对。

回到 SSH 客户端列出设备：

# 列出当前已配对和待配对的设备
docker-compose run --rm moltbot-cli devices list

通过命令批准配对：

# 批准配对
docker-compose run --rm moltbot-cli devices approve <Request-ID>
# 实例
docker-compose run --rm moltbot-cli devices approve b332768e-cff3-437d-a1f8-262a51fcb0eb

如果觉得麻烦，可以修改 moltbot.json 改为自动批准，但不推荐。

{"gateway":{"deviceApproval":{"mode":"auto"}}}

现在就可以开始聊天了。

在 Telegram 中使用

onboarding 向导设置时已经选择了 Telegram，但是向机器人发 /start，并没有得到回应，既然网页已经 OK 了，可以让 Moltbot 自己解决。

最后发现还是网络问题，所以在 moltbot.json 中增加了代理服务地址设置：

"channels":{"telegram":{"enabled":true,"botToken":"你的 TG_BOT_TOKEN","dmPolicy":"pairing","groupPolicy":"allowlist","streamMode":"partial","network":{"autoSelectFamily":true},"proxy":"http://<proxy_ip>:<proxy_port>"}},

再次发送 /start，就获得了回应，得到了配对码。

回到 SSH 客户端批准配对：

# 批准配对
docker-compose run --rm moltbot-cli pairing approve telegram <code>

完成配对之后，就可以开始工作了。

在网页端能同步可以看到相同的内容。

结语

Moltbot 是目前最接近「把大模型变成电脑遥控器」的开源项目之一。

Docker 部署方式让它门槛大幅降低，但真正发挥威力还需要你不断调教模型、渠道、工具权限。

希望这套流程能帮助你快速上手。祝你玩得开心，AI 助你事半功倍！

参考文档

moltbot/moltbot: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
地址：https://github.com/moltbot/moltbot

Moltbot — Personal AI Assistant
地址：https://www.molt.bot/

Docker - Moltbot
地址：https://docs.molt.bot/install/docker