← Back to Skills Marketplace
Onebot Adapter 1.0.0
by
haohaodlam
· GitHub ↗
· v1.0.0
343
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install onebot-adapter-1-0-0
Description
Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers.
Usage Guidance
This adapter appears to do what it says (HTTP client + WebSocket listener for OneBot), but there are a few inconsistencies you should resolve before installing: (1) SKILL.md and the Python scripts expect ONEBOT_WS_URL, ONEBOT_HTTP_URL, and ONEBOT_TOKEN, yet the registry metadata lists no required env vars — verify you are intentionally supplying those values and understand what token you are providing. (2) _meta.json shows a different ownerId than the registry header — confirm the publisher/source is trustworthy. Also note the scripts assume the 'requests' and 'websockets' Python packages and include an unusual shebang (/opt/playwright/bin/python) — run in a sandbox or virtualenv, install dependencies yourself, and review the two Python files locally. Do not supply ONEBOT_TOKEN (or any sensitive token) unless you trust the OneBot server and the skill source.
Capability Analysis
Type: OpenClaw Skill
Name: onebot-adapter-1-0-0
Version: 1.0.0
The skill bundle provides a client and listener for the OneBot protocol, designed for QQ bot integration. All files (code and documentation) align with the stated purpose, facilitating communication with a OneBot server. The Python scripts read connection details and tokens from environment variables, which is standard practice, and make HTTP/WebSocket requests to the configured OneBot server (defaulting to localhost). There is no evidence of intentional harmful behavior such as data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts against the OpenClaw agent. The code is clear, uses standard libraries, and lacks obfuscation.
Capability Assessment
Purpose & Capability
Files (onebot_client.py and onebot_ws_listener.py) implement HTTP and WebSocket OneBot integration consistent with the skill name/description. However, the registry metadata claims no required env vars while SKILL.md and the code rely on ONEBOT_WS_URL, ONEBOT_HTTP_URL, and ONEBOT_TOKEN. Also _meta.json contains a different ownerId than the top-level registry owner — an ownership/packaging mismatch.
Instruction Scope
SKILL.md gives concrete instructions (export ONEBOT_* env vars, run the listener, use the client API). The included code only reads those env vars, connects to the configured OneBot server, and sends/receives OneBot events; it does not attempt to read arbitrary system files or exfiltrate data to unexpected endpoints. The instructions are not overly broad.
Install Mechanism
There is no install spec (instruction-only) and the code is included as scripts. No downloads or archive extraction are performed. Note: the shebang lines reference /opt/playwright/bin/python which is an unusual interpreter path and may cause launch failures if that path does not exist.
Credentials
The environment variables referenced (ONEBOT_WS_URL, ONEBOT_HTTP_URL, ONEBOT_TOKEN) are appropriate for a OneBot adapter. However, the skill metadata does not declare these required env vars, creating an inconsistency that could hide the need to provide a token. ONEBOT_TOKEN is sensitive (authorization token); only provide it when you trust the target OneBot server and the skill source.
Persistence & Privilege
The skill does not request persistent/always-on privileges (always: false). It does not modify other skills or system-wide settings. It runs network clients and a listener as expected for its purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install onebot-adapter-1-0-0 - After installation, invoke the skill by name or use
/onebot-adapter-1-0-0 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of onebot-adapter for QQ bot integration with OpenClaw.
- Connects OpenClaw to OneBot protocol servers (e.g. NapCat) for QQ messaging.
- Supports both WebSocket (recommended) and HTTP connection modes.
- Provides scripts and API for receiving and sending private/group messages.
- Includes setup instructions and troubleshooting tips for authentication and connection issues.
Metadata
Frequently Asked Questions
What is Onebot Adapter 1.0.0?
Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers. It is an AI Agent Skill for Claude Code / OpenClaw, with 343 downloads so far.
How do I install Onebot Adapter 1.0.0?
Run "/install onebot-adapter-1-0-0" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Onebot Adapter 1.0.0 free?
Yes, Onebot Adapter 1.0.0 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Onebot Adapter 1.0.0 support?
Onebot Adapter 1.0.0 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Onebot Adapter 1.0.0?
It is built and maintained by haohaodlam (@haohaodlam); the current version is v1.0.0.
More Skills