openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-27 20:59:58 +00:00
parent 965ebad489
commit 0a182a2d8d
1 changed files with 102 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

203
docs/uk/channels/feishu.md
View File

@ -2,29 +2,29 @@
read_when:
- Ви хочете підключити бота Feishu/Lark
- Ви налаштовуєте канал Feishu
summary: Огляд бота Feishu, функції та налаштування
summary: Огляд бота Feishu, функції та конфігурація
title: Feishu
x-i18n:
generated_at: "2026-04-27T10:57:54Z"
generated_at: "2026-04-27T20:59:00Z"
model: gpt-5.4
provider: openai
source_hash: f24fada0adea25fc4f2ea93a1c91af5a0fd86aebe90901aa20031c59a982a970
source_hash: b300f98fb3681e84a105de99b9e771b1f0fc6278ee2fda01a703b97fabf5dd63
source_path: channels/feishu.md
workflow: 15
---
# Feishu / Lark
Feishu/Lark — це універсальна платформа для співпраці, де команди спілкуються в чаті, діляться документами, керують календарями та спільно виконують роботу.
Feishu/Lark — це універсальна платформа для співпраці, де команди спілкуються в чаті, діляться документами, керують календарями та працюють разом.
**Статус:** готово до використання в продакшені для особистих повідомлень боту та групових чатів. WebSocket — режим за замовчуванням; режим webhook є необов’язковим.
**Статус:** готовий до використання у production для особистих повідомлень бота та групових чатів. WebSocket — режим за замовчуванням; режим Webhook — необов’язковий.
---
## Швидкий старт
<Note>
Потрібен OpenClaw 2026.4.25 або новіший. Щоб перевірити версію, запустіть `openclaw --version`. Оновіть за допомогою `openclaw update`.
Потрібен OpenClaw 2026.4.25 або новіший. Виконайте `openclaw --version`, щоб перевірити версію. Оновіть через `openclaw update`.
</Note>
<Steps>
@ -48,10 +48,10 @@ Feishu/Lark — це універсальна платформа для спів
### Особисті повідомлення
Налаштуйте `dmPolicy`, щоб керувати тим, хто може надсилати особисті повідомлення боту:
Налаштуйте `dmPolicy`, щоб керувати тим, хто може писати боту в особисті повідомлення:
- `"pairing"` — невідомі користувачі отримують код сполучення; схвалення виконується через CLI
- `"allowlist"` — лише користувачі, перелічені в `allowFrom`, можуть спілкуватися (типово: лише власник бота)
- `"pairing"` — невідомі користувачі отримують код сполучення; схвалення через CLI
- `"allowlist"` — писати можуть лише користувачі, перелічені в `allowFrom` (типово: лише власник бота)
- `"open"` — дозволити всіх користувачів
- `"disabled"` — вимкнути всі особисті повідомлення
@ -66,11 +66,11 @@ openclaw pairing approve feishu <CODE>
**Політика груп** (`channels.feishu.groupPolicy`):
| Value | Поведінка |
| ------------- | ------------------------------------------ |
| `"open"` | Відповідати на всі повідомлення в групах |
| `"allowlist"` | Відповідати лише в групах із `groupAllowFrom` |
| `"disabled"` | Вимкнути всі групові повідомлення |
| Value | Поведінка |
| ------------- | --------------------------------------------------------------------------------------------- |
| `"open"` | Відповідати на всі повідомлення в групах |
| `"allowlist"` | Відповідати лише в групах із `groupAllowFrom` або явно налаштованих у `groups.<chat_id>` |
| `"disabled"` | Вимкнути всі повідомлення в групах |
Типове значення: `allowlist`
@ -79,11 +79,11 @@ openclaw pairing approve feishu <CODE>
- `true` — вимагати @згадку (типово)
- `false` — відповідати без @згадки
- Перевизначення для окремої групи: `channels.feishu.groups.<chat_id>.requireMention`
- Згадки лише для широкого сповіщення `@all` і `@_all` не вважаються згадками бота. Повідомлення, яке містить і `@all`, і пряму згадку бота, усе одно вважається згадкою бота.
- Згадки лише для широкого оповіщення `@all` і `@_all` не вважаються згадкою бота. Повідомлення, яке містить і `@all`, і пряму згадку бота, усе одно вважається згадкою бота.
---
## Приклади налаштування груп
## Приклади конфігурації груп
### Дозволити всі групи, без обов’язкової @згадки
@ -117,13 +117,30 @@ openclaw pairing approve feishu <CODE>
channels: {
feishu: {
groupPolicy: "allowlist",
// Ідентифікатори груп мають вигляд: oc_xxx
// Ідентифікатори груп мають такий вигляд: oc_xxx
groupAllowFrom: ["oc_xxx", "oc_yyy"],
},
},
}
```
Ви також можете дозволити групу, додавши явний запис `groups.<chat_id>`. Шаблонні значення за замовчуванням у `groups.*` налаштовують відповідні групи, але самі по собі не надають доступу групам.
```json5
{
channels: {
feishu: {
groupPolicy: "allowlist",
groups: {
oc_xxx: {
requireMention: false,
},
},
},
},
}
```
### Обмежити відправників у межах групи
```json5
@ -134,7 +151,7 @@ openclaw pairing approve feishu <CODE>
groupAllowFrom: ["oc_xxx"],
groups: {
oc_xxx: {
// open_id користувачів мають вигляд: ou_xxx
// open_id користувачів мають такий вигляд: ou_xxx
allowFrom: ["ou_user1", "ou_user2"],
},
},
@ -151,9 +168,9 @@ openclaw pairing approve feishu <CODE>
### ID груп (`chat_id`, формат: `oc_xxx`)
Відкрийте групу у Feishu/Lark, натисніть значок меню у верхньому правому куті та перейдіть до **Settings**. ID групи (`chat_id`) вказано на сторінці налаштувань.
Відкрийте групу у Feishu/Lark, натисніть значок меню у верхньому правому куті та перейдіть у **Settings**. ID групи (`chat_id`) указано на сторінці налаштувань.
![Отримання ID групи](/images/feishu-get-group-id.png)
![Get Group ID](/images/feishu-get-group-id.png)
### ID користувачів (`open_id`, формат: `ou_xxx`)
@ -163,7 +180,7 @@ openclaw pairing approve feishu <CODE>
openclaw logs --follow
```
Знайдіть `open_id` у виводі журналу. Ви також можете перевірити запити на сполучення, що очікують на розгляд:
Знайдіть `open_id` у виводі журналу. Ви також можете перевірити запити на сполучення, що очікують:
```bash
openclaw pairing list feishu
@ -175,17 +192,17 @@ openclaw pairing list feishu
| Command | Опис |
| --------- | ---------------------------- |
| `/status` | Показати стан бота |
| `/status` | Показати статус бота |
| `/reset` | Скинути поточну сесію |
| `/model` | Показати або змінити AI-модель |
<Note>
Feishu/Lark не підтримує вбудовані меню slash-команд, тож надсилайте їх як звичайні текстові повідомлення.
Feishu/Lark не підтримує нативні меню slash-команд, тому надсилайте їх як звичайні текстові повідомлення.
</Note>
---
## Усунення несправностей
## Усунення неполадок
### Бот не відповідає в групових чатах
@ -196,22 +213,22 @@ Feishu/Lark не підтримує вбудовані меню slash-коман
### Бот не отримує повідомлення
1. Переконайтеся, що бота опубліковано та схвалено в Feishu Open Platform / Lark Developer
1. Переконайтеся, що бота опубліковано та схвалено у Feishu Open Platform / Lark Developer
2. Переконайтеся, що підписка на події містить `im.message.receive_v1`
3. Переконайтеся, що вибрано **persistent connection** (WebSocket)
4. Переконайтеся, що надано всі необхідні дозволи
4. Переконайтеся, що надано всі потрібні дозволи
5. Переконайтеся, що Gateway запущено: `openclaw gateway status`
6. Перевірте журнали: `openclaw logs --follow`
### Витік App Secret
### App Secret витік
1. Скиньте App Secret у Feishu Open Platform / Lark Developer
2. Оновіть значення у своїй конфігурації
2. Оновіть значення у вашій конфігурації
3. Перезапустіть Gateway: `openclaw gateway restart`
---
## Розширене налаштування
## Розширена конфігурація
### Кілька облікових записів
@ -243,26 +260,27 @@ Feishu/Lark не підтримує вбудовані меню slash-коман
}
```
`defaultAccount` визначає, який обліковий запис використовується, коли вихідні API не вказують `accountId`.
`accounts.<id>.tts` використовує ту саму структуру, що й `messages.tts`, і глибоко об’єднується поверх
глобальної конфігурації TTS, тож у багатоботних конфігураціях Feishu можна зберігати спільні
облікові дані провайдерів глобально, перевизначаючи для кожного облікового запису лише голос, модель, персону або автоматичний режим.
`defaultAccount` керує тим, який обліковий запис використовується, коли вихідні API не вказують `accountId`.
`accounts.<id>.tts` використовує ту саму структуру, що й `messages.tts`, і виконує глибоке злиття поверх
глобальної конфігурації TTS, тож конфігурації Feishu з кількома ботами можуть
зберігати спільні облікові дані провайдера глобально, перевизначаючи лише голос, модель, персону або автоматичний режим
для кожного облікового запису.
### Ліміти повідомлень
### Обмеження повідомлень
- `textChunkLimit` — розмір фрагмента вихідного тексту (типово: `2000` символів)
- `mediaMaxMb` — ліміт завантаження/вивантаження медіа (типово: `30` МБ)
### Потокове передавання
### Потокова передача
Feishu/Lark підтримує потокові відповіді через інтерактивні картки. Коли цю функцію ввімкнено, бот оновлює картку в реальному часі під час генерування тексту.
Feishu/Lark підтримує потокові відповіді через інтерактивні картки. Якщо це ввімкнено, бот оновлює картку в реальному часі під час генерування тексту.
```json5
{
channels: {
feishu: {
streaming: true, // увімкнути виведення потокових карток (типово: true)
blockStreaming: true, // увімкнути потокове передавання на рівні блоків (типово: true)
streaming: true, // увімкнути виведення потокової картки (типово: true)
blockStreaming: true, // увімкнути потокову передачу на рівні блоків (типово: true)
},
},
}
@ -270,12 +288,12 @@ Feishu/Lark підтримує потокові відповіді через і
Установіть `streaming: false`, щоб надсилати повну відповідь одним повідомленням.
### Оптимізація квоти
### Оптимізація квот
Зменште кількість викликів API Feishu/Lark за допомогою двох необов’язкових прапорців:
- `typingIndicator` (типово `true`): установіть `false`, щоб не виконувати виклики реакції набору тексту
- `resolveSenderNames` (типово `true`): установіть `false`, щоб не виконувати пошук профілів відправників
- `typingIndicator` (типово `true`): установіть `false`, щоб пропустити виклики реакції набору тексту
- `resolveSenderNames` (типово `true`): установіть `false`, щоб пропустити пошук профілю відправника
```json5
{
@ -290,7 +308,7 @@ Feishu/Lark підтримує потокові відповіді через і
### Сесії ACP
Feishu/Lark підтримує ACP для особистих повідомлень і повідомлень у гілках груп. ACP у Feishu/Lark керується текстовими командами — вбудованих меню slash-команд немає, тож використовуйте повідомлення `/acp ...` безпосередньо в розмові.
Feishu/Lark підтримує ACP для особистих повідомлень і повідомлень у гілках груп. ACP у Feishu/Lark керується текстовими командами — нативних меню slash-команд немає, тому використовуйте повідомлення `/acp ...` безпосередньо в розмові.
#### Постійна прив’язка ACP
@ -338,17 +356,17 @@ Feishu/Lark підтримує ACP для особистих повідомле
#### Запуск ACP із чату
У особистих повідомленнях або гілці Feishu/Lark:
У особистому повідомленні або гілці Feishu/Lark:
```text
/acp spawn codex --thread here
```
`--thread here` працює для особистих повідомлень і повідомлень у гілках Feishu/Lark. Подальші повідомлення в прив’язаній розмові спрямовуються безпосередньо до цієї сесії ACP.
`--thread here` працює для особистих повідомлень і повідомлень у гілках Feishu/Lark. Подальші повідомлення в прив’язаній розмові надсилаються безпосередньо до цієї сесії ACP.
### Маршрутизація між кількома агентами
Використовуйте `bindings`, щоб спрямовувати особисті повідомлення або групи Feishu/Lark до різних агентів.
Використовуйте `bindings`, щоб маршрутизувати особисті повідомлення або групи Feishu/Lark до різних агентів.
```json5
{
@ -381,45 +399,45 @@ Feishu/Lark підтримує ACP для особистих повідомле
Поля маршрутизації:
- `match.channel`: `"feishu"`
- `match.peer.kind`: `"direct"` (особисті повідомлення) або `"group"` (груповий чат)
- `match.peer.kind`: `"direct"` (особисте повідомлення) або `"group"` (груповий чат)
- `match.peer.id`: Open ID користувача (`ou_xxx`) або ID групи (`oc_xxx`)
Поради щодо пошуку дивіться в розділі [Отримання ID груп/користувачів](#get-groupuser-ids).
Поради щодо пошуку див. у [Отримання ID груп/користувачів](#get-groupuser-ids).
---
## Довідник з конфігурації
## Довідник із конфігурації
Повна конфігурація: [Конфігурація Gateway](/uk/gateway/configuration)
| Setting | Опис | Default |
| ------------------------------------------------- | -------------------------------------------- | ---------------- |
| `channels.feishu.enabled` | Увімкнути/вимкнути канал | `true` |
| `channels.feishu.domain` | Домен API (`feishu` або `lark`) | `feishu` |
| `channels.feishu.connectionMode` | Передавання подій (`websocket` або `webhook`) | `websocket` |
| `channels.feishu.defaultAccount` | Типовий обліковий запис для вихідної маршрутизації | `default` |
| `channels.feishu.verificationToken` | Потрібний для режиму webhook | — |
| `channels.feishu.encryptKey` | Потрібний для режиму webhook | — |
| `channels.feishu.webhookPath` | Шлях маршруту webhook | `/feishu/events` |
| `channels.feishu.webhookHost` | Хост прив’язки webhook | `127.0.0.1` |
| `channels.feishu.webhookPort` | Порт прив’язки webhook | `3000` |
| `channels.feishu.accounts.<id>.appId` | ID застосунку | — |
| `channels.feishu.accounts.<id>.appSecret` | App Secret | — |
| `channels.feishu.accounts.<id>.domain` | Перевизначення домену для облікового запису | `feishu` |
| `channels.feishu.accounts.<id>.tts` | Перевизначення TTS для облікового запису | `messages.tts` |
| `channels.feishu.dmPolicy` | Політика особистих повідомлень | `allowlist` |
| `channels.feishu.allowFrom` | Список дозволених для особистих повідомлень (список `open_id`) | [BotOwnerId] |
| `channels.feishu.groupPolicy` | Політика груп | `allowlist` |
| `channels.feishu.groupAllowFrom` | Список дозволених груп | — |
| `channels.feishu.requireMention` | Вимагати @згадку в групах | `true` |
| `channels.feishu.groups.<chat_id>.requireMention` | Перевизначення @згадки для окремої групи | inherited |
| `channels.feishu.groups.<chat_id>.enabled` | Увімкнути/вимкнути окрему групу | `true` |
| `channels.feishu.textChunkLimit` | Розмір фрагмента повідомлення | `2000` |
| `channels.feishu.mediaMaxMb` | Ліміт розміру медіа | `30` |
| `channels.feishu.streaming` | Виведення потокових карток | `true` |
| `channels.feishu.blockStreaming` | Потокове передавання на рівні блоків | `true` |
| `channels.feishu.typingIndicator` | Надсилати реакції набору тексту | `true` |
| `channels.feishu.resolveSenderNames` | Визначати відображувані імена відправників | `true` |
| Setting | Опис | Default |
| ------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------- |
| `channels.feishu.enabled` | Увімкнути/вимкнути канал | `true` |
| `channels.feishu.domain` | Домен API (`feishu` або `lark`) | `feishu` |
| `channels.feishu.connectionMode` | Транспорт подій (`websocket` або `webhook`) | `websocket` |
| `channels.feishu.defaultAccount` | Обліковий запис за замовчуванням для вихідної маршрутизації | `default` |
| `channels.feishu.verificationToken` | Потрібно для режиму webhook | — |
| `channels.feishu.encryptKey` | Потрібно для режиму webhook | — |
| `channels.feishu.webhookPath` | Шлях маршруту webhook | `/feishu/events` |
| `channels.feishu.webhookHost` | Хост прив’язки webhook | `127.0.0.1` |
| `channels.feishu.webhookPort` | Порт прив’язки webhook | `3000` |
| `channels.feishu.accounts.<id>.appId` | ID застосунку | — |
| `channels.feishu.accounts.<id>.appSecret` | App Secret | — |
| `channels.feishu.accounts.<id>.domain` | Перевизначення домену для окремого облікового запису | `feishu` |
| `channels.feishu.accounts.<id>.tts` | Перевизначення TTS для окремого облікового запису | `messages.tts` |
| `channels.feishu.dmPolicy` | Політика особистих повідомлень | `allowlist` |
| `channels.feishu.allowFrom` | Список дозволених для особистих повідомлень (`open_id`) | [BotOwnerId] |
| `channels.feishu.groupPolicy` | Політика груп | `allowlist` |
| `channels.feishu.groupAllowFrom` | Список дозволених груп | — |
| `channels.feishu.requireMention` | Вимагати @згадку в групах | `true` |
| `channels.feishu.groups.<chat_id>.requireMention` | Перевизначення @згадки для окремої групи; явні ID також додають групу в режимі allowlist | inherited |
| `channels.feishu.groups.<chat_id>.enabled` | Увімкнути/вимкнути конкретну групу | `true` |
| `channels.feishu.textChunkLimit` | Розмір фрагмента повідомлення | `2000` |
| `channels.feishu.mediaMaxMb` | Ліміт розміру медіа | `30` |
| `channels.feishu.streaming` | Потокове виведення карток | `true` |
| `channels.feishu.blockStreaming` | Потокова передача на рівні блоків | `true` |
| `channels.feishu.typingIndicator` | Надсилати реакції набору тексту | `true` |
| `channels.feishu.resolveSenderNames` | Визначати відображувані імена відправників | `true` |
---
@ -435,14 +453,7 @@ Feishu/Lark підтримує ACP для особистих повідомле
- ✅ Відео/медіа
- ✅ Стікери
Вхідні аудіоповідомлення Feishu/Lark нормалізуються як заповнювачі медіа замість
необробленого JSON `file_key`. Коли налаштовано `tools.media.audio`, OpenClaw
завантажує ресурс голосового повідомлення та виконує спільну транскрипцію аудіо перед
ходом агента, тож агент отримує розшифрований текст мовлення. Якщо Feishu уже містить
текст транскрипції безпосередньо в аудіокорисному навантаженні, цей текст використовується без додаткового
виклику ASR. Без провайдера транскрипції аудіо агент усе одно отримує
заповнювач `<media:audio>` разом зі збереженим вкладенням, а не необроблене корисне навантаження
ресурсу Feishu.
Вхідні аудіоповідомлення Feishu/Lark нормалізуються як заповнювачі медіа, а не як необроблений JSON `file_key`. Коли налаштовано `tools.media.audio`, OpenClaw завантажує ресурс голосового повідомлення та запускає спільну транскрипцію аудіо перед ходом агента, тож агент отримує розшифрований мовний текст. Якщо Feishu безпосередньо містить текст транскрипції в аудіонавантаженні, цей текст використовується без додаткового виклику ASR. Без провайдера транскрипції аудіо агент усе одно отримує заповнювач `<media:audio>` разом зі збереженим вкладенням, а не необроблене навантаження ресурсу Feishu.
### Надсилання
@ -451,16 +462,10 @@ Feishu/Lark підтримує ACP для особистих повідомле
- ✅ Файли
- ✅ Аудіо
- ✅ Відео/медіа
- ✅ Інтерактивні картки (зокрема з потоковими оновленнями)
- ⚠️ Форматований текст (форматування у стилі post; не підтримує всі можливості авторингу Feishu/Lark)
- ✅ Інтерактивні картки (включно з потоковими оновленнями)
- ⚠️ Форматований текст (стиль post; не підтримує всі можливості створення вмісту Feishu/Lark)
Власні аудіобульбашки Feishu/Lark використовують тип повідомлення Feishu `audio` і потребують
завантаження медіа у форматі Ogg/Opus (`file_type: "opus"`). Наявні медіафайли `.opus` і `.ogg`
надсилаються безпосередньо як вбудоване аудіо. MP3/WAV/M4A та інші ймовірні аудіоформати
перекодовуються в 48 кГц Ogg/Opus за допомогою `ffmpeg` лише тоді, коли відповідь запитує
голосову доставку (`audioAsVoice` / інструмент повідомлень `asVoice`, зокрема голосові
відповіді TTS у форматі голосових нотаток). Звичайні вкладення MP3 залишаються звичайними файлами. Якщо `ffmpeg` відсутній або
перетворення не вдається, OpenClaw повертається до вкладення файлу та записує причину в журнал.
Нативні аудіобабли Feishu/Lark використовують тип повідомлення Feishu `audio` і потребують завантаження медіа у форматі Ogg/Opus (`file_type: "opus"`). Наявні медіафайли `.opus` і `.ogg` надсилаються напряму як нативне аудіо. MP3/WAV/M4A та інші ймовірні аудіоформати перекодовуються в 48 кГц Ogg/Opus за допомогою `ffmpeg` лише тоді, коли відповідь запитує голосову доставку (`audioAsVoice` / інструмент повідомлень `asVoice`, включно з голосовими відповідями TTS). Звичайні вкладення MP3 залишаються звичайними файлами. Якщо `ffmpeg` відсутній або конвертація не вдається, OpenClaw повертається до вкладення файлу та записує причину в журнал.
### Гілки та відповіді
@ -468,18 +473,14 @@ Feishu/Lark підтримує ACP для особистих повідомле
- ✅ Відповіді в гілках
- ✅ Відповіді з медіа зберігають прив’язку до гілки під час відповіді на повідомлення в гілці
Для `groupSessionScope: "group_topic"` і `"group_topic_sender"` власні
тематичні групи Feishu/Lark використовують `thread_id` (`omt_*`) події як канонічний ключ
сесії теми. Звичайні групові відповіді, які OpenClaw перетворює на гілки, і далі
використовують ID кореневого повідомлення відповіді (`om_*`), щоб перший хід і подальший хід
залишалися в одній сесії.
Для `groupSessionScope: "group_topic"` і `"group_topic_sender"` нативні тематичні групи Feishu/Lark використовують `thread_id` події (`omt_*`) як канонічний ключ сесії теми. Звичайні групові відповіді, які OpenClaw перетворює на гілки, продовжують використовувати ID кореневого повідомлення відповіді (`om_*`), щоб перший і наступний ходи залишалися в одній сесії.
---
## Пов’язане
- [Огляд каналів](/uk/channels) — усі підтримувані канали
- [Сполучення](/uk/channels/pairing) — автентифікація в особистих повідомленнях і процес сполучення
- [Групи](/uk/channels/groups) — поведінка групового чату та керування згадками
- [Сполучення](/uk/channels/pairing) — автентифікація особистих повідомлень і процес сполучення
- [Групи](/uk/channels/groups) — поведінка групових чатів і керування згадками
- [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень
- [Безпека](/uk/gateway/security) — модель доступу та посилення захисту
- [Безпека](/uk/gateway/security) — модель доступу та захист системи