OneBot适配器

将OpenClaw连接到NapCat等OneBot协议服务器，实现QQ机器人功能。

快速开始

1. 配置连接

在环境变量或配置文件中设置OneBot服务器地址：
bash
export ONEBOTWSURL=ws://127.0.0.1:3001
export ONEBOTHTTPURL=http://127.0.0.1:3000
export ONEBOT_TOKEN=your-token

2. 接收消息

使用WebSocket监听脚本接收QQ消息：
bash
python scripts/onebotwslistener.py

3. 发送消息

使用HTTP API发送消息：
python
from scripts.onebot_client import OneBotClient

client = OneBotClient()
client.sendprivatemsg(user_id=123456, message=你好！)
client.sendgroupmsg(group_id=789012, message=群消息)

连接模式

WebSocket（推荐）

- 实时双向通信
即时接收事件
支持收发消息

HTTP

- 请求-响应模式
适合简单发送
接收消息需轮询

常见任务

获取登录信息

python client.getlogininfo()

获取好友/群列表

python client.getfriendlist() client.getgrouplist()

处理消息

消息解析和响应模式请参见references/message-handling.md。

NapCat相关说明

NapCat是基于NTQQ的OneBot11实现。

默认端口：

- WebSocket：3001
HTTP：3000
WebUI：6099

令牌认证为可选配置，但建议在公开部署时启用。

故障排除

连接被拒绝：检查OneBot服务器是否运行，端口是否正确。

认证失败：验证令牌是否与OneBot服务器配置一致。

消息未送达：检查用户ID/群组ID是否存在，机器人是否具有权限。

OneBot适配器