1）NapCat → OpenClaw#

NapCat 通过反向 WebSocket把 QQ 收到的消息推送给 OpenClaw。

也就是说，NapCat 需要连接：

1
ws://192.168.2.116:18800

这里的重点是：18800 通常由 OpenClaw 监听。

2）OpenClaw → NapCat#

OpenClaw 通过 HTTP API 主动调用 NapCat，完成发消息、查信息等动作。

也就是说，OpenClaw 需要访问：

1
http://192.168.2.160:3000

这里的重点是：3000 通常由 NapCat 的 HTTP API 监听。

1. 开启 HTTP Server#

NapCat 必须开启 HTTP API，不然 OpenClaw 没法主动发消息。

1
{
2
  "network": {
3
    "httpServers": [
4
      {
5
        "enable": true,
6
        "host": "0.0.0.0",
7
        "port": 3000,
8
        "accessToken": "YOUR_TOKEN_HERE"
9
      }
10
    ]
11
  }
12
}

1
"host": "localhost"

2. 配置反向 WebSocket#

NapCat 还需要把收到的 QQ 消息主动推给 OpenClaw。

1
{
2
  "reverseWs": {
3
    "enable": true,
4
    "urls": ["ws://192.168.2.116:18800"]
5
  }
6
}

httpApi#

NapCat 的 HTTP API 地址，OpenClaw 用它主动发消息。

accessToken#

NapCat 的 HTTP token。两边不一致，轻则报错，重则你以为自己配对了其实啥也没通。

selfId#

机器人自己的 QQ 号。填错了，群里 @机器人 识别就容易抽风。

dmPolicy#

私聊策略。常见有：

• allowlist：只允许白名单私聊
• open：任何人都能私聊触发
• disabled：禁用私聊

allowFrom#

允许私聊触发 AI 的 QQ 号列表。

groupPolicy#

群聊访问策略。常见有：

• allowlist：只允许指定群触发
• open：任何群都能触发
• disabled：禁用群聊

groupAllowFrom#

允许触发 AI 的群号列表。

tools.profile = full#

这个很重要。OpenClaw 默认 profile 可能会把大量 qq_* 工具过滤掉，结果就是：你以为机器人傻，其实是工具压根没放出来。

1. allowFrom 写成一个字符串#

错误示例：

1
"allowFrom": ["2845168040,18563867,1304077157"]

这不是三个 QQ 号，而是一整坨字符串。

正确写法应该是：

1
"allowFrom": ["2845168040", "18563867", "1304077157"]

这一点特别蠢，但真有人天天中招。

2. NapCat 的 HTTP Server 绑了 localhost#

如果你在 NapCat WebUI 里看到：

• host = localhost

那就说明 HTTP API 只对本机开放，异机部署当然连不上。

3. 把 18800 当成 NapCat 的服务端口#

在官方插件这套架构里，通常是：

• 3000：NapCat 的 HTTP API
• 18800：OpenClaw 的 WebSocket 监听口

别把方向搞反，不然你测一百遍也只会得到同一个报错。

4. 混用旧教程字段#

网上有些旧教程会写：

1
"channels": {
2
  "qq": {
3
    "wsUrl": "...",
4
    "httpUrl": "...",
5
    "apiUrl": "..."
6
  },
7
  "napcat": {
8
    "url": "..."
9
  }
10
}

这大概率不是当前 @hyl_aa/napcat 官方插件的配置方式。

如果你已经决定走官方插件，就优先使用：

• channels.napcat.httpApi
• channels.napcat.accessToken
• channels.napcat.selfId
• tools.profile = full

别把新旧教程拼一块，拼出来的通常不是教程，是事故现场。

A. 在 NapCat 机器上检查 HTTP API#

1
curl http://127.0.0.1:3000/get_version_info
2
curl http://192.168.2.160:3000/get_version_info
3
lsof -nP -iTCP:3000 -sTCP:LISTEN

B. 在 OpenClaw 机器上检查#

1
openclaw gateway status
2
lsof -nP -iTCP:18800 -sTCP:LISTEN
3
curl http://192.168.2.160:3000/get_version_info

NapCat 端#

1
{
2
  "network": {
3
    "httpServers": [
4
      {
5
        "enable": true,
6
        "host": "0.0.0.0",
7
        "port": 3000,
8
        "accessToken": "YOUR_TOKEN_HERE"
9
      }
10
    ]
11
  },
12
  "reverseWs": {
13
    "enable": true,
14
    "urls": ["ws://192.168.2.116:18800"]
15
  }
16
}

OpenClaw 端#

1
{
2
  "channels": {
3
    "napcat": {
4
      "httpApi": "http://192.168.2.160:3000",
5
      "accessToken": "YOUR_TOKEN_HERE",
6
      "selfId": "75462022",
7
      "dmPolicy": "allowlist",
8
      "allowFrom": ["2845168040", "18563867", "1304077157"],
9
      "groupPolicy": "allowlist",
10
      "groupAllowFrom": ["445493645"]
11
    }
12
  },
13
  "tools": {
14
    "profile": "full"
15
  }
16
}