a3799c7748
- Add channel documentation (EN + 中文) and plugin README - Link WeCom from channels index - 新增 WeCom 渠道插件（国内常用） - 新增频道文档（英文 + 中文）与插件 README - 在 Channels 索引中加入 WeCom 入口
92 lines
2.1 KiB
Markdown
92 lines
2.1 KiB
Markdown
# WeCom (WeChat Work) Channel Plugin for Clawdbot
|
||
|
||
Maintainer: YanHaidao (VX: YanHaidao)
|
||
|
||
Status: WeCom intelligent bot (API mode) via encrypted webhooks + passive replies (stream).
|
||
|
||
## Install
|
||
|
||
### Option A: Install from npm
|
||
```bash
|
||
clawdbot plugins install @clawdbot/wecom
|
||
clawdbot plugins enable wecom
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
### Option B: Local development (link)
|
||
```bash
|
||
clawdbot plugins install --link extensions/wecom
|
||
clawdbot plugins enable wecom
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
## Configure
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
wecom: {
|
||
enabled: true,
|
||
webhookPath: "/wecom",
|
||
token: "YOUR_TOKEN",
|
||
encodingAESKey: "YOUR_ENCODING_AES_KEY",
|
||
receiveId: "",
|
||
dm: { policy: "pairing" }
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## Notes
|
||
|
||
- Webhooks require public HTTPS. For security, only expose the `/wecom` path to the internet.
|
||
- Stream behavior: the first reply may be a minimal placeholder; WeCom will call back with `msgtype=stream` to refresh and fetch the full content.
|
||
- Limitations: passive replies only; standalone send is not supported.
|
||
|
||
---
|
||
|
||
# Clawdbot 企业微信（WeCom）Channel 插件
|
||
|
||
维护者：YanHaidao（VX：YanHaidao）
|
||
|
||
状态：支持企业微信智能机器人（API 模式）加密回调 + 被动回复（stream）。
|
||
|
||
## 安装
|
||
|
||
### 方式 A：从 npm 安装
|
||
```bash
|
||
clawdbot plugins install @clawdbot/wecom
|
||
clawdbot plugins enable wecom
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
### 方式 B：本地开发（link）
|
||
```bash
|
||
clawdbot plugins install --link extensions/wecom
|
||
clawdbot plugins enable wecom
|
||
clawdbot gateway restart
|
||
```
|
||
|
||
## 配置
|
||
|
||
```json5
|
||
{
|
||
channels: {
|
||
wecom: {
|
||
enabled: true,
|
||
webhookPath: "/wecom",
|
||
token: "YOUR_TOKEN",
|
||
encodingAESKey: "YOUR_ENCODING_AES_KEY",
|
||
receiveId: "",
|
||
dm: { policy: "pairing" }
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 说明
|
||
|
||
- webhook 必须是公网 HTTPS。出于安全考虑，建议只对外暴露 `/wecom` 路径。
|
||
- stream 模式：第一次回包可能是占位符；随后 WeCom 会以 `msgtype=stream` 回调刷新拉取完整内容。
|
||
- 限制：仅支持被动回复，不支持脱离回调的主动发送。
|