# Send OneBot Adapter to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "onebot-adapter",
    "name": "OneBot Adapter",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/Gu-Heping/onebot-adapter",
    "canonicalUrl": "https://clawhub.ai/Gu-Heping/onebot-adapter",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/onebot-adapter",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onebot-adapter",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/message-handling.md",
      "scripts/onebot_client.py",
      "scripts/onebot_ws_listener.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "onebot-adapter",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T20:11:03.852Z",
      "expiresAt": "2026-05-07T20:11:03.852Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onebot-adapter",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=onebot-adapter",
        "contentDisposition": "attachment; filename=\"onebot-adapter-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "onebot-adapter"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/onebot-adapter"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/onebot-adapter",
    "downloadUrl": "https://openagent3.xyz/downloads/onebot-adapter",
    "agentUrl": "https://openagent3.xyz/skills/onebot-adapter/agent",
    "manifestUrl": "https://openagent3.xyz/skills/onebot-adapter/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/onebot-adapter/agent.md"
  }
}
```
## Documentation

### OneBot Adapter

Connect OpenClaw to OneBot protocol servers like NapCat for QQ bot functionality.

### 1. Configure Connection

Set OneBot server URL in environment or config:

export ONEBOT_WS_URL="ws://127.0.0.1:3001"
export ONEBOT_HTTP_URL="http://127.0.0.1:3000"
export ONEBOT_TOKEN="your-token"

### 2. Receive Messages

Use the WebSocket listener script to receive QQ messages:

python scripts/onebot_ws_listener.py

### 3. Send Messages

Use HTTP API to send messages:

from scripts.onebot_client import OneBotClient

client = OneBotClient()
client.send_private_msg(user_id=123456, message="Hello!")
client.send_group_msg(group_id=789012, message="Group message")

### WebSocket (Recommended)

Real-time bidirectional communication
Receives events instantly
Supports both sending and receiving

### HTTP

Request-response model
Good for simple sending
Requires polling for receiving

### Get Login Info

client.get_login_info()

### Get Friend/Group List

client.get_friend_list()
client.get_group_list()

### Handle Messages

See references/message-handling.md for message parsing and response patterns.

### NapCat Specific

NapCat is a OneBot11 implementation based on NTQQ.

Default ports:

WebSocket: 3001
HTTP: 3000
WebUI: 6099

Token authentication is optional but recommended for public deployments.

### Troubleshooting

Connection refused: Check if OneBot server is running and ports are correct.

Authentication failed: Verify token matches OneBot server configuration.

Message not delivered: Check user_id/group_id exists and bot has permission.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Gu-Heping
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T20:11:03.852Z
- Expires at: 2026-05-07T20:11:03.852Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/onebot-adapter)
- [Send to Agent page](https://openagent3.xyz/skills/onebot-adapter/agent)
- [JSON manifest](https://openagent3.xyz/skills/onebot-adapter/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/onebot-adapter/agent.md)
- [Download page](https://openagent3.xyz/downloads/onebot-adapter)