From 0d5de597323036bb8ca5654b9bfb219806f277b9 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 18 Apr 2026 17:28:42 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/channels/index.md | 68 +++++++------- docs/uk/channels/wechat.md | 175 +++++++++++++++++++++++++++++++++++++ 2 files changed, 209 insertions(+), 34 deletions(-) create mode 100644 docs/uk/channels/wechat.md diff --git a/docs/uk/channels/index.md b/docs/uk/channels/index.md index 6e3ea5b55..98709559d 100644 --- a/docs/uk/channels/index.md +++ b/docs/uk/channels/index.md @@ -1,57 +1,57 @@ --- read_when: - - Ви хочете вибрати канал чату для OpenClaw + - Ви хочете вибрати чат-канал для OpenClaw - Вам потрібен короткий огляд підтримуваних платформ обміну повідомленнями summary: Платформи обміну повідомленнями, до яких може підключатися OpenClaw -title: Канали чату +title: Чати-канали x-i18n: - generated_at: "2026-04-05T17:57:52Z" + generated_at: "2026-04-18T17:28:20Z" model: gpt-5.4 provider: openai - source_hash: 246ee6f16aebe751241f00102bb435978ed21f6158385aff5d8e222e30567416 + source_hash: d41c3a37d91c07f15afd8e199a289297772331c70e38697346a373595eb2d993 source_path: channels/index.md workflow: 15 --- -# Канали чату +# Чат-канали OpenClaw може спілкуватися з вами в будь-якому чат-застосунку, яким ви вже користуєтеся. Кожен канал підключається через Gateway. Текст підтримується всюди; підтримка медіа та реакцій залежить від каналу. ## Підтримувані канали -- [BlueBubbles](/channels/bluebubbles) — **Рекомендовано для iMessage**; використовує REST API сервера BlueBubbles для macOS із повною підтримкою функцій (вбудований плагін; редагування, скасування надсилання, ефекти, реакції, керування групами — редагування наразі не працює в macOS 26 Tahoe). -- [Discord](/channels/discord) — Discord Bot API + Gateway; підтримує сервери, канали та DM. -- [Feishu](/channels/feishu) — бот Feishu/Lark через WebSocket (вбудований плагін). -- [Google Chat](/channels/googlechat) — застосунок Google Chat API через HTTP-вебхук. -- [iMessage (legacy)](/channels/imessage) — застаріла інтеграція з macOS через CLI imsg (застаріло, для нових конфігурацій використовуйте BlueBubbles). -- [IRC](/channels/irc) — класичні IRC-сервери; канали + DM із контролем pairing/allowlist. -- [LINE](/channels/line) — бот LINE Messaging API (вбудований плагін). -- [Matrix](/channels/matrix) — протокол Matrix (вбудований плагін). -- [Mattermost](/channels/mattermost) — Bot API + WebSocket; канали, групи, DM (вбудований плагін). -- [Microsoft Teams](/channels/msteams) — Bot Framework; корпоративна підтримка (вбудований плагін). -- [Nextcloud Talk](/channels/nextcloud-talk) — self-hosted чат через Nextcloud Talk (вбудований плагін). -- [Nostr](/channels/nostr) — децентралізовані DM через NIP-04 (вбудований плагін). -- [QQ Bot](/channels/qqbot) — QQ Bot API; приватний чат, груповий чат і розширені медіа (вбудований плагін). -- [Signal](/channels/signal) — signal-cli; орієнтований на приватність. -- [Slack](/channels/slack) — Bolt SDK; застосунки для робочих просторів. -- [Synology Chat](/channels/synology-chat) — Synology NAS Chat через вихідні та вхідні вебхуки (вбудований плагін). -- [Telegram](/channels/telegram) — Bot API через grammY; підтримує групи. -- [Tlon](/channels/tlon) — месенджер на базі Urbit (вбудований плагін). -- [Twitch](/channels/twitch) — чат Twitch через IRC-з’єднання (вбудований плагін). -- [Voice Call](/plugins/voice-call) — телефонія через Plivo або Twilio (плагін, установлюється окремо). +- [BlueBubbles](/uk/channels/bluebubbles) — **Рекомендовано для iMessage**; використовує REST API сервера BlueBubbles на macOS із повною підтримкою функцій (вбудований Plugin; редагування, скасування надсилання, ефекти, реакції, керування групами — редагування наразі не працює в macOS 26 Tahoe). +- [Discord](/uk/channels/discord) — Discord Bot API + Gateway; підтримує сервери, канали та приватні повідомлення. +- [Feishu](/uk/channels/feishu) — бот Feishu/Lark через WebSocket (вбудований Plugin). +- [Google Chat](/uk/channels/googlechat) — застосунок Google Chat API через HTTP Webhook. +- [iMessage (legacy)](/uk/channels/imessage) — застаріла інтеграція з macOS через CLI imsg (застаріло, для нових налаштувань використовуйте BlueBubbles). +- [IRC](/uk/channels/irc) — класичні IRC-сервери; канали та приватні повідомлення з елементами керування pairing/allowlist. +- [LINE](/uk/channels/line) — бот LINE Messaging API (вбудований Plugin). +- [Matrix](/uk/channels/matrix) — протокол Matrix (вбудований Plugin). +- [Mattermost](/uk/channels/mattermost) — Bot API + WebSocket; канали, групи, приватні повідомлення (вбудований Plugin). +- [Microsoft Teams](/uk/channels/msteams) — Bot Framework; підтримка для підприємств (вбудований Plugin). +- [Nextcloud Talk](/uk/channels/nextcloud-talk) — самостійно розміщений чат через Nextcloud Talk (вбудований Plugin). +- [Nostr](/uk/channels/nostr) — децентралізовані приватні повідомлення через NIP-04 (вбудований Plugin). +- [QQ Bot](/uk/channels/qqbot) — QQ Bot API; приватний чат, груповий чат і розширені медіа (вбудований Plugin). +- [Signal](/uk/channels/signal) — signal-cli; орієнтований на конфіденційність. +- [Slack](/uk/channels/slack) — Bolt SDK; застосунки робочих просторів. +- [Synology Chat](/uk/channels/synology-chat) — Synology NAS Chat через вихідні та вхідні Webhook (вбудований Plugin). +- [Telegram](/uk/channels/telegram) — Bot API через grammY; підтримує групи. +- [Tlon](/uk/channels/tlon) — месенджер на базі Urbit (вбудований Plugin). +- [Twitch](/uk/channels/twitch) — чат Twitch через підключення IRC (вбудований Plugin). +- [Voice Call](/uk/plugins/voice-call) — телефонія через Plivo або Twilio (Plugin, встановлюється окремо). - [WebChat](/web/webchat) — інтерфейс Gateway WebChat через WebSocket. -- [WeChat](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin) — плагін Tencent iLink Bot через вхід за QR-кодом; лише приватні чати. -- [WhatsApp](/channels/whatsapp) — найпопулярніший; використовує Baileys і потребує pairing за QR-кодом. -- [Zalo](/channels/zalo) — Zalo Bot API; популярний месенджер у В’єтнамі (вбудований плагін). -- [Zalo Personal](/channels/zalouser) — особистий обліковий запис Zalo через вхід за QR-кодом (вбудований плагін). +- [WeChat](/uk/channels/wechat) — Plugin Tencent iLink Bot через вхід за QR-кодом; лише приватні чати (зовнішній Plugin). +- [WhatsApp](/uk/channels/whatsapp) — найпопулярніший; використовує Baileys і потребує pairing за QR-кодом. +- [Zalo](/uk/channels/zalo) — Zalo Bot API; популярний месенджер у В’єтнамі (вбудований Plugin). +- [Zalo Personal](/uk/channels/zalouser) — особистий обліковий запис Zalo через вхід за QR-кодом (вбудований Plugin). ## Примітки - Канали можуть працювати одночасно; налаштуйте кілька, і OpenClaw виконуватиме маршрутизацію для кожного чату. -- Найшвидше зазвичай налаштовується **Telegram** (простий токен бота). WhatsApp потребує pairing за QR-кодом і +- Найшвидше зазвичай налаштувати **Telegram** (простий токен бота). WhatsApp потребує pairing за QR-кодом і зберігає більше стану на диску. -- Поведінка груп залежить від каналу; див. [Групи](/channels/groups). -- Для безпеки застосовуються pairing DM та allowlist; див. [Безпека](/gateway/security). -- Усунення проблем: [Усунення проблем каналів](/channels/troubleshooting). -- Провайдери моделей документовано окремо; див. [Провайдери моделей](/providers/models). +- Поведінка в групах залежить від каналу; див. [Групи](/uk/channels/groups). +- Pairing приватних повідомлень і allowlist примусово застосовуються з міркувань безпеки; див. [Безпека](/uk/gateway/security). +- Усунення несправностей: [Усунення несправностей каналів](/uk/channels/troubleshooting). +- Постачальники моделей документовані окремо; див. [Постачальники моделей](/uk/providers/models). diff --git a/docs/uk/channels/wechat.md b/docs/uk/channels/wechat.md new file mode 100644 index 000000000..af2522788 --- /dev/null +++ b/docs/uk/channels/wechat.md @@ -0,0 +1,175 @@ +--- +read_when: + - Ви хочете підключити OpenClaw до WeChat або Weixin + - Ви встановлюєте або усуваєте неполадки плагіна каналу openclaw-weixin + - Вам потрібно зрозуміти, як зовнішні плагіни каналів працюють поруч із Gateway +summary: Налаштування каналу WeChat через зовнішній Plugin openclaw-weixin +title: WeChat +x-i18n: + generated_at: "2026-04-18T17:28:22Z" + model: gpt-5.4 + provider: openai + source_hash: ae669f2b6300e0c2b1d1dc57743a0a2ab0c05b9e277ec2ac640a03e6e7ab3b84 + source_path: channels/wechat.md + workflow: 15 +--- + +# WeChat + +OpenClaw підключається до WeChat через зовнішній Plugin каналу Tencent +`@tencent-weixin/openclaw-weixin`. + +Статус: зовнішній Plugin. Підтримуються особисті чати та медіа. Групові чати не +заявлені в поточних метаданих можливостей Plugin. + +## Назви + +- **WeChat** — це назва для користувачів у цій документації. +- **Weixin** — це назва, яку використовує пакет Tencent і id Plugin. +- `openclaw-weixin` — це id каналу OpenClaw. +- `@tencent-weixin/openclaw-weixin` — це пакет npm. + +Використовуйте `openclaw-weixin` у командах CLI і шляхах конфігурації. + +## Як це працює + +Код WeChat не міститься в основному репозиторії OpenClaw. OpenClaw надає +загальний контракт Plugin каналу, а зовнішній Plugin надає +специфічне для WeChat середовище виконання: + +1. `openclaw plugins install` встановлює `@tencent-weixin/openclaw-weixin`. +2. Gateway виявляє маніфест Plugin і завантажує точку входу Plugin. +3. Plugin реєструє id каналу `openclaw-weixin`. +4. `openclaw channels login --channel openclaw-weixin` запускає вхід за QR-кодом. +5. Plugin зберігає облікові дані акаунта в каталозі стану OpenClaw. +6. Коли Gateway запускається, Plugin запускає свій монітор Weixin для кожного + налаштованого акаунта. +7. Вхідні повідомлення WeChat нормалізуються через контракт каналу, спрямовуються + до вибраного агента OpenClaw і надсилаються назад через вихідний шлях Plugin. + +Це розділення має значення: ядро OpenClaw має залишатися незалежним від каналів. Вхід у WeChat, +виклики Tencent iLink API, завантаження й вивантаження медіа, токени контексту та +моніторинг акаунтів належать зовнішньому Plugin. + +## Встановлення + +Швидке встановлення: + +```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 +``` + +## Вхід + +Запустіть вхід за QR-кодом на тій самій машині, де працює Gateway: + +```bash +openclaw channels login --channel openclaw-weixin +``` + +Відскануйте QR-код у WeChat на своєму телефоні та підтвердьте вхід. Після успішного +сканування Plugin локально зберігає токен акаунта. + +Щоб додати ще один акаунт WeChat, знову виконайте ту саму команду входу. Для кількох +акаунтів ізолюйте сесії особистих повідомлень за акаунтом, каналом і відправником: + +```bash +openclaw config set session.dmScope per-account-channel-peer +``` + +## Керування доступом + +Особисті повідомлення використовують стандартну модель сполучення та списку дозволів OpenClaw для +Plugin каналів. + +Схваліть нових відправників: + +```bash +openclaw pairing list openclaw-weixin +openclaw pairing approve openclaw-weixin +``` + +Повну модель керування доступом див. у [Pairing](/uk/channels/pairing). + +## Сумісність + +Plugin перевіряє версію OpenClaw хоста під час запуску. + +| Лінійка Plugin | Версія OpenClaw | Тег npm | +| -------------- | ----------------------- | -------- | +| `2.x` | `>=2026.3.22` | `latest` | +| `1.x` | `>=2026.1.0 <2026.3.22` | `legacy` | + +Якщо Plugin повідомляє, що ваша версія OpenClaw застаріла, або оновіть +OpenClaw, або встановіть застарілу лінійку Plugin: + +```bash +openclaw plugins install @tencent-weixin/openclaw-weixin@legacy +``` + +## Sidecar-процес + +Plugin WeChat може запускати допоміжну роботу поруч із Gateway, поки він відстежує +Tencent iLink API. У задачі #68451 цей допоміжний шлях виявив помилку в загальному +очищенні застарілого Gateway в OpenClaw: дочірній процес міг спробувати очистити +батьківський процес Gateway, спричиняючи цикли перезапуску в менеджерах процесів, таких як systemd. + +Поточне очищення під час запуску OpenClaw виключає поточний процес і його предків, +тому допоміжний процес каналу не повинен завершувати Gateway, який його запустив. Це виправлення +є загальним; це не специфічний для WeChat шлях у ядрі. + +## Усунення неполадок + +Перевірте встановлення та статус: + +```bash +openclaw plugins list +openclaw channels status --probe +openclaw --version +``` + +Якщо канал показується як встановлений, але не підключається, переконайтеся, що Plugin +увімкнено, і перезапустіть: + +```bash +openclaw config set plugins.entries.openclaw-weixin.enabled true +openclaw gateway restart +``` + +Якщо Gateway неодноразово перезапускається після ввімкнення WeChat, оновіть і OpenClaw, і +Plugin: + +```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 +``` + +## Пов’язана документація + +- Огляд каналів: [Chat Channels](/uk/channels) +- Сполучення: [Pairing](/uk/channels/pairing) +- Маршрутизація каналів: [Channel Routing](/uk/channels/channel-routing) +- Архітектура Plugin: [Plugin Architecture](/uk/plugins/architecture) +- SDK Plugin каналів: [Channel Plugin SDK](/uk/plugins/sdk-channel-plugins) +- Зовнішній пакет: [@tencent-weixin/openclaw-weixin](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin)