GeWe OpenClaw Plugin

基于 GeWe API + Webhook 回调的 OpenClaw 微信通道插件。

安装

$3

``bash
openclaw plugins install gewe-openclaw
`

$3

`bash
openclaw plugins install /path/to/gewe-openclaw
`

或使用软链接（便于开发调试）：

`bash
openclaw plugins install --link /path/to/gewe-openclaw
`

$3

OpenClaw 支持本地 .zip / .tgz / .tar.gz / .tar 归档：

`bash
openclaw plugins install ./gewe-openclaw.tgz
`

> 安装或启用插件后需要重启 Gateway。

配置方式（二选一）

安装完成后可任选一种方式完成配置：

$3

`bash
openclaw onboard
`

在通道列表中选择 GeWe，按提示填写 token、appId、webhook 与 mediaPublicUrl 等信息。

$3

直接编辑 ~/.openclaw/openclaw.json 的 channels.gewe-openclaw 段落（见下方示例）。

配置

插件配置放在 ~/.openclaw/openclaw.json 的 channels.gewe-openclaw，并确保通道开启（示例仅保留必填/常用字段）：

`json5
{
"channels": {
"gewe-openclaw": {
"enabled": true,
"token": "",
"appId": "",
"webhookHost": "0.0.0.0",
"webhookPort": 4399,
"webhookPath": "/webhook",
"mediaHost": "0.0.0.0",
"mediaPort": 4400,
"mediaPath": "/gewe-media",
"mediaPublicUrl": "https://your-public-domain/gewe-media",
"allowFrom": ["wxid_xxx"]
}
}
}
`

完整参数说明：
- webhookHost/webhookPort/webhookPath：GeWe 回调入口（需公网可达，常配合 FRP）。
- mediaPath：本地媒体服务的路由前缀（默认 /gewe-media）。
- mediaPublicUrl：公网访问地址的“基础前缀”，会自动拼接媒体 ID。通常应与 mediaPath 对齐，例如 mediaPath="/gewe-media" 时，mediaPublicUrl 也应包含 /gewe-media。
- allowFrom：允许私聊触发的微信 ID（或在群里走 allowlist 规则）。
- voiceAutoConvert：自动将音频转为 silk（默认开启；设为 false 可关闭）。
- silkAutoDownload：自动下载 rust-silk（默认开启；可关闭后自行配置 voiceSilkPath / voiceDecodePath）。
- silkVersion：自动下载的 rust-silk 版本（latest 会自动清理旧版本）。
- silkBaseUrl：自定义下载源（默认 GitHub Releases）。
- silkInstallDir：自定义安装目录（默认 ~/.openclaw/tools/rust-silk/）。
- silkAllowUnverified：校验文件缺失时是否允许继续（默认 false）。
- silkSha256：手动指定下载包 SHA256（用于私有源或校验文件缺失场景）。
- apiBaseUrl：GeWe API 地址（默认 https://www.geweapi.com）。
- voiceFfmpegPath/videoFfmpegPath/videoFfprobePath：自定义 ffmpeg/ffprobe 路径。
- voiceSilkPath/voiceSilkArgs：自定义 silk 编码器路径和参数（不使用自动下载时）。
- voiceSilkPipe：是否启用 ffmpeg+rust-silk 的 stdin/stdout 管道（默认关闭；失败会回退到临时文件）。
- 低频/非高并发且磁盘压力不高时，推荐临时文件方案（更稳定/更快）。
- 高频/多并发或磁盘压力大时，推荐 pipe 方案（减少磁盘 IO）。
- voiceDecodePath/voiceDecodeArgs/voiceDecodeOutput：自定义 silk 解码器（入站语音转写用）。
- mediaMaxMb：上传媒体大小上限（默认 20MB）。
- downloadMinDelayMs/downloadMaxDelayMs：入站媒体下载节流。

> 配置变更后需重启 Gateway。

高级用法：让未安装插件也出现在 onboarding 列表

默认情况下，只有已安装的插件会出现在 onboarding 列表中。
如果你希望“未安装时也能在列表中展示”，需要配置本地 catalog：

`
~/.openclaw/plugins/catalog.json
`

示例（添加一次即可）：

`json
{
"entries": [
{
"name": "gewe-openclaw",
"openclaw": {
"channel": {
"id": "gewe-openclaw",
"label": "GeWe",
"selectionLabel": "WeChat (GeWe)",
"detailLabel": "WeChat (GeWe)",
"docsPath": "/channels/gewe-openclaw",
"docsLabel": "gewe-openclaw",
"blurb": "WeChat channel via GeWe API and webhook callbacks.",
"aliases": ["gewe-openclaw", "gewe", "wechat", "wx"],
"order": 72,
"quickstartAllowFrom": true
},
"install": {
"npmSpec": "gewe-openclaw",
"defaultChoice": "npm"
}
}
}
]
}
`

> 现在插件已支持 onboarding：选择 GeWe 通道后会提示填写 token/appId/webhook/mediaPublicUrl 等配置。

依赖

$3

- zod

$3

- openclaw (>= 2026.1.29)

$3

- ffmpeg / ffprobe（用于视频缩略图与时长）
- rust-silk（出站语音转 silk + 入站语音解码；支持自动下载）
- 或者自行安装 silk-encoder / silk-decoder 并在配置中指定路径

$3

- GeWe API 服务
- Webhook 回调需要公网可达（可配合 FRP）
- 媒体对外地址（mediaPublicUrl`）