OpenClaw GeWe channel plugin
npm install gewe-openclaw基于 GeWe API + Webhook 回调的 OpenClaw 微信通道插件。
``bash`
openclaw plugins install gewe-openclaw
`bash`
openclaw plugins install /path/to/gewe-openclaw
或使用软链接(便于开发调试):
`bash`
openclaw plugins install --link /path/to/gewe-openclaw
OpenClaw 支持本地 .zip / .tgz / .tar.gz / .tar 归档:
`bash`
openclaw plugins install ./gewe-openclaw.tgz
> 安装或启用插件后需要重启 Gateway。
安装完成后可任选一种方式完成配置:
`bash`
openclaw onboard
在通道列表中选择 GeWe,按提示填写 token、appId、webhook 与 mediaPublicUrl 等信息。
直接编辑 ~/.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 管道(默认关闭;失败会回退到临时文件)。voiceDecodePath
- 低频/非高并发且磁盘压力不高时,推荐临时文件方案(更稳定/更快)。
- 高频/多并发或磁盘压力大时,推荐 pipe 方案(减少磁盘 IO)。
- /voiceDecodeArgs/voiceDecodeOutput:自定义 silk 解码器(入站语音转写用)。mediaMaxMb
- :上传媒体大小上限(默认 20MB)。downloadMinDelayMs
- /downloadMaxDelayMs:入站媒体下载节流。
> 配置变更后需重启 Gateway。
默认情况下,只有已安装的插件会出现在 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 等配置。
- zod
- openclaw (>= 2026.1.29)
- ffmpeg / ffprobe(用于视频缩略图与时长)rust-silk
- (出站语音转 silk + 入站语音解码;支持自动下载)silk-encoder
- 或者自行安装 / silk-decoder 并在配置中指定路径
- GeWe API 服务
- Webhook 回调需要公网可达(可配合 FRP)
- 媒体对外地址(mediaPublicUrl`)