OpenClaw 接入 QQ 机器人完整指南
项目概述
本指南介绍如何将 OpenClaw 接入 QQ，实现通过 QQ 与 OpenClaw 智能助手对话。
架构说明
[QQ 用户] --> [NapCat QQ 机器人] --> [OpenClaw 星期五]
| | |
(发消息) (OneBot WebSocket) (处理请求)
技术栈
- NapCat: QQ 机器人框架（基于 OneBot v11 协议）
- OpenClaw QQ 插件: OpenClaw 官方 QQ 频道插件
- Docker: NapCat 容器化部署
- Host 网络模式: 解决 WSL2 与 Docker 网络互通问题
环境准备
系统要求
- Linux / WSL2 (Windows Subsystem for Linux)
- Docker 20.10+
- Docker Compose 2.0+
- OpenClaw 2026.2.26+
- Node.js 18+ (OpenClaw 运行环境)
检查环境
确保本地已安装必要工具，执行以下命令验证版本：
docker --version
docker compose version
openclaw --version
node --version
安装 NapCat QQ 机器人
准备部署目录
在宿主机上创建专用目录用于存放 NapCat 配置：
mkdir -p /home/gaof/.openclaw/extensions/qq/deploy/napcat
cd /home/gaof/.openclaw/extensions/qq/deploy/napcat
编写 Docker Compose 配置
新建 docker-compose.yml 文件。注意这里必须使用 network_mode: host，否则在 WSL2 环境下无法正确访问容器网络：
version: "3"
services:
napcat:
environment:
- NAPCAT_UID=${NAPCAT_UID}
- NAPCAT_GID=${NAPCAT_GID}
container_name: napcat
network_mode: host
