diff --git a/docs/uk/channels/tlon.md b/docs/uk/channels/tlon.md index 9067b3b83..a1f2082be 100644 --- a/docs/uk/channels/tlon.md +++ b/docs/uk/channels/tlon.md @@ -1,40 +1,40 @@ --- read_when: - Робота над функціями каналу Tlon/Urbit -summary: Статус підтримки, можливості та конфігурація Tlon/Urbit +summary: Стан підтримки Tlon/Urbit, можливості та конфігурація title: Tlon x-i18n: - generated_at: "2026-05-02T21:58:34Z" + generated_at: "2026-05-03T22:20:27Z" model: gpt-5.5 provider: openai - source_hash: 30915170786fc1ee8b84fb8be2ea42280262923064cfa9ca7107036096a13add + source_hash: 1718044541b431ff2437508e7e6659c14206f4aa84ab8b207e0d791dea2a48c5 source_path: channels/tlon.md workflow: 16 --- Tlon — це децентралізований месенджер, побудований на Urbit. OpenClaw підключається до вашого Urbit ship і може -відповідати на DM та повідомлення групових чатів. Групові відповіді за замовчуванням потребують @-згадки, і їх можна -додатково обмежити за допомогою allowlist. +відповідати на DM та повідомлення групових чатів. Для групових відповідей за замовчуванням потрібна @-згадка, і їх можна +додатково обмежити через allowlist. -Статус: вбудований plugin. Підтримуються DM, групові згадки, відповіді в тредах, форматування rich text і -завантаження зображень. Реакції та опитування ще не підтримуються. +Стан: вбудований plugin. Підтримуються DM, групові згадки, відповіді в гілках, форматування розширеного тексту та +завантаження зображень. Реакції та опитування поки не підтримуються. ## Вбудований plugin -Tlon постачається як вбудований plugin у поточних випусках OpenClaw, тому звичайні пакетовані +Tlon постачається як вбудований plugin у поточних випусках OpenClaw, тож звичайні пакетовані збірки не потребують окремого встановлення. -Якщо ви використовуєте старішу збірку або спеціальне встановлення, яке не містить Tlon, установіть +Якщо у вас старіша збірка або власне встановлення, яке не містить Tlon, встановіть поточний npm-пакет: -Установлення через CLI (npm registry): +Встановлення через CLI (npm registry): ```bash openclaw plugins install @openclaw/tlon ``` -Використовуйте базовий пакет, щоб стежити за поточним офіційним тегом випуску. Закріплюйте точну -версію лише тоді, коли вам потрібне відтворюване встановлення. +Використовуйте пакет без версії, щоб стежити за поточним офіційним тегом випуску. Закріплюйте точну +версію лише тоді, коли потрібне відтворюване встановлення. Локальний checkout (під час запуску з git-репозиторію): @@ -48,11 +48,11 @@ openclaw plugins install ./path/to/local/tlon-plugin 1. Переконайтеся, що plugin Tlon доступний. - Поточні пакетовані випуски OpenClaw уже містять його. - - Старіші/спеціальні встановлення можуть додати його вручну за допомогою команд вище. + - Старіші/власні встановлення можуть додати його вручну командами вище. 2. Зберіть URL вашого ship і код входу. 3. Налаштуйте `channels.tlon`. 4. Перезапустіть gateway. -5. Надішліть боту DM або згадайте його в груповому каналі. +5. Надішліть DM боту або згадайте його в груповому каналі. Мінімальна конфігурація (один обліковий запис): @@ -70,10 +70,10 @@ openclaw plugins install ./path/to/local/tlon-plugin } ``` -## Приватні/LAN ships +## Приватні/LAN ship -За замовчуванням OpenClaw блокує приватні/внутрішні імена хостів і діапазони IP для захисту від SSRF. -Якщо ваш ship працює в приватній мережі (localhost, LAN IP або внутрішнє ім’я хоста), +За замовчуванням OpenClaw блокує приватні/внутрішні імена хостів та діапазони IP для захисту від SSRF. +Якщо ваш ship працює в приватній мережі (localhost, LAN IP або внутрішнє ім'я хоста), потрібно явно ввімкнути це: ```json5 @@ -87,18 +87,18 @@ openclaw plugins install ./path/to/local/tlon-plugin } ``` -Це застосовується до URL на кшталт: +Це стосується URL на кшталт: - `http://localhost:8080` - `http://192.168.x.x:8080` - `http://my-ship.local:8080` -⚠️ Вмикайте це лише якщо довіряєте своїй локальній мережі. Цей параметр вимикає захист від SSRF +⚠️ Вмикайте це лише якщо довіряєте своїй локальній мережі. Це налаштування вимикає захист від SSRF для запитів до URL вашого ship. ## Групові канали -Автоматичне виявлення ввімкнено за замовчуванням. Також можна закріпити канали вручну: +Автовиявлення ввімкнено за замовчуванням. Також можна закріпити канали вручну: ```json5 { @@ -110,7 +110,7 @@ openclaw plugins install ./path/to/local/tlon-plugin } ``` -Вимкнення автоматичного виявлення: +Вимкнення автовиявлення: ```json5 { @@ -124,7 +124,7 @@ openclaw plugins install ./path/to/local/tlon-plugin ## Контроль доступу -Allowlist для DM (порожній = DM заборонені, використовуйте `ownerShip` для процесу схвалення): +Allowlist для DM (порожній = DM не дозволені, використовуйте `ownerShip` для потоку схвалення): ```json5 { @@ -161,7 +161,7 @@ Allowlist для DM (порожній = DM заборонені, викорис ## Власник і система схвалення -Налаштуйте owner ship, щоб отримувати запити на схвалення, коли неавторизовані користувачі намагаються взаємодіяти: +Задайте ship власника, щоб отримувати запити на схвалення, коли неавторизовані користувачі намагаються взаємодіяти: ```json5 { @@ -173,19 +173,19 @@ Allowlist для DM (порожній = DM заборонені, викорис } ``` -Owner ship **автоматично авторизований всюди** — запрошення DM приймаються автоматично, а -повідомлення каналів завжди дозволені. Не потрібно додавати власника до `dmAllowlist` або +Ship власника **автоматично авторизований усюди** — запрошення в DM приймаються автоматично, а +повідомлення в каналах завжди дозволені. Вам не потрібно додавати власника до `dmAllowlist` або `defaultAuthorizedShips`. -Якщо це налаштовано, власник отримує DM-сповіщення про: +Якщо це налаштовано, власник отримує DM-сповіщення для: -- DM-запити від ships, яких немає в allowlist -- Згадки в каналах без авторизації -- Запити на групові запрошення +- Запитів DM від ship, яких немає в allowlist +- Згадок у каналах без авторизації +- Запитів на групові запрошення -## Параметри автоматичного прийняття +## Налаштування автоматичного прийняття -Автоматично приймати DM-запрошення (для ships у dmAllowlist): +Автоматично приймати запрошення в DM (для ship у dmAllowlist): ```json5 { @@ -197,21 +197,25 @@ Owner ship **автоматично авторизований всюди** — } ``` -Автоматично приймати групові запрошення: +Автоматично приймати групові запрошення від довірених ship: ```json5 { channels: { tlon: { autoAcceptGroupInvites: true, + groupInviteAllowlist: ["~zod"], }, }, } ``` +`autoAcceptGroupInvites` завершується закрито, коли `groupInviteAllowlist` порожній. Задайте +allowlist для ship, чиї групові запрошення слід приймати автоматично. + ## Цілі доставлення (CLI/cron) -Використовуйте їх з `openclaw message send` або доставленням cron: +Використовуйте їх із `openclaw message send` або доставленням через cron: - DM: `~sampel-palnet` або `dm/~sampel-palnet` - Група: `chat/~host-ship/channel` або `group:~host-ship/channel` @@ -221,27 +225,27 @@ Owner ship **автоматично авторизований всюди** — Plugin Tlon містить вбудований skill ([`@tloncorp/tlon-skill`](https://github.com/tloncorp/tlon-skill)), який надає CLI-доступ до операцій Tlon: -- **Контакти**: отримання/оновлення профілів, список контактів -- **Канали**: список, створення, публікація повідомлень, отримання історії -- **Групи**: список, створення, керування учасниками -- **DM**: надсилання повідомлень, реакції на повідомлення -- **Реакції**: додавання/видалення emoji-реакцій до дописів і DM -- **Налаштування**: керування дозволами plugin через slash commands +- **Контакти**: отримувати/оновлювати профілі, перелічувати контакти +- **Канали**: перелічувати, створювати, публікувати повідомлення, отримувати історію +- **Групи**: перелічувати, створювати, керувати учасниками +- **DM**: надсилати повідомлення, реагувати на повідомлення +- **Реакції**: додавати/видаляти emoji-реакції до дописів і DM +- **Налаштування**: керувати дозволами plugin через slash-команди -Skill автоматично доступний, коли plugin установлено. +Skill автоматично доступний після встановлення plugin. ## Можливості -| Функція | Статус | -| ----------------- | ------------------------------------------- | -| Прямі повідомлення | ✅ Підтримується | -| Групи/канали | ✅ Підтримується (за замовчуванням через згадки) | -| Треди | ✅ Підтримується (автовідповіді в треді) | -| Rich text | ✅ Markdown перетворюється у формат Tlon | -| Зображення | ✅ Завантажуються до сховища Tlon | -| Реакції | ✅ Через [вбудований skill](#bundled-skill) | -| Опитування | ❌ Ще не підтримується | -| Нативні команди | ✅ Підтримується (за замовчуванням лише для власника) | +| Функція | Стан | +| ------------------ | -------------------------------------------------- | +| Прямі повідомлення | ✅ Підтримується | +| Групи/канали | ✅ Підтримується (за замовчуванням через згадку) | +| Гілки | ✅ Підтримується (автовідповіді в гілці) | +| Розширений текст | ✅ Markdown перетворюється у формат Tlon | +| Зображення | ✅ Завантажуються до сховища Tlon | +| Реакції | ✅ Через [вбудований skill](#bundled-skill) | +| Опитування | ❌ Поки не підтримується | +| Нативні команди | ✅ Підтримується (за замовчуванням лише власник) | ## Усунення несправностей @@ -254,12 +258,12 @@ openclaw logs --follow openclaw doctor ``` -Поширені збої: +Типові збої: -- **DM ігноруються**: відправника немає в `dmAllowlist`, і `ownerShip` не налаштовано для процесу схвалення. +- **DM ігноруються**: відправника немає в `dmAllowlist`, і `ownerShip` не налаштовано для потоку схвалення. - **Групові повідомлення ігноруються**: канал не виявлено або відправник не авторизований. -- **Помилки підключення**: перевірте, чи URL ship доступний; увімкніть `allowPrivateNetwork` для локальних ships. -- **Помилки авторизації**: переконайтеся, що код входу актуальний (коди змінюються). +- **Помилки підключення**: перевірте, що URL ship доступний; увімкніть `allowPrivateNetwork` для локальних ship. +- **Помилки автентифікації**: переконайтеся, що код входу актуальний (коди змінюються). ## Довідник конфігурації @@ -268,31 +272,32 @@ openclaw doctor Параметри провайдера: - `channels.tlon.enabled`: увімкнути/вимкнути запуск каналу. -- `channels.tlon.ship`: ім’я Urbit ship бота (наприклад, `~sampel-palnet`). +- `channels.tlon.ship`: ім'я Urbit ship бота (наприклад, `~sampel-palnet`). - `channels.tlon.url`: URL ship (наприклад, `https://sampel-palnet.tlon.network`). - `channels.tlon.code`: код входу ship. - `channels.tlon.allowPrivateNetwork`: дозволити localhost/LAN URL (обхід SSRF). -- `channels.tlon.ownerShip`: owner ship для системи схвалення (завжди авторизований). -- `channels.tlon.dmAllowlist`: ships, яким дозволено надсилати DM (порожній = жодного). -- `channels.tlon.autoAcceptDmInvites`: автоматично приймати DM від ships з allowlist. -- `channels.tlon.autoAcceptGroupInvites`: автоматично приймати всі групові запрошення. +- `channels.tlon.ownerShip`: ship власника для системи схвалення (завжди авторизований). +- `channels.tlon.dmAllowlist`: ship, яким дозволено DM (порожній = жодного). +- `channels.tlon.autoAcceptDmInvites`: автоматично приймати DM від ship з allowlist. +- `channels.tlon.autoAcceptGroupInvites`: автоматично приймати групові запрошення від ship з allowlist. +- `channels.tlon.groupInviteAllowlist`: ship, чиї групові запрошення можна автоматично приймати. - `channels.tlon.autoDiscoverChannels`: автоматично виявляти групові канали (за замовчуванням: true). - `channels.tlon.groupChannels`: вручну закріплені channel nests. -- `channels.tlon.defaultAuthorizedShips`: ships, авторизовані для всіх каналів. +- `channels.tlon.defaultAuthorizedShips`: ship, авторизовані для всіх каналів. - `channels.tlon.authorization.channelRules`: правила авторизації для кожного каналу. - `channels.tlon.showModelSignature`: додавати назву моделі до повідомлень. ## Примітки -- Групові відповіді потребують згадки (наприклад, `~your-bot-ship`), щоб відповісти. -- Відповіді в тредах: якщо вхідне повідомлення в треді, OpenClaw відповідає в цьому треді. -- Rich text: форматування Markdown (жирний, курсив, код, заголовки, списки) перетворюється в нативний формат Tlon. +- Для групових відповідей потрібна згадка (наприклад, `~your-bot-ship`), щоб відповісти. +- Відповіді в гілках: якщо вхідне повідомлення в гілці, OpenClaw відповідає в цій гілці. +- Розширений текст: форматування Markdown (жирний, курсив, код, заголовки, списки) перетворюється в нативний формат Tlon. - Зображення: URL завантажуються до сховища Tlon і вбудовуються як блоки зображень. -## Пов’язане +## Пов'язане - [Огляд каналів](/uk/channels) — усі підтримувані канали -- [Pairing](/uk/channels/pairing) — автентифікація DM і процес pairing +- [Pairing](/uk/channels/pairing) — автентифікація DM і потік pairing - [Групи](/uk/channels/groups) — поведінка групового чату та обмеження через згадки -- [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сеансів для повідомлень +- [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень - [Безпека](/uk/gateway/security) — модель доступу та посилення захисту