onebot-adapter-1-0-0Connect OpenClaw to OneBot protocol for QQ bot integration. Use when receiving or sending QQ messages via NapCat or other OneBot servers.
Install via ClawdBot CLI:
clawdbot install haohaodlam/onebot-adapter-1-0-0Connect OpenClaw to OneBot protocol servers like NapCat for QQ bot functionality.
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"Use the WebSocket listener script to receive QQ messages:
python scripts/onebot_ws_listener.pyUse 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")client.get_login_info()client.get_friend_list()
client.get_group_list()See references/message-handling.md for message parsing and response patterns.
NapCat is a OneBot11 implementation based on NTQQ.
Default ports:
Token authentication is optional but recommended for public deployments.
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.
Generated Feb 28, 2026
Automates moderation and engagement in QQ groups by sending welcome messages, answering FAQs, and filtering spam. Useful for gaming communities, fan clubs, or educational forums to reduce manual workload and improve user experience.
Provides automated responses to customer inquiries on QQ, handling common questions about products, orders, or services. Ideal for e-commerce or service-based businesses to offer 24/7 support and escalate complex issues to human agents.
Sends alerts and updates to employees or team members through QQ groups or private messages, such as meeting reminders, project milestones, or system status. Suitable for companies using QQ for internal communication to streamline workflows.
Distributes learning materials, quizzes, and announcements to students via QQ groups, enabling interactive lessons and feedback collection. Used by online tutors or educational institutions to enhance remote learning engagement.
Broadcasts event details, sends reminders, and processes simple registrations through QQ messages for concerts, webinars, or local gatherings. Helps organizers reach audiences directly and manage attendance efficiently.
Offers the adapter as part of a cloud-based bot platform with tiered pricing based on message volume or features. Generates recurring revenue from businesses needing scalable QQ automation without infrastructure management.
Provides consulting and development services to tailor the adapter for specific client needs, such as integrating with existing CRM systems or adding advanced message handling. Revenue comes from project-based fees and ongoing support contracts.
Offers a free basic version of the adapter for small-scale use, with paid upgrades for advanced functionalities like analytics, multi-server support, or priority support. Attracts a broad user base and converts power users to paying customers.
๐ฌ Integration Tip
Start with the WebSocket mode for real-time messaging and ensure environment variables are correctly set to avoid connection issues.
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Search and analyze your own session logs (older/parent conversations) using jq.
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linking related objects, enforcing constraints, planning multi-step actions as graph transformations, or when skills need to share state. Trigger on "remember", "what do I know about", "link X to Y", "show dependencies", entity CRUD, or cross-skill data access.
Ultimate AI agent memory system for Cursor, Claude, ChatGPT & Copilot. WAL protocol + vector search + git-notes + cloud backup. Never lose context again. Vibe-coding ready.
Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection