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
55 lines
1.7 KiB
Markdown
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**
|