openclaw/extensions/wechat/PLUGIN_USAGE.md
1bytesweetheart 35c870601b This PR introduces a new extension @haiyanfengli-llc/webhook-server that adds support for WeChat Official Accounts (Weixin Service/Subscription Accounts).
It works by exposing a webhook server that interfaces with a self-hosted WeChat Bridge, allowing Clawdbot to send and receive messages from WeChat users.

Key Changes:

Added extensions/wechat with the plugin implementation.
Implemented fastify server for efficient webhook handling.
Added full documentation in
PLUGIN_USAGE.md
.
AI/Vibe-Coded:

 AI-Assisted: Yes (Google Antigravity)
 Degree of Testing: Lightly tested (Verified with local WeChat Bridge and test account)
 Understanding: Confirmed (I understand how the webhook/bridge architecture works)
Related Links:

Companion Bridge Repository
2026-01-27 21:54:13 +08:00

1.7 KiB

Clawdbot WeChat Channel Plugin

Connect your Clawdbot agent to WeChat Official Accounts.

This plugin is part of the Clawdbot WeChat Integration Suite. For full source code, issues, and bridge deployment guide, please visit our GitHub repository: 👉 https://github.com/NannaOlympicBroadcast/clawdbot-wechat-plugin


🚀 Installation

Install the plugin from NPM:

clawdbot plugins install @haiyanfengli-llc/webhook-server

⚙️ Configuration

Add the following configuration to your Clawdbot config.yaml:

channels:
  wechat:
    enabled: true
    config:
      # Optional: Explicitly set the callback URL if auto-detection fails
      # callbackUrl: "http://<bridge-host>:3000/callback"

🔗 Architecture

This plugin requires the WeChat Bridge service to function. The bridge handles the communication with WeChat servers and forwards messages to this plugin.

  1. WeChat sends message to Bridge.
  2. Bridge forwards message to Clawdbot Plugin.
  3. Clawdbot Agent processes message.
  4. Clawdbot Plugin sends reply back to Bridge.
  5. Bridge sends reply to WeChat.

Please refer to the GitHub Repository for instructions on how to deploy the Bridge.

📋 Requirements

  • Clawdbot v0.5.0 or later
  • Self-hosted WeChat Bridge
  • WeChat Service Account (服务号) or verified Subscription Account (认证订阅号)

🤝 Commercial Support

For commercial usage, verified builds, or enterprise support, please contact: 📧 nomorelighthouse@gmail.com