---
read_when:
    - Робота над функціями каналу Tlon/Urbit
summary: Стан підтримки Tlon/Urbit, можливості та конфігурація
title: Tlon
x-i18n:
    generated_at: "2026-05-03T22:20:27Z"
    model: gpt-5.5
    provider: openai
    source_hash: 1718044541b431ff2437508e7e6659c14206f4aa84ab8b207e0d791dea2a48c5
    source_path: channels/tlon.md
    workflow: 16
---

Tlon — це децентралізований месенджер, побудований на Urbit. OpenClaw підключається до вашого Urbit ship і може
відповідати на DM та повідомлення групових чатів. Для групових відповідей за замовчуванням потрібна @-згадка, і їх можна
додатково обмежити через allowlist.

Стан: вбудований plugin. Підтримуються DM, групові згадки, відповіді в гілках, форматування розширеного тексту та
завантаження зображень. Реакції та опитування поки не підтримуються.

## Вбудований plugin

Tlon постачається як вбудований plugin у поточних випусках OpenClaw, тож звичайні пакетовані
збірки не потребують окремого встановлення.

Якщо у вас старіша збірка або власне встановлення, яке не містить Tlon, встановіть
поточний npm-пакет:

Встановлення через CLI (npm registry):

```bash
openclaw plugins install @openclaw/tlon
```

Використовуйте пакет без версії, щоб стежити за поточним офіційним тегом випуску. Закріплюйте точну
версію лише тоді, коли потрібне відтворюване встановлення.

Локальний checkout (під час запуску з git-репозиторію):

```bash
openclaw plugins install ./path/to/local/tlon-plugin
```

Докладніше: [Plugins](/uk/tools/plugin)

## Налаштування

1. Переконайтеся, що plugin Tlon доступний.
   - Поточні пакетовані випуски OpenClaw уже містять його.
   - Старіші/власні встановлення можуть додати його вручну командами вище.
2. Зберіть URL вашого ship і код входу.
3. Налаштуйте `channels.tlon`.
4. Перезапустіть gateway.
5. Надішліть DM боту або згадайте його в груповому каналі.

Мінімальна конфігурація (один обліковий запис):

```json5
{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
      ownerShip: "~your-main-ship", // recommended: your ship, always allowed
    },
  },
}
```

## Приватні/LAN ship

За замовчуванням OpenClaw блокує приватні/внутрішні імена хостів та діапазони IP для захисту від SSRF.
Якщо ваш ship працює в приватній мережі (localhost, LAN IP або внутрішнє ім'я хоста),
потрібно явно ввімкнути це:

```json5
{
  channels: {
    tlon: {
      url: "http://localhost:8080",
      allowPrivateNetwork: true,
    },
  },
}
```

Це стосується URL на кшталт:

- `http://localhost:8080`
- `http://192.168.x.x:8080`
- `http://my-ship.local:8080`

⚠️ Вмикайте це лише якщо довіряєте своїй локальній мережі. Це налаштування вимикає захист від SSRF
для запитів до URL вашого ship.

## Групові канали

Автовиявлення ввімкнено за замовчуванням. Також можна закріпити канали вручну:

```json5
{
  channels: {
    tlon: {
      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
    },
  },
}
```

Вимкнення автовиявлення:

```json5
{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}
```

## Контроль доступу

Allowlist для DM (порожній = DM не дозволені, використовуйте `ownerShip` для потоку схвалення):

```json5
{
  channels: {
    tlon: {
      dmAllowlist: ["~zod", "~nec"],
    },
  },
}
```

Авторизація груп (обмежена за замовчуванням):

```json5
{
  channels: {
    tlon: {
      defaultAuthorizedShips: ["~zod"],
      authorization: {
        channelRules: {
          "chat/~host-ship/general": {
            mode: "restricted",
            allowedShips: ["~zod", "~nec"],
          },
          "chat/~host-ship/announcements": {
            mode: "open",
          },
        },
      },
    },
  },
}
```

## Власник і система схвалення

Задайте ship власника, щоб отримувати запити на схвалення, коли неавторизовані користувачі намагаються взаємодіяти:

```json5
{
  channels: {
    tlon: {
      ownerShip: "~your-main-ship",
    },
  },
}
```

Ship власника **автоматично авторизований усюди** — запрошення в DM приймаються автоматично, а
повідомлення в каналах завжди дозволені. Вам не потрібно додавати власника до `dmAllowlist` або
`defaultAuthorizedShips`.

Якщо це налаштовано, власник отримує DM-сповіщення для:

- Запитів DM від ship, яких немає в allowlist
- Згадок у каналах без авторизації
- Запитів на групові запрошення

## Налаштування автоматичного прийняття

Автоматично приймати запрошення в DM (для ship у dmAllowlist):

```json5
{
  channels: {
    tlon: {
      autoAcceptDmInvites: true,
    },
  },
}
```

Автоматично приймати групові запрошення від довірених ship:

```json5
{
  channels: {
    tlon: {
      autoAcceptGroupInvites: true,
      groupInviteAllowlist: ["~zod"],
    },
  },
}
```

`autoAcceptGroupInvites` завершується закрито, коли `groupInviteAllowlist` порожній. Задайте
allowlist для ship, чиї групові запрошення слід приймати автоматично.

## Цілі доставлення (CLI/cron)

Використовуйте їх із `openclaw message send` або доставленням через cron:

- DM: `~sampel-palnet` або `dm/~sampel-palnet`
- Група: `chat/~host-ship/channel` або `group:~host-ship/channel`

## Вбудований skill

Plugin Tlon містить вбудований skill ([`@tloncorp/tlon-skill`](https://github.com/tloncorp/tlon-skill)),
який надає CLI-доступ до операцій Tlon:

- **Контакти**: отримувати/оновлювати профілі, перелічувати контакти
- **Канали**: перелічувати, створювати, публікувати повідомлення, отримувати історію
- **Групи**: перелічувати, створювати, керувати учасниками
- **DM**: надсилати повідомлення, реагувати на повідомлення
- **Реакції**: додавати/видаляти emoji-реакції до дописів і DM
- **Налаштування**: керувати дозволами plugin через slash-команди

Skill автоматично доступний після встановлення plugin.

## Можливості

| Функція            | Стан                                               |
| ------------------ | -------------------------------------------------- |
| Прямі повідомлення | ✅ Підтримується                                   |
| Групи/канали       | ✅ Підтримується (за замовчуванням через згадку)   |
| Гілки              | ✅ Підтримується (автовідповіді в гілці)           |
| Розширений текст   | ✅ Markdown перетворюється у формат Tlon           |
| Зображення         | ✅ Завантажуються до сховища Tlon                  |
| Реакції            | ✅ Через [вбудований skill](#bundled-skill)        |
| Опитування         | ❌ Поки не підтримується                           |
| Нативні команди    | ✅ Підтримується (за замовчуванням лише власник)   |

## Усунення несправностей

Спершу виконайте цю послідовність:

```bash
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
```

Типові збої:

- **DM ігноруються**: відправника немає в `dmAllowlist`, і `ownerShip` не налаштовано для потоку схвалення.
- **Групові повідомлення ігноруються**: канал не виявлено або відправник не авторизований.
- **Помилки підключення**: перевірте, що URL ship доступний; увімкніть `allowPrivateNetwork` для локальних ship.
- **Помилки автентифікації**: переконайтеся, що код входу актуальний (коди змінюються).

## Довідник конфігурації

Повна конфігурація: [Конфігурація](/uk/gateway/configuration)

Параметри провайдера:

- `channels.tlon.enabled`: увімкнути/вимкнути запуск каналу.
- `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`: 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`: ship, авторизовані для всіх каналів.
- `channels.tlon.authorization.channelRules`: правила авторизації для кожного каналу.
- `channels.tlon.showModelSignature`: додавати назву моделі до повідомлень.

## Примітки

- Для групових відповідей потрібна згадка (наприклад, `~your-bot-ship`), щоб відповісти.
- Відповіді в гілках: якщо вхідне повідомлення в гілці, OpenClaw відповідає в цій гілці.
- Розширений текст: форматування Markdown (жирний, курсив, код, заголовки, списки) перетворюється в нативний формат Tlon.
- Зображення: URL завантажуються до сховища Tlon і вбудовуються як блоки зображень.

## Пов'язане

- [Огляд каналів](/uk/channels) — усі підтримувані канали
- [Pairing](/uk/channels/pairing) — автентифікація DM і потік pairing
- [Групи](/uk/channels/groups) — поведінка групового чату та обмеження через згадки
- [Маршрутизація каналів](/uk/channels/channel-routing) — маршрутизація сесій для повідомлень
- [Безпека](/uk/gateway/security) — модель доступу та посилення захисту