1. OpenClaw 对接 QQ（qq 账号当机器人使用）
在任意文件夹创建项目文件夹 napcat 及需要的文件夹，并创建 docker-compose.yml
mkdir -p napcat && cd napcat
mkdir -p config .config logs
docker-compose.yml 内容参考
services:
napcat:
image: mlikiowa/napcat-docker:latest
container_name: napcat
restart: unless-stopped
environment:
- NAPCAT_UID=${NAPCAT_UID:-1000}
- NAPCAT_GID=${NAPCAT_GID:-1000}
- MESSAGE_POST_FORMAT=string
- HTTP_ENABLE=true
- HTTP_HOST=0.0.0.0
- HTTP_PORT=3000
- WS_ENABLE=true
- WS_HOST=0.0.0.0
- WS_PORT=3001
ports:
- "3000:3000"
- "3001:3001"
- "6099:6099"
volumes:
- ./config:/app/napcat/config
- ./.config:/app/.config/QQ
- ./logs:/app/napcat/logs
stdin_open: true
tty: true
启动 docker，并执行以下命令
NAPCAT_UID=$(id -u) NAPCAT_GID=$(id -g) docker-compose up -d
| 命令拆解 | 含义 |
|---|---|
NAPCAT_UID=$(id -u) | 设置环境变量 NAPCAT_UID 为当前用户的用户 ID |
NAPCAT_GID=$(id -g) | 设置环境变量 NAPCAT_GID 为当前用户的组 ID |
docker-compose up -d | 在后台启动 Docker Compose 服务 |
因为 NapCat 容器内以 NAPCAT_UID 用户运行，需要与宿主机用户权限匹配，所以动态获取当前用户 ID，环境变量传递给 Docker Compose。
启动完成
执行 docker-compose logs -f，手机 qq 扫描登录日志的二维码登录
也可以根据日志的 token 打开 http://127.0.0.1:6099/webui?token=你的 token，输入账号和密码
如果提示需要验证码，暂时不支持的话就扫码登录，登录后只要日志没有显示离线就可以退出手机 qq
点击网络配置，添加 http server（可选）和 websocket server
复制 websocket server 的 token
两个插件选一个即可，建议用 openclaw_qq，因为目前 @izhimu/qq 插件似乎群里有人发消息就一定会回复且不支持/model 等命令（可能要自己研究怎么配置或修改源码？），而 openclaw_qq 在群@机器人的名字或设置关键词触发。
插件 1（推荐）：
在另一个终端执行 cd ~/.openclaw/extensions && git clone https://github.com/constansino/openclaw_qq.git qq 命令给 openclaw 安装插件，然后执行 cd ~/.openclaw/extensions/qq && pnpm install 2>&1 | tail -20 编译安装。
插件 2：
执行 pnpm openclaw plugins install @izhimu/qq 给 openclaw 安装插件，如果你的 openclaw 不是通过 pnpm 安装则去掉 pnpm，下同。
输入 pnpm openclaw gateway restart 重启，然后打开 http://127.0.0.1:18789/channels，粘贴 websocket 的 token，点击保存，过一会看到 yes 即成功连接
如果 qq 机器人回复出现 Connection error（这里已经换成小号当 QQ 机器人，防止主号乱发消息被封），去用户目录的.openclaw 里，比如/Users/Zhuanz/.openclaw，打开 openclaw.json，找到 channels，再找 qq，将 enable 改为 true；如果还是这样，看看 agents.defaults.model.primary 是不是本地 ollama 模型且此时没启动 ollama（注意在网页或 tui 输入/model 等命令要在对应的 qq 聊天 session 执行才对 qq 机器人有效）
之后执行 pnpm openclaw gateway restart 或其他命令重启，测试效果，如果你的 openclaw 不是通过 pnpm 安装则去掉 pnpm，下同
用 @izhimu/qq 插件的情况
已经成功回复，但如果是用 @izhimu/qq 插件不会对聊天中直接发/model 等命令执行且给结果，只有让对话中强调执行这个命令才有效，但在 openclaw_qq 可以直接执行命令给结果（下图）
openclaw_qq 配置参考
插件功能差异对比（原因：目前这个 QQ 插件缺少 CommandAuthorized 参数）
| 插件 | finalizeInboundContext 参数 | 命令支持 |
|---|---|---|
| 飞书 | 包含 CommandAuthorized: commandAuthorized | ✅ 支持 |
| 缺乏 CommandAuthorized 参数 | ❌ 不支持 |
两个 QQ 插件功能对比
1）配置项对比
| 功能 | @izhimu/qq | openclaw_qq | 说明 |
|---|---|---|---|
| wsUrl | ✅ | ✅ | WebSocket 地址 |
| accessToken | ✅ | ✅ | 访问令牌 |
| enable | ✅ | ❌ | 启用开关 |
| requireMention | ❌ | ✅ 默认 true | 群聊需要 @ 才触发 |
| keywordTriggers | ❌ | ✅ | 关键词唤醒 |
| admins | ❌ | ✅ | 管理员列表 |
| adminOnlyChat | ❌ | ✅ | 仅管理员可触发 |
| allowedGroups | ❌ | ✅ | 群白名单 |
| blockedUsers | ❌ | ✅ | 用户黑名单 |
| systemPrompt | ❌ | ✅ | 自定义人设 |
| historyLimit | ❌ | ✅ | 历史消息注入 |
| autoApproveRequests | ❌ | ✅ | 自动通过好友 / 群邀请 |
| enableTTS | ❌ | ✅ | 语音回复 |
| enableGuilds | ❌ | ✅ | QQ 频道支持 |
| rateLimitMs | ❌ | ✅ 默认 1000ms | 发送限速防风控 |
| antiRiskMode | ❌ | ✅ | URL 风控规避 |
| maxMessageLength | ❌ | ✅ 默认 4000 | 消息分片 |
| formatMarkdown | ❌ | ✅ | Markdown 转纯文本 |
| showProcessingStatus | ❌ | ✅ | 群名片显示 "输入中" |
| sharedMediaHostDir | ❌ | ✅ | 跨容器媒体共享 |
2）核心功能差异
| 功能 | @izhimu/qq | openclaw_qq | 原因 |
|---|---|---|---|
| 群聊 @ 触发 | ❌ 所有消息都回复 | ✅ 默认仅 @ 触发 | 新插件有 requireMention 配置 |
| 关键词唤醒 | ❌ | ✅ 如 "小助手" | 新插件有 keywordTriggers |
| 管理员命令 | ❌ | ✅ /model, /status 等 | 新插件实现了命令处理 |
| /model 命令 | ❌ | ✅ 仅管理员 | 新插件支持模型切换 |
| 群白名单 | ❌ | ✅ | 新插件有 allowedGroups |
| 用户黑名单 | ❌ | ✅ | 新插件有 blockedUsers |
| 风控优化 | ❌ | ✅ 限速、URL 规避 | 新插件针对 QQ 风控设计 |
| 戳一戳响应 | ❌ | ✅ | 新插件处理 poke 事件 |
| 自动通过请求 | ❌ | ✅ | 新插件有 autoApproveRequests |
| 消息去重 | ❌ | ✅ | 新插件有 enableDeduplication |
| 空回复兜底 | ❌ | ✅ | 新插件有 enableEmptyReplyFallback |
2. 自定义域名发送邮件
打开 https://resend.com/signup 注册，密码需要至少 12 位，注册完需去邮箱验证
打开邮箱进行验证
添加 API key，并复制
查找能发邮件的 skills（find-skills 安装需自行查阅文档）
可执行 npx skills add resend/resend-skills@send-email -g -y 安装
测试成功，默认只能发注册 resend 账户的邮箱，要发送任意邮箱需添加域名
添加自己的域名，地区随便选，然后点击 Add domain
点击允许接收，再点击添加记录
需要添加的全部记录清单
从这个界面可以看到需要添加以下记录：
| 类型 | 主机记录（Name） | 记录值（Content） | 优先级 | 用途 |
|---|---|---|---|---|
| TXT | resend._domainkey | p=MIGfMA0GCSqG[...] | - | DKIM 签名（必需） |
| MX | send | feedback-smtp.[...]amazonses.com | 10 | 退信处理（必需） |
| TXT | send | v=spf1 include[...]nses.com ~all | - | SPF 验证（必需） |
| TXT | _dmarc | v=DMARC1; p=none; | - | DMARC 策略（可选但强烈建议） |
| MX | @ | inbound-smtp.e[...]amazonaws.com | 10 | 接收邮件（可选，如果你不需要收邮件可以不填） |
以阿里云为例
验证通过，由 Pending 变成 Verified
成功接收邮件
