Skip to content
TakoAPI
Back to skills

onebot-adapter

by gu-heping

Coding Agents & IDEs
308Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Connect OpenClaw to OneBot protocol for QQ bot integration.

Description

What This Skill Does

Bridges OpenClaw to OneBot protocol servers for QQ bot functionality. Supports WebSocket for real-time bidirectional messaging and HTTP for simple send operations. Handles both private and group QQ messages.

OneBot is a standardized protocol, so this adapter works with any compliant server without tying you to a proprietary QQ API.

When to Use It

  • Sending automated QQ notifications to individual users
  • Routing QQ group messages to an AI agent for replies
  • Polling friend and group lists for contact sync
  • Triggering QQ messages from external workflows or scripts
  • Monitoring QQ group events in real time via WebSocket

Example Workflow

INPUT

User asks: Send 'Meeting in 10 minutes' to QQ group 789012

AGENT
  1. 1

    Initialize OneBotClient with configured HTTP URL and token

  2. 2

    Call send_group_msg with group_id=789012 and the message text

  3. 3

    Check response for delivery confirmation

  4. 4

    Return success status to user

OUTPUT

Message delivered to QQ group 789012

Requirements

  • NapCat or other OneBot-compatible server installed and running
  • QQ account configured with the OneBot server
  • ONEBOT_WS_URL environment variable
  • ONEBOT_HTTP_URL environment variable
  • ONEBOT_TOKEN environment variable (if authentication is enabled)

Installation

clawhub install gu-heping/onebot-adapter

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links