OpenClaw 配置 NapCat 实现主动发送 QQ 消息教程 – 紫灵的小屋

OpenClaw 配置好 NapCat 后，可以正常接收 消息并进行回复，但无法主动发送消息到 群或私聊。

注意：当前问题前提是已成功配置openclaw接入。

表现为：

环境说明

– OpenClaw: 2026.2.2-3

– NapCat: 4.15.4 (OneBot 11)

– Windows: NapCat 运行在 Windows 上

– WSL2: OpenClaw 运行在 WSL2 中

网络架构：

“`

Windows (NapCat) → ws://172.18.208.1:3001 → OpenClaw (WSL2)

OpenClaw (WSL2) → http://172.18.208.1:3000 → NapCat (HTTP API)

“`

> 注意：`172.18.208.1` 是本教程中 WSL2 虚拟网络中 Windows 主机的 IP 地址。

> – 如果你用 WSL2：这个地址通常是自动生成的，通过 `cat /etc/resolv.conf | grep nameserver` 查看

> – 如果你用 Docker：Windows 的地址可能是 `host.docker.internal` 或 `172.17.0.1`

> – 如果你用虚拟机（VM）：需要配置虚拟机的端口转发或使用桥接网络

> – 如果你在同一台机器上直接安装：可以直接用 `localhost` 或 `127.0.0.1`

—

问题诊断过程

1. 测试基本连接

首先确认 OpenClaw 跟 NapCat 的基本连接是否正常：

确认 NapCat channel 状态为 `OK`。

2. 测试被动回复

在 群或私聊发送消息，确认 OpenClaw 能正常接收和回复。这一步通常是成功的，说明 WebSocket 接收通道正常。

3. 测试主动发送

现象：命令显示”发送成功”，但 群里没有收到消息。

4. 检查 NapCat 配置

查看 NapCat openclaw docker 教程 的 OneBot 11 配置文件（Windows 上）：

关键问题：配置中 `httpServers: []` 为空，没有启用 HTTP 服务器

5. 启用 NapCat HTTP 服务器

修改 NapCat 配置，添加 HTTP Server：

6. 测试 HTTP API

> IP 地址说明：如果你的 OpenClaw 和 NapCat 不在同一台机器上，或者你没用 WSL2，请把 `172.18.208.1` 替换为 NapCat 运行机器的实际 IP：

> – 同一机器直接运行：用 `127.0.0.1` 或 `localhost` 即可

> – WSL2: 用 `cat /etc/resolv.conf | grep nameserver` 获取

> – Docker: 用 `host.docker.internal` 或 Docker 网关 IP

> – 虚拟机/其他：配置好网络互通后使用实际 IP

如果成功返回 `{“status”:”ok”,”data”:{“message_id”:xxx}}`，说明 NapCat HTTP API 正常工作。

7. 配置 OpenClaw NapCat Channel

问题是 OpenClaw 的 NapCat extension 需要额外的配置。查看 OpenClaw 源码（如果自定义了 extension）找到需要的配置字段。

编辑 `~/.openclaw/openclaw.json`：

关键字段说明：

– `.wsUrl`: WebSocket 地址，用于接收消息

– `.accessToken`: NapCat WebSocket 鉴权 token

– `napcat.url`: NapCat HTTP API 地址（这是关键！）

– `napcat.enableGroupMessages`: 启用群聊消息处理

– `napcat.groupMentionOnly`: 是否只在被@时响应（建议 false，方便测试）

8. 重启 OpenClaw Gateway

9. 验证功能

测试发送到群：

测试发送到私聊：

NapCat OneBot 11 配置

文件路径：`E:…configonebot11_.json`

OpenClaw 配置

文件路径：`~/.openclaw/openclaw.json`

常见问题

Q1: 修改配置后不生效？

原因：NapCat 或 OpenClaw 可能缓存了旧的配置。

解决方法：

1. NapCat: 完全退出后重新启动

2. OpenClaw: 运行 `openclaw gateway restart`

Q2: `fetch failed` 错误

原因：OpenClaw 找不到 NapCat channel 配置。

解决方法：确认 `openclaw.json` 中有 `channels.napcat.url` 字段。

总结

要实现 OpenClaw 主动发送 消息，需要：

1. NapCat 启用 HTTP 服务器（端口 3000）

2. OpenClaw 配置 `channels.napcat.url`

3. 确保网络互通（WSL2 和 Windows 之间）

4. 重启 NapCat 和 OpenClaw Gateway

配置完成后，就可以通过命令行、API 或 agent 主动向 群或私聊发送消息了

参考资料

– [OpenClaw 官方文档](https://docs.openclaw.ai)

– [OneBot 11 标准](https://github.com/botuniverse/onebot-11)

– [NapCat GitHub](https://github.com/NapNeko/NapCat)