1分钟速建QQ机器人,OpenClaw轻松对接
摘要:QQ机器人可通过开放平台快速创建,1分钟内完成与OpenClaw的对接,支持多媒体消息收发。OpenClaw提供三种安装方式(一键脚本、Docker、源码编译),推荐Docker部署,需Node.js≥v22和4GB+内存(复杂场景建议16GB+)。安装后可通过3000端口访问网关,18789端口管理面板。验证服务正常后即可使用,支持云端或本地模型部署。(149字)
·

2.登录后,点击“创建机器人”选项,点击一次即可快速生成一个新的机器人账号

3.创建机器人后,QQ 开放平台会直接提供 3 条预设指令,用户只需在安装了 OpenClaw 的设备上执行这些指令,即可完成机器人与 OpenClaw 的对接。整个过程可在 1 分钟内实现。
openclaw plugins install @sliverp/qqbot@latest openclaw channels add --channel qqbot --token "123456AbCD:aBcdEfG"(改成你自己的) openclaw gateway restart
4.绑定至 OpenClaw 环境后即可通过 QQ 机器人给 OpenClaw 下达指令;支持 Markdown、图片、语音、文件等多媒体消息收发,手机端 QQ、桌面端 QQ 均可使用。
OpenClaw(小龙虾)官方给出的内存要求如下:
- 最低内存:2GB(仅满足基础运行)
- 推荐内存:4GB(日常使用更流畅)
不同场景的内存建议
- 仅基础网关 / 云 API 模式:最低 4GB 即可。
- 日常使用 + 多插件:推荐 16GB,多任务与 Docker 环境更稳定。
- 本地大模型 + 复杂自动化:建议 32GB+,运行更流畅。
- 手机端部署:建议 4GB+ 内存。
OpenClaw(小龙虾)提供三种主流安装方式,按 “新手友好度” 排序:一键脚本(最快)、Docker 容器(最稳,适合生产 / 隔离)、源码编译(适合开发定制)。结合你的技术背景(本地部署、Docker 经验),优先推荐 Docker 部署;新手则选一键脚本。
前置准备(所有方式必做)
| 依赖项 | 版本要求 | 验证命令 | 安装要点 |
|---|---|---|---|
| Node.js | ≥ v22.0.0(LTS) | node -v |
安装时勾选 Add to PATH;Windows 建议用 WSL2 |
| 内存 | 最低 4GB,推荐 16GB+ | — | 本地大模型需 32GB+ |
| 硬盘 | ≥ 10GB 空闲 | — | 容器 / 源码需额外空间 |
| Docker | Engine ≥ 20.10(仅 Docker 方式) | docker -v |
Windows 用 Docker Desktop,启用 WSL2 后端 |
方式一:一键脚本(新手 / 快速试用,5 分钟搞定)
Windows(PowerShell 管理员)
- 安装 Node.js v22 LTS(https://nodejs.org/),勾选 Add to PATH。
- 以管理员打开 PowerShell,执行:
iwr -useb https://openclaw.ai/install.ps1 | iex - 安装完成后,启动初始化向导:
openclaw onboard --install-daemon - 启动服务:
openclaw start
macOS / Linux(终端)
- 安装 Node.js v22(macOS 用
brew install node,Linux 用 Nodesource 脚本)。 - 执行一键安装:
curl -fsSL https://openclaw.ai/install.sh | bash - 初始化并启动:
openclaw onboard --install-daemon && openclaw start
方式二:Docker 部署(推荐生产 / 隔离,环境干净)
1. 安装 Docker 环境
- Windows:安装 Docker Desktop,在设置中启用 WSL2 后端。
- Linux:
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun systemctl start docker && systemctl enable docker - macOS:用 Homebrew 安装
brew install --cask docker,启动并登录。
2. 快速启动(单容器)
# 拉取最新镜像
docker pull openclaw/openclaw:latest
# 启动容器(持久化配置,映射 3000 端口)
docker run -d \
--name openclaw \
-p 3000:3000 \
-v ~/.openclaw:/root/.openclaw \
--restart unless-stopped \
openclaw/openclaw:latest
3. 进阶:Docker Compose(推荐,便于管理)
- 创建目录并进入:
mkdir -p ~/openclaw && cd ~/openclaw - 创建
docker-compose.yml:version: '3.8' services: openclaw: image: openclaw/openclaw:latest container_name: openclaw ports: - "18789:18789" # 管理面板端口 - "3000:3000" # 网关端口 volumes: - ./data:/app/data - ./config:/app/config - ~/.openclaw:/root/.openclaw environment: - NODE_ENV=production - TZ=Asia/Shanghai restart: unless-stopped - 启动并验证:
docker-compose up -d docker-compose ps # 状态为 Up 即成功 docker logs -f openclaw # 查看日志排查问题
方式三:源码编译(开发者 / 二次开发)
- 安装依赖:
npm install -g pnpm # 强制推荐 pnpm,避免 npm 依赖问题 git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm config set registry https://registry.npmmirror.com # 国内加速 - 安装并构建:
pnpm install pnpm ui:build # 编译前端 UI pnpm build # 编译后端 - 初始化并启动:
pnpm openclaw onboard --install-daemon pnpm gateway:watch # 开发模式,自动重载
核心配置与启动验证
1. 初始化向导(openclaw onboard)关键选项
- 模型提供商:新手选 “云端体验”(如 Kimi、OpenAI),本地部署选 “本地模型”(需 LM Studio 配合)。
- 端口设置:默认 3000(网关)、18789(管理面板),确保防火墙放行。
- 登录密码:设置强密码,防止未授权访问。
2. 验证服务
- 浏览器访问:
http://localhost:3000或http://服务器IP:18789。 - 终端执行:
curl http://localhost:3000/api/v1/health,输出{"status":"healthy"}即正常。
更多推荐



所有评论(0)