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

55 lines
1.7 KiB
Markdown

# 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](https://github.com/NannaOlympicBroadcast/clawdbot-wechat-plugin)**
---
## 🚀 Installation
Install the plugin from NPM:
```bash
clawdbot plugins install @haiyanfengli-llc/webhook-server
```
## ⚙️ Configuration
Add the following configuration to your Clawdbot `config.yaml`:
```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](https://github.com/NannaOlympicBroadcast/clawdbot-wechat-plugin) 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**