← Back to Skills Marketplace
623
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install onebot-adapter
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 skill implements a OneBot HTTP client and WebSocket listener which matches its description, but there are a few issues to consider before installing or running it:
- ONEBOT_TOKEN and endpoint URLs are used by the code and SKILL.md but are not declared in the skill metadata. Treat ONEBOT_TOKEN as sensitive (limit its scope, rotate if needed). Prefer creating a token with minimal permissions.
- The package has no install spec: it depends on Python libraries (requests, websockets) and may fail unless you install them yourself. Review and install dependencies in a controlled environment (virtualenv or container).
- The scripts' shebang points to /opt/playwright/bin/python, which is nonstandard; run them explicitly with your intended Python interpreter (python3 scripts/onebot_ws_listener.py) to avoid surprises.
- Review the included source (onebot_client.py, onebot_ws_listener.py) yourself — they make network connections to the configured endpoints and can send messages (including administrative actions like kicking/banning). Ensure you trust the OneBot server URLs you configure.
If you need to proceed: run this skill in an isolated environment (container or VM), provide only a limited-scope token, and install dependencies explicitly. If you want stronger assurance, ask the maintainer to: declare required env vars in metadata, provide a clear install spec, and use a standard shebang or packaging.
Capability Analysis
Type: OpenClaw Skill
Name: onebot-adapter
Version: 1.0.0
The skill bundle provides a OneBot adapter for QQ bot integration, consisting of an HTTP client and a WebSocket listener. All code and documentation align with the stated purpose, allowing the agent to send/receive messages and manage groups via the OneBot protocol. Configuration is handled via environment variables or localhost defaults. There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts against the OpenClaw agent. The capabilities provided are inherent to a bot's functionality and are not indicative of malicious intent within the skill itself.
Capability Assessment
Purpose & Capability
The name, description, SKILL.md instructions, and included Python client/listener code are coherent: they implement a OneBot HTTP client and WebSocket listener for QQ/NapCat. The requested behavior (send/receive QQ messages, query groups/friends) matches the stated purpose.
Instruction Scope
SKILL.md instructs the agent/user to export ONEBOT_WS_URL, ONEBOT_HTTP_URL, and ONEBOT_TOKEN and to run the included scripts. The runtime actions (open WebSocket connections, call HTTP API endpoints) are within the adapter's scope and do not attempt to read unrelated system files. However the SKILL.md relies on environment values that are not declared in the skill metadata (see environment_proportionality).
Install Mechanism
There is no install spec (instruction-only style) and code files are included. The Python scripts depend on third-party packages (requests, websockets) but the skill does not declare or install these, so the runtime may fail or an operator might install packages ad-hoc. The shebang (#!/opt/playwright/bin/python) is nonstandard and may not exist on target systems — this is odd but not necessarily malicious.
Credentials
The skill metadata declares no required environment variables, yet SKILL.md and the code rely on ONEBOT_WS_URL, ONEBOT_HTTP_URL, and ONEBOT_TOKEN. ONEBOT_TOKEN is a sensitive credential; the skill should have declared this as a required credential and documented its scope. The mismatch is a meaningful omission that could lead to accidental credential exposure or operator confusion.
Persistence & Privilege
always is false and the skill does not request to modify other skills or system-wide configuration. It runs as a user-level script which is appropriate for its function.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install onebot-adapter - After installation, invoke the skill by name or use
/onebot-adapter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
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.
Metadata
Frequently Asked Questions
What is OneBot Adapter?
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 623 downloads so far.
How do I install OneBot Adapter?
Run "/install onebot-adapter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OneBot Adapter free?
Yes, OneBot Adapter is completely free (open-source). You can download, install and use it at no cost.
Which platforms does OneBot Adapter support?
OneBot Adapter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OneBot Adapter?
It is built and maintained by peace0824 (@gu-heping); the current version is v1.0.0.
More Skills