chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
24fcca87e6
commit
54bd3e3461
@ -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.
|
||||
|
||||
<Warning>
|
||||
Це неофіційна інтеграція, яка може призвести до призупинення або блокування облікового запису. Використовуйте на власний ризик.
|
||||
@ -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 <code>`
|
||||
|
||||
## Доступ до груп (необов’язково)
|
||||
|
||||
- За замовчуванням: `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.<group>.requireMention` керує тим, чи потрібна згадка для відповідей у групі.
|
||||
- Порядок розв’язання: точний ID/назва групи -> нормалізований slug групи -> `*` -> значення за замовчуванням (`true`).
|
||||
- Це застосовується як до груп в allowlist, так і до відкритого групового режиму.
|
||||
- Цитування повідомлення бота вважається неявною згадкою для активації в групі.
|
||||
- Авторизовані керівні команди (наприклад, `/new`) можуть обходити обмеження згадуванням.
|
||||
- Коли групове повідомлення пропускається, бо потрібна згадка, OpenClaw зберігає його як очікувану групову історію та додає до наступного обробленого групового повідомлення.
|
||||
- Ліміт групової історії за замовчуванням дорівнює `messages.groupChat.historyLimit` (fallback `50`). Його можна перевизначити для кожного облікового запису через `channels.zalouser.historyLimit`.
|
||||
- `channels.zalouser.groups.<group>.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) — модель доступу та зміцнення
|
||||
|
||||
Loading…
Reference in New Issue
Block a user