chore(i18n): refresh zh-CN translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
edaa32f631
commit
dcbaa9fdc7
@ -1,56 +1,57 @@
|
||||
---
|
||||
read_when:
|
||||
- 你想为 OpenClaw 选择一个聊天渠道
|
||||
- 你需要一个受支持消息平台的快速概览
|
||||
- 你需要快速了解支持的消息平台概览
|
||||
summary: OpenClaw 可连接的消息平台
|
||||
title: 聊天渠道
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T08:15:02Z"
|
||||
generated_at: "2026-04-18T17:28:23Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 246ee6f16aebe751241f00102bb435978ed21f6158385aff5d8e222e30567416
|
||||
source_hash: d41c3a37d91c07f15afd8e199a289297772331c70e38697346a373595eb2d993
|
||||
source_path: channels/index.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# 聊天渠道
|
||||
|
||||
OpenClaw 可以在你已经使用的任意聊天应用中与你交流。每个渠道都通过 Gateway 网关连接。
|
||||
所有渠道都支持文本；媒体和 reactions 支持则因渠道而异。
|
||||
OpenClaw 可以在你已经使用的任何聊天应用上与你对话。每个渠道都通过 Gateway 网关连接。
|
||||
所有渠道都支持文本；媒体和回应功能则因渠道而异。
|
||||
|
||||
## 支持的渠道
|
||||
|
||||
- [BlueBubbles](/channels/bluebubbles) — **iMessage 的推荐方案**；使用 BlueBubbles macOS 服务器 REST API，并提供完整功能支持（内置插件；编辑、撤回、特效、reactions、群组管理——编辑功能目前在 macOS 26 Tahoe 上损坏）。
|
||||
- [Discord](/channels/discord) — Discord Bot API + Gateway 网关；支持服务器、渠道和私信。
|
||||
- [Feishu](/channels/feishu) — 通过 WebSocket 连接的 Feishu/Lark 机器人（内置插件）。
|
||||
- [Google Chat](/channels/googlechat) — 通过 HTTP webhook 连接的 Google Chat API 应用。
|
||||
- [iMessage (legacy)](/channels/imessage) — 通过 imsg CLI 的旧版 macOS 集成（已弃用，新部署请使用 BlueBubbles）。
|
||||
- [IRC](/channels/irc) — 经典 IRC 服务器；支持渠道和私信，并带有配对 / allowlist 控制。
|
||||
- [LINE](/channels/line) — LINE Messaging API 机器人（内置插件）。
|
||||
- [Matrix](/channels/matrix) — Matrix 协议（内置插件）。
|
||||
- [Mattermost](/channels/mattermost) — Bot API + WebSocket；支持渠道、群组、私信（内置插件）。
|
||||
- [Microsoft Teams](/channels/msteams) — Bot Framework；支持企业场景（内置插件）。
|
||||
- [Nextcloud Talk](/channels/nextcloud-talk) — 通过 Nextcloud Talk 的自托管聊天（内置插件）。
|
||||
- [Nostr](/channels/nostr) — 通过 NIP-04 的去中心化私信（内置插件）。
|
||||
- [QQ Bot](/channels/qqbot) — QQ Bot API；支持私聊、群聊和富媒体（内置插件）。
|
||||
- [Signal](/channels/signal) — signal-cli；注重隐私。
|
||||
- [Slack](/channels/slack) — Bolt SDK；适用于工作区应用。
|
||||
- [Synology Chat](/channels/synology-chat) — 通过 outgoing + incoming webhook 连接的 Synology NAS Chat（内置插件）。
|
||||
- [Telegram](/channels/telegram) — 通过 grammY 的 Bot API；支持群组。
|
||||
- [Tlon](/channels/tlon) — 基于 Urbit 的消息工具（内置插件）。
|
||||
- [Twitch](/channels/twitch) — 通过 IRC 连接的 Twitch 聊天（内置插件）。
|
||||
- [Voice Call](/plugins/voice-call) — 通过 Plivo 或 Twilio 提供电话能力（插件，需单独安装）。
|
||||
- [BlueBubbles](/zh-CN/channels/bluebubbles) — **推荐用于 iMessage**；使用 BlueBubbles macOS 服务器 REST API，支持完整功能（内置插件；编辑、撤回、效果、回应、群组管理——编辑功能目前在 macOS 26 Tahoe 上损坏）。
|
||||
- [Discord](/zh-CN/channels/discord) — Discord Bot API + Gateway 网关；支持服务器、频道和私信。
|
||||
- [Feishu](/zh-CN/channels/feishu) — 通过 WebSocket 的 Feishu/Lark 机器人（内置插件）。
|
||||
- [Google Chat](/zh-CN/channels/googlechat) — 通过 HTTP webhook 的 Google Chat API 应用。
|
||||
- [iMessage (legacy)](/zh-CN/channels/imessage) — 通过 imsg CLI 的旧版 macOS 集成（已弃用，新设置请使用 BlueBubbles）。
|
||||
- [IRC](/zh-CN/channels/irc) — 经典 IRC 服务器；支持频道 + 私信，并带有配对/允许列表控制。
|
||||
- [LINE](/zh-CN/channels/line) — LINE Messaging API 机器人（内置插件）。
|
||||
- [Matrix](/zh-CN/channels/matrix) — Matrix 协议（内置插件）。
|
||||
- [Mattermost](/zh-CN/channels/mattermost) — Bot API + WebSocket；频道、群组、私信（内置插件）。
|
||||
- [Microsoft Teams](/zh-CN/channels/msteams) — Bot Framework；支持企业使用（内置插件）。
|
||||
- [Nextcloud Talk](/zh-CN/channels/nextcloud-talk) — 通过 Nextcloud Talk 的自托管聊天（内置插件）。
|
||||
- [Nostr](/zh-CN/channels/nostr) — 通过 NIP-04 的去中心化私信（内置插件）。
|
||||
- [QQ Bot](/zh-CN/channels/qqbot) — QQ Bot API；支持私聊、群聊和富媒体（内置插件）。
|
||||
- [Signal](/zh-CN/channels/signal) — signal-cli；注重隐私。
|
||||
- [Slack](/zh-CN/channels/slack) — Bolt SDK；工作区应用。
|
||||
- [Synology Chat](/zh-CN/channels/synology-chat) — 通过发送 + 接收 webhook 的 Synology NAS Chat（内置插件）。
|
||||
- [Telegram](/zh-CN/channels/telegram) — 通过 grammY 的 Bot API；支持群组。
|
||||
- [Tlon](/zh-CN/channels/tlon) — 基于 Urbit 的消息工具（内置插件）。
|
||||
- [Twitch](/zh-CN/channels/twitch) — 通过 IRC 连接的 Twitch 聊天（内置插件）。
|
||||
- [Voice Call](/zh-CN/plugins/voice-call) — 通过 Plivo 或 Twilio 的电话功能（插件，需单独安装）。
|
||||
- [WebChat](/web/webchat) — 通过 WebSocket 的 Gateway 网关 WebChat UI。
|
||||
- [WeChat](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin) — 通过二维码登录的 Tencent iLink Bot 插件；仅支持私聊。
|
||||
- [WhatsApp](/channels/whatsapp) — 最流行；使用 Baileys，并需要二维码配对。
|
||||
- [Zalo](/channels/zalo) — Zalo Bot API；越南流行的消息工具（内置插件）。
|
||||
- [Zalo Personal](/channels/zalouser) — 通过二维码登录的 Zalo 个人账号（内置插件）。
|
||||
- [WeChat](/zh-CN/channels/wechat) — 通过二维码登录的 Tencent iLink Bot 插件；仅支持私聊（外部插件）。
|
||||
- [WhatsApp](/zh-CN/channels/whatsapp) — 最受欢迎；使用 Baileys，并需要二维码配对。
|
||||
- [Zalo](/zh-CN/channels/zalo) — Zalo Bot API；越南流行的消息工具（内置插件）。
|
||||
- [Zalo Personal](/zh-CN/channels/zalouser) — 通过二维码登录的 Zalo 个人账号（内置插件）。
|
||||
|
||||
## 说明
|
||||
|
||||
- 渠道可以同时运行；你可以配置多个渠道，OpenClaw 会按聊天进行路由。
|
||||
- 通常最快的设置方式是 **Telegram**（简单的 bot token）。WhatsApp 需要二维码配对，并且会在磁盘上存储更多状态。
|
||||
- 群组行为因渠道而异；参见 [群组](/channels/groups)。
|
||||
- 出于安全考虑，会强制执行私信配对和 allowlist；参见 [安全](/gateway/security)。
|
||||
- 故障排除：[渠道故障排除](/channels/troubleshooting)。
|
||||
- 模型提供商文档单独提供；参见 [模型提供商](/providers/models)。
|
||||
- 通常最快的设置方式是 **Telegram**（简单的机器人令牌）。WhatsApp 需要二维码配对，并且
|
||||
会在磁盘上存储更多状态。
|
||||
- 群组行为因渠道而异；参见 [Groups](/zh-CN/channels/groups)。
|
||||
- 出于安全考虑，会强制执行私信配对和允许列表；参见 [Security](/zh-CN/gateway/security)。
|
||||
- 故障排除：[Channel troubleshooting](/zh-CN/channels/troubleshooting)。
|
||||
- 模型提供商另有单独文档；参见 [Model Providers](/zh-CN/providers/models)。
|
||||
|
||||
156
docs/zh-CN/channels/wechat.md
Normal file
156
docs/zh-CN/channels/wechat.md
Normal file
@ -0,0 +1,156 @@
|
||||
---
|
||||
read_when:
|
||||
- 你想将 OpenClaw 连接到 微信】【。
|
||||
- 你正在安装或排查 `openclaw-weixin` 渠道插件的问题
|
||||
- 你需要了解外部渠道插件如何在 Gateway 网关旁边运行
|
||||
summary: 通过外部 `openclaw-weixin` 插件设置微信渠道
|
||||
title: 微信
|
||||
x-i18n:
|
||||
generated_at: "2026-04-18T17:28:23Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ae669f2b6300e0c2b1d1dc57743a0a2ab0c05b9e277ec2ac640a03e6e7ab3b84
|
||||
source_path: channels/wechat.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# 微信
|
||||
|
||||
OpenClaw 通过腾讯提供的外部 `@tencent-weixin/openclaw-weixin` 渠道插件连接到 微信。
|
||||
|
||||
状态：外部插件。支持私聊和媒体。不通过当前插件能力元数据宣称支持群聊。
|
||||
|
||||
## 命名
|
||||
|
||||
- **微信** 是本文档中面向用户的名称。
|
||||
- **微信** 是腾讯包名以及插件 id 中使用的名称。
|
||||
- `openclaw-weixin` 是 OpenClaw 渠道 id。
|
||||
- `@tencent-weixin/openclaw-weixin` 是 npm 包。
|
||||
|
||||
在 CLI 命令和配置路径中使用 `openclaw-weixin`。
|
||||
|
||||
## 工作原理
|
||||
|
||||
微信代码不在 OpenClaw 核心仓库中。OpenClaw 提供通用的渠道插件契约，而外部插件提供微信专用的运行时：
|
||||
|
||||
1. `openclaw plugins install` 安装 `@tencent-weixin/openclaw-weixin`。
|
||||
2. Gateway 网关发现插件清单并加载插件入口点。
|
||||
3. 插件注册渠道 id `openclaw-weixin`。
|
||||
4. `openclaw channels login --channel openclaw-weixin` 启动二维码登录。
|
||||
5. 插件将账户凭证存储在 OpenClaw 状态目录下。
|
||||
6. 当 Gateway 网关启动时，插件会为每个已配置账户启动其微信监控器。
|
||||
7. 入站微信消息会通过渠道契约被标准化，路由到所选的 OpenClaw 智能体，并通过插件的出站路径发回。
|
||||
|
||||
这种分离很重要：OpenClaw 核心应保持与渠道无关。微信登录、腾讯 iLink API 调用、媒体上传/下载、上下文令牌和账户监控都由外部插件负责。
|
||||
|
||||
## 安装
|
||||
|
||||
快速安装：
|
||||
|
||||
```bash
|
||||
npx -y @tencent-weixin/openclaw-weixin-cli install
|
||||
```
|
||||
|
||||
手动安装：
|
||||
|
||||
```bash
|
||||
openclaw plugins install "@tencent-weixin/openclaw-weixin"
|
||||
openclaw config set plugins.entries.openclaw-weixin.enabled true
|
||||
```
|
||||
|
||||
安装后重启 Gateway 网关：
|
||||
|
||||
```bash
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
## 登录
|
||||
|
||||
在运行 Gateway 网关的同一台机器上执行二维码登录：
|
||||
|
||||
```bash
|
||||
openclaw channels login --channel openclaw-weixin
|
||||
```
|
||||
|
||||
使用手机上的微信扫描二维码并确认登录。扫描成功后，插件会将账户令牌保存在本地。
|
||||
|
||||
要添加另一个微信账户，再次运行相同的登录命令即可。对于多个账户，请按账户、渠道和发送者隔离私信会话：
|
||||
|
||||
```bash
|
||||
openclaw config set session.dmScope per-account-channel-peer
|
||||
```
|
||||
|
||||
## 访问控制
|
||||
|
||||
私信使用 OpenClaw 针对渠道插件的常规配对和 allowlist 模型。
|
||||
|
||||
批准新的发送者：
|
||||
|
||||
```bash
|
||||
openclaw pairing list openclaw-weixin
|
||||
openclaw pairing approve openclaw-weixin <CODE>
|
||||
```
|
||||
|
||||
有关完整的访问控制模型，请参阅 [配对](/zh-CN/channels/pairing)。
|
||||
|
||||
## 兼容性
|
||||
|
||||
插件会在启动时检查宿主 OpenClaw 版本。
|
||||
|
||||
| 插件系列 | OpenClaw 版本 | npm 标签 |
|
||||
| -------- | ---------------------- | -------- |
|
||||
| `2.x` | `>=2026.3.22` | `latest` |
|
||||
| `1.x` | `>=2026.1.0 <2026.3.22` | `legacy` |
|
||||
|
||||
如果插件提示你的 OpenClaw 版本过旧，请更新 OpenClaw，或者安装旧版插件系列：
|
||||
|
||||
```bash
|
||||
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
|
||||
```
|
||||
|
||||
## Sidecar 进程
|
||||
|
||||
微信插件在监控腾讯 iLink API 时，可以在 Gateway 网关旁边运行辅助工作进程。在 issue #68451 中，这条辅助路径暴露了 OpenClaw 通用过期 Gateway 网关清理逻辑中的一个 bug：子进程可能会尝试清理父 Gateway 网关进程，从而在 systemd 等进程管理器下导致重启循环。
|
||||
|
||||
当前 OpenClaw 启动清理逻辑会排除当前进程及其祖先进程，因此渠道辅助进程不得终止启动它的 Gateway 网关。这个修复是通用的；它不是核心中的微信专用路径。
|
||||
|
||||
## 故障排除
|
||||
|
||||
检查安装和状态：
|
||||
|
||||
```bash
|
||||
openclaw plugins list
|
||||
openclaw channels status --probe
|
||||
openclaw --version
|
||||
```
|
||||
|
||||
如果渠道显示已安装但未连接，请确认插件已启用并重启：
|
||||
|
||||
```bash
|
||||
openclaw config set plugins.entries.openclaw-weixin.enabled true
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
如果启用微信后 Gateway 网关反复重启，请同时更新 OpenClaw 和插件：
|
||||
|
||||
```bash
|
||||
npm view @tencent-weixin/openclaw-weixin version
|
||||
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
临时禁用：
|
||||
|
||||
```bash
|
||||
openclaw config set plugins.entries.openclaw-weixin.enabled false
|
||||
openclaw gateway restart
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- 渠道概览：[聊天渠道](/zh-CN/channels)
|
||||
- 配对：[配对](/zh-CN/channels/pairing)
|
||||
- 渠道路由：[渠道路由](/zh-CN/channels/channel-routing)
|
||||
- 插件架构：[插件架构](/zh-CN/plugins/architecture)
|
||||
- 渠道插件 SDK：[渠道插件 SDK](/zh-CN/plugins/sdk-channel-plugins)
|
||||
- 外部包：[@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)
|
||||
Loading…
Reference in New Issue
Block a user