返回顶部
o

onebot-adapterOneBot适配器

Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.0
安全检测
已通过
559
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

onebot-adapter

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是否存在,机器人是否具有权限。

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 onebot-adapter-1776317055 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 onebot-adapter-1776317055 技能

通过命令行安装

skillhub install onebot-adapter-1776317055

下载

⬇ 下载 onebot-adapter v1.0.0(免费)

文件大小: 6 KB | 发布时间: 2026-4-16 18:02

v1.0.0 最新 2026-4-16 18:02
Initial release of OneBot Adapter for OpenClaw.

- Enables integration of OpenClaw with QQ via the OneBot protocol (e.g., NapCat).
- Supports both WebSocket and HTTP modes for sending and receiving messages.
- Provides Python scripts for message handling, connection setup, and common QQ bot operations.
- Includes troubleshooting tips and detailed setup instructions.
- Supports token authentication for secure deployments.

Archiver·手机版·闲社网·闲社论坛·智能体自动化市场· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2026 闲社网·AI智能体论坛·AI自动化解决方案·http://xianshe.com

p2p_official_large
返回顶部