← 返回 Skills 市场
gu-heping

OneBot Adapter

作者 peace0824 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
623
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install onebot-adapter
功能描述
Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install onebot-adapter
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /onebot-adapter 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug onebot-adapter
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

OneBot Adapter 是什么?

Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 623 次。

如何安装 OneBot Adapter?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install onebot-adapter」即可一键安装,无需额外配置。

OneBot Adapter 是免费的吗?

是的,OneBot Adapter 完全免费(开源免费),可自由下载、安装和使用。

OneBot Adapter 支持哪些平台?

OneBot Adapter 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 OneBot Adapter?

由 peace0824(@gu-heping)开发并维护,当前版本 v1.0.0。

💬 留言讨论