From 54bd3e346199ff004e437f91ed930cde2c10e0a4 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 4 May 2026 17:22:47 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/channels/zalouser.md | 100 ++++++++++++++++++----------------- 1 file changed, 51 insertions(+), 49 deletions(-) diff --git a/docs/uk/channels/zalouser.md b/docs/uk/channels/zalouser.md index 0e7de78dd..bdce1cc35 100644 --- a/docs/uk/channels/zalouser.md +++ b/docs/uk/channels/zalouser.md @@ -1,19 +1,19 @@ --- read_when: - Налаштування Zalo Personal для OpenClaw - - Налагодження входу до Zalo Personal або потоку повідомлень -summary: Підтримка особистого облікового запису Zalo через нативний zca-js (вхід за QR-кодом), можливості та конфігурація + - Налагодження входу в Zalo Personal або потоку повідомлень +summary: Підтримка особистих облікових записів Zalo через нативний zca-js (вхід через QR-код), можливості та налаштування title: Особистий Zalo x-i18n: - generated_at: "2026-05-02T21:58:44Z" + generated_at: "2026-05-04T17:22:08Z" model: gpt-5.5 provider: openai - source_hash: 0096775e0017e504130f2e19e05ab8114eadb873a9e11f79ea8f0dd91297567f + source_hash: 0f6d27f0ca502e6426abe21d609efd0a168a0b6b0fafe8d52d59f1a717da1ed5 source_path: channels/zalouser.md workflow: 16 --- -Статус: експериментальний. Ця інтеграція автоматизує **особистий обліковий запис Zalo** через нативний `zca-js` всередині OpenClaw. +Статус: експериментально. Ця інтеграція автоматизує **особистий обліковий запис Zalo** через нативний `zca-js` всередині OpenClaw. Це неофіційна інтеграція, яка може призвести до призупинення або блокування облікового запису. Використовуйте на власний ризик. @@ -21,27 +21,27 @@ x-i18n: ## Вбудований Plugin -Zalo Personal постачається як вбудований Plugin у поточних релізах OpenClaw, тому звичайні +Zalo Personal постачається як вбудований Plugin у поточних випусках OpenClaw, тому звичайні пакетовані збірки не потребують окремого встановлення. -Якщо ви використовуєте старішу збірку або кастомне встановлення, що виключає Zalo Personal, -встановіть npm-пакет напряму: +Якщо ви використовуєте старішу збірку або власне встановлення, яке виключає Zalo Personal, +встановіть npm-пакет безпосередньо: - Встановити через CLI: `openclaw plugins install @openclaw/zalouser` -- Закріплена версія: `openclaw plugins install @openclaw/zalouser@2026.5.2` +- Зафіксована версія: `openclaw plugins install @openclaw/zalouser@2026.5.2` - Або з checkout вихідного коду: `openclaw plugins install ./path/to/local/zalouser-plugin` -- Докладніше: [Plugins](/uk/tools/plugin) +- Подробиці: [Plugins](/uk/tools/plugin) -Зовнішній двійковий файл CLI `zca`/`openzca` не потрібен. +Зовнішній CLI-бінарник `zca`/`openzca` не потрібен. ## Швидке налаштування (для початківців) 1. Переконайтеся, що Plugin Zalo Personal доступний. - - Поточні пакетовані релізи OpenClaw уже містять його. - - Старіші/кастомні встановлення можуть додати його вручну за допомогою команд вище. + - Поточні пакетовані випуски OpenClaw вже містять його. + - Старіші/власні встановлення можуть додати його вручну за допомогою команд вище. 2. Увійдіть (QR, на машині Gateway): - `openclaw channels login --channel zalouser` - - Відскануйте QR-код мобільним застосунком Zalo. + - Проскануйте QR-код мобільним застосунком Zalo. 3. Увімкніть канал: ```json5 @@ -60,18 +60,18 @@ Zalo Personal постачається як вбудований Plugin у по ## Що це таке -- Повністю працює всередині процесу через `zca-js`. +- Працює повністю в процесі через `zca-js`. - Використовує нативні слухачі подій для отримання вхідних повідомлень. -- Надсилає відповіді напряму через JS API (текст/медіа/посилання). -- Призначено для сценаріїв із “особистим обліковим записом”, коли Zalo Bot API недоступний. +- Надсилає відповіді безпосередньо через JS API (текст/медіа/посилання). +- Призначено для сценаріїв використання “особистого облікового запису”, коли Zalo Bot API недоступний. ## Іменування -ID каналу — `zalouser`, щоб явно вказати, що це автоматизує **особистий обліковий запис користувача Zalo** (неофіційно). Ми залишаємо `zalo` зарезервованим для можливої майбутньої офіційної інтеграції Zalo API. +ID каналу — `zalouser`, щоб явно вказати, що це автоматизує **особистий обліковий запис користувача Zalo** (неофіційно). Ми залишаємо `zalo` зарезервованим для потенційної майбутньої офіційної інтеграції Zalo API. ## Пошук ID (каталог) -Використовуйте CLI каталогу, щоб знаходити співрозмовників/групи та їхні ID: +Використовуйте CLI каталогу, щоб знаходити peers/групи та їхні ID: ```bash openclaw directory self --channel zalouser @@ -88,27 +88,29 @@ openclaw directory groups list --channel zalouser --query "work" `channels.zalouser.dmPolicy` підтримує: `pairing | allowlist | open | disabled` (за замовчуванням: `pairing`). -`channels.zalouser.allowFrom` приймає ID користувачів або імена. Під час налаштування імена зіставляються з ID за допомогою внутрішнього пошуку контактів Plugin у процесі. +`channels.zalouser.allowFrom` має використовувати стабільні ID користувачів Zalo. Під час інтерактивного налаштування введені імена можна перетворити на ID за допомогою внутрішнього пошуку контактів Plugin. -Підтвердьте через: +Якщо сире ім’я лишається в конфігурації, під час запуску воно перетворюється лише коли ввімкнено `channels.zalouser.dangerouslyAllowNameMatching: true`. Без цієї явної згоди runtime-перевірки відправника виконуються лише за ID, а сирі імена ігноруються для авторизації. + +Підтвердити через: - `openclaw pairing list zalouser` - `openclaw pairing approve zalouser ` ## Доступ до груп (необов’язково) -- За замовчуванням: `channels.zalouser.groupPolicy = "open"` (групи дозволені). Використовуйте `channels.defaults.groupPolicy`, щоб перевизначити стандартне значення, коли воно не задане. -- Обмежте до allowlist за допомогою: +- За замовчуванням: `channels.zalouser.groupPolicy = "open"` (групи дозволено). Використовуйте `channels.defaults.groupPolicy`, щоб перевизначити значення за замовчуванням, коли воно не задане. +- Обмежити списком дозволених: - `channels.zalouser.groupPolicy = "allowlist"` - - `channels.zalouser.groups` (ключами мають бути стабільні ID груп; імена зіставляються з ID під час запуску, коли це можливо) + - `channels.zalouser.groups` (ключі мають бути стабільними ID груп; імена перетворюються на ID під час запуску лише коли ввімкнено `channels.zalouser.dangerouslyAllowNameMatching: true`) - `channels.zalouser.groupAllowFrom` (керує тим, які відправники в дозволених групах можуть запускати бота) - Заблокувати всі групи: `channels.zalouser.groupPolicy = "disabled"`. -- Майстер конфігурації може запитувати allowlist для груп. -- Під час запуску OpenClaw зіставляє імена груп/користувачів у allowlist з ID і записує відповідність у журнал. -- Зіставлення group allowlist за замовчуванням виконується лише за ID. Нерозв’язані імена ігноруються для авторизації, якщо не ввімкнено `channels.zalouser.dangerouslyAllowNameMatching: true`. -- `channels.zalouser.dangerouslyAllowNameMatching: true` — це режим сумісності на випадок аварійного відновлення, який знову вмикає зіставлення за змінюваними іменами груп. +- Майстер налаштування може запитувати списки дозволених груп. +- Під час запуску OpenClaw перетворює імена груп/користувачів у списках дозволених на ID і журналює зіставлення лише коли ввімкнено `channels.zalouser.dangerouslyAllowNameMatching: true`. +- Зіставлення списку дозволених груп за замовчуванням виконується лише за ID. Нерозв’язані імена ігноруються для автентифікації, якщо не ввімкнено `channels.zalouser.dangerouslyAllowNameMatching: true`. +- `channels.zalouser.dangerouslyAllowNameMatching: true` — це аварійний режим сумісності, який повторно вмикає змінне розпізнавання імен під час запуску та runtime-зіставлення назв груп. - Якщо `groupAllowFrom` не задано, runtime повертається до `allowFrom` для перевірок відправників у групах. -- Перевірки відправника застосовуються як до звичайних групових повідомлень, так і до керівних команд (наприклад, `/new`, `/reset`). +- Перевірки відправників застосовуються як до звичайних групових повідомлень, так і до керівних команд (наприклад `/new`, `/reset`). Приклад: @@ -127,15 +129,15 @@ openclaw directory groups list --channel zalouser --query "work" } ``` -### Обмеження згадуванням у групі +### Обмеження групових згадок -- `channels.zalouser.groups..requireMention` керує тим, чи потрібна згадка для відповідей у групі. -- Порядок розв’язання: точний ID/назва групи -> нормалізований slug групи -> `*` -> значення за замовчуванням (`true`). -- Це застосовується як до груп в allowlist, так і до відкритого групового режиму. -- Цитування повідомлення бота вважається неявною згадкою для активації в групі. -- Авторизовані керівні команди (наприклад, `/new`) можуть обходити обмеження згадуванням. -- Коли групове повідомлення пропускається, бо потрібна згадка, OpenClaw зберігає його як очікувану групову історію та додає до наступного обробленого групового повідомлення. -- Ліміт групової історії за замовчуванням дорівнює `messages.groupChat.historyLimit` (fallback `50`). Його можна перевизначити для кожного облікового запису через `channels.zalouser.historyLimit`. +- `channels.zalouser.groups..requireMention` керує тим, чи потребують групові відповіді згадки. +- Порядок розпізнавання: точний ID/назва групи -> нормалізований slug групи -> `*` -> значення за замовчуванням (`true`). +- Це застосовується як до груп зі списку дозволених, так і до режиму відкритих груп. +- Цитування повідомлення бота рахується як неявна згадка для активації в групі. +- Авторизовані керівні команди (наприклад `/new`) можуть обходити обмеження згадок. +- Коли групове повідомлення пропускається, бо потрібна згадка, OpenClaw зберігає його як очікувану історію групи та включає його до наступного обробленого групового повідомлення. +- Ліміт історії груп за замовчуванням бере `messages.groupChat.historyLimit` (резервне значення `50`). Його можна перевизначити для облікового запису через `channels.zalouser.historyLimit`. Приклад: @@ -171,34 +173,34 @@ openclaw directory groups list --channel zalouser --query "work" } ``` -## Набір тексту, реакції та підтвердження доставлення +## Набір тексту, реакції та підтвердження доставки - OpenClaw надсилає подію набору тексту перед відправленням відповіді (best-effort). - Дія реакції на повідомлення `react` підтримується для `zalouser` у діях каналу. - - Використовуйте `remove: true`, щоб видалити конкретний emoji реакції з повідомлення. + - Використовуйте `remove: true`, щоб прибрати конкретний emoji-реакцію з повідомлення. - Семантика реакцій: [Реакції](/uk/tools/reactions) -- Для вхідних повідомлень, що містять метадані події, OpenClaw надсилає підтвердження доставлено + переглянуто (best-effort). +- Для вхідних повідомлень, які містять метадані події, OpenClaw надсилає підтвердження доставлено + переглянуто (best-effort). ## Усунення несправностей **Вхід не зберігається:** - `openclaw channels status --probe` -- Увійдіть повторно: `openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser` +- Повторний вхід: `openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser` -**Allowlist/назва групи не розв’язалася:** +**Ім’я зі списку дозволених/назва групи не розпізналися:** -- Використовуйте числові ID в `allowFrom`/`groupAllowFrom`/`groups` або точні імена друзів/груп. +- Використовуйте числові ID в `allowFrom`/`groupAllowFrom` і стабільні ID груп у `groups`. Якщо вам навмисно потрібні точні імена друзів/груп, увімкніть `channels.zalouser.dangerouslyAllowNameMatching: true`. -**Оновлено зі старого налаштування на основі CLI:** +**Оновлено зі старого налаштування на базі CLI:** -- Видаліть будь-які старі припущення щодо зовнішнього процесу `zca`. -- Канал тепер повністю працює в OpenClaw без зовнішніх двійкових файлів CLI. +- Приберіть будь-які старі припущення про зовнішній процес `zca`. +- Канал тепер повністю працює в OpenClaw без зовнішніх CLI-бінарників. ## Пов’язане - [Огляд каналів](/uk/channels) — усі підтримувані канали -- [Pairing](/uk/channels/pairing) — автентифікація DM і потік pairing -- [Групи](/uk/channels/groups) — поведінка групового чату та обмеження згадуванням +- [Pairing](/uk/channels/pairing) — автентифікація DM та процес pairing +- [Групи](/uk/channels/groups) — поведінка групових чатів і обмеження згадок - [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень -- [Безпека](/uk/gateway/security) — модель доступу та посилення захисту +- [Безпека](/uk/gateway/security) — модель доступу та зміцнення