Docker+deepseek云模型本地部署openclaw+接入QQ机器人
docker
请确保电脑上已配置好 Docker 和 Docker Compose。
下载链接： Docker: Accelerated Container Application Development 或 Docker中文网
根据系统选择适用版本，安装步骤可查。
# 检查 Docker 版本
docker --version
# 检查 Docker Compose 版本
docker compose version
配置openclaw需确保 Docker Compose 在v2以上，直接更新到新版即可。
部署Docker
- 创建一个工作目录，命名为openclaw即可，
在该目录下创建文件 .env ,进去后写下以下内容：
VOLC_API_KEY=xxxxxxxx
LARK_APP_ID=xxxxxxx
LARK_APP_SECRET=xxxxxx
注意，此文件里控制API KEY 和 环境变量等，有需要可以修改。
- 创建文件
docker-compose.yml，并填写以下内容：
services:
# --- OpenClaw 主程序 (Gateway) ---
openclaw-gateway:
image: crpi-a1liy20beodq2bdl.cn-beijing.personal.cr.aliyuncs.com/bujic/openclaw:v2026.3.12
container_name: openclaw-main
restart: unless-stopped
init: true
environment:
TZ: Asia/Shanghai
NODE_ENV: production
HOME: /home/node
TERM: xterm-256color
OPENCLAW_GATEWAY_TOKEN: "YOUR_CUSTOM_TOKEN" # 请更换为你的安全Token
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: "true"
PATH: "/home/node/.openclaw/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
VOLC_API_KEY: ${VOLC_API_KEY} #敏感信息采用环境变量注入
LARK_APP_ID: ${LARK_APP_ID}
LARK_APP_SECRET: ${LARK_APP_SECRET}
volumes:
- ./openclaw_data:/home/node/.openclaw
- ./workspace:/home/node/.openclaw/workspace
- /var/run/docker.sock:/var/run/docker.sock
ports:
- "18789:18789"
- "18790:18790"
- "9222:9222" #无头浏览器端口
command: ["node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789"]
# --- 无头浏览器 (Headless Shell) ---
headless-shell:
image: crpi-a1liy20beodq2bdl.cn-beijing.personal.cr.aliyuncs.com/bujic/headless-shell:latest
container_name: headless-shell
network_mode: "service:openclaw-gateway"
restart: unless-stopped
shm_size: "2g"
注意，一定要将 YOUR_CUSTOM_TOKEN 换为自己的安全Token， 并且记住这串字符串，我们需要使用Token访问webUI。
Token生成命令如下:
# 生成 256 位（32 字节）随机 token
openssl rand -hex 32
# 示例输出: a1b2c3d4e5f6...
配置openclaw文件
在openclaw目录下创建子文件夹 openclaw_data，再在openclaw_data目录下创建文件 openclaw.json 。
路径： ./openclaw/openclaw_data/openclaw.json
在openclaw.json文件写以下：
{
"meta": {
"lastTouchedVersion": "2026.3.12"
},
"browser": {
"enabled": true,
"attachOnly": true,
"defaultProfile": "browserless",
"noSandbox": false,
"headless": false,
"ssrfPolicy": {
"dangerouslyAllowPrivateNetwork": true
},
"profiles": {
"browserless": {
"cdpUrl": "http://127.0.0.1:9222",
"color": "#00AA00"
}
}
},
"models": { //这里的模型是deepseek
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "你的api key",
"api": "openai-completions",
"models": [
{
"id": "deepseek-chat",
"name": "DeepSeek V3",
"reasoning": false
}
]
}
}
},
"channels": {
"feishu": {
"enabled": false,
"appId": "${LARK_APP_ID}",
"appSecret": "${LARK_APP_SECRET}",
"connectionMode": "websocket",
"dmPolicy": "allowlist",
"allowFrom": [
"YOUR_USER_ID"
],
"streaming": true,
"footer": {
"elapsed": true,
"status": true
}
}
},
"agents": { //模型
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat"
}
}
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true,
"ownerDisplay": "raw"
},
"gateway": {
"mode": "local",
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true,
"allowInsecureAuth": true,
"dangerouslyDisableDeviceAuth": true
}
},
"plugins": {
"entries": {
"feishu": {
"enabled": false
},
"openclaw-lark": {
"enabled": true
}
},
"installs": {
"openclaw-lark": {
"source": "npm",
"spec": "@larksuite/openclaw-lark",
"installPath": "/home/node/.openclaw/extensions/openclaw-lark",
"version": "2026.3.12",
"resolvedName": "@larksuite/openclaw-lark",
"resolvedVersion": "2026.3.12",
"resolvedSpec": "@larksuite/openclaw-lark@2026.3.12",
"integrity": "sha512-MNcDrerQrO42I09w+M8q6dwnWHMKxOnXSCLG4qNwcekjGeDmA53lIuWJtGMpjTzvDjYkoWnN+8Zg78+FRCSV9w==",
"shasum": "113a4f9e9802fbb6b8c65677f1ede2c36e823a72",
"resolvedAt": "2026-03-13T08:59:23.563Z",
"installedAt": "2026-03-13T08:59:32.378Z"
}
}
}
}
上面两处注释的地方可更改其他模型配置
获取deepseek API KEY:
进入deepseek官网，购买API即可，实验时充3元就够了。
启动与运行
- 启动容器：在openclaw目录下打开终端
#启动
docker compose up -d
#关闭
docker compose down
- 进入 CLI 管理界面： 如果需要使用交互式命令行，可以执行：
# 进入容器内部
docker exec -it openclaw-main /bin/bash
# 交互式设置向导
openclaw configure
- 检查日志：
docker logs -f openclaw-main
- Web登录
http://127.0.0.1:18789/#token=你的安全Token
Token正确后在浏览器中进入网址即可
接入QQ机器人
一、创建qq机器人
点击链接后登录，点击创建机器人
创建后，会有个AppID和AppSecret，这个需要留着。
然后下方有一个安装插件的教程，需要先进入docker容器。
二、安装插件
#docker compose exec 进入docker容器
docker compose exec openclaw-gateway openclaw plugins install @tencent-connect/openclaw-qqbot@latest
三、 配置绑定当前QQ机器人
直接把第2步的命令复制即可，仍然需要进入docker容器
docker compose exec openclaw-gateway openclaw channels add --channel qqbot --token "AppID:AppSecret"
"AppID:AppSecret"里的AppID和AppSecret需要换成自己的。
四、重启本地OpenClaw服务
docker compose exec openclaw-gateway openclaw gateway restart
或
docker compose restart openclaw-gateway
五、验证 QQ 机器人状态
# 查看已配置的渠道
docker compose exec openclaw-gateway openclaw channels list
# 查看日志
docker compose logs -f openclaw-gateway | grep qqbot
参考：
[OpenClaw 容器化部署指南](https://bujic.cc/blogs/OpenClaw 部署指南)
别再花钱买云服务器了！OpenClaw 本地部署保姆级教程，10分钟拥有私人AI助手 - warm3snow - 博客园
浙公网安备 33010602011771号