From dcbaa9fdc799560995646004fdbf326a431ff2d3 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 18 Apr 2026 17:28:37 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/channels/index.md | 69 +++++++-------- docs/zh-CN/channels/wechat.md | 156 ++++++++++++++++++++++++++++++++++ 2 files changed, 191 insertions(+), 34 deletions(-) create mode 100644 docs/zh-CN/channels/wechat.md diff --git a/docs/zh-CN/channels/index.md b/docs/zh-CN/channels/index.md index 3c0d9e1a9..19f4f4626 100644 --- a/docs/zh-CN/channels/index.md +++ b/docs/zh-CN/channels/index.md @@ -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)。 diff --git a/docs/zh-CN/channels/wechat.md b/docs/zh-CN/channels/wechat.md new file mode 100644 index 000000000..d00987290 --- /dev/null +++ b/docs/zh-CN/channels/wechat.md @@ -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 +``` + +有关完整的访问控制模型，请参阅 [配对](/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)