Tlon

Tlon — децентрализованный мессенджер, построенный на Urbit. OpenClaw подключается к вашему кораблю Urbit и отвечает на личные сообщения и сообщения в групповых чатах. По умолчанию для ответов в группах требуется упоминание через @, а поверх этого действуют правила авторизации и процесс одобрения владельцем.

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

Встроенный плагин

Tlon входит в комплект текущих выпусков OpenClaw; для пакетных сборок отдельная установка не требуется.

В старой сборке или пользовательской установке, из которой он исключён, установите его из npm:

openclaw plugins install @openclaw/tlon

Используйте имя пакета без версии, чтобы отслеживать тег текущего выпуска. Закрепляйте версию (@openclaw/tlon@x.y.z) только для воспроизводимых установок.

Из локального рабочего дерева:

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

Подробнее: Плагины

Настройка

openclaw channels add --channel tlon --ship ~sampel-palnet --url https://your-ship-host --code lidlut-tabwed-pillex-ridrup

Либо измените конфигурацию напрямую:

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // рекомендуется: ваш корабль, всегда авторизован    },  },}

После прямого изменения конфигурации перезапустите Gateway. Затем отправьте боту личное сообщение или упомяните его через @ в групповом канале.

Частные корабли и корабли в локальной сети

По умолчанию OpenClaw блокирует частные и внутренние имена хостов и диапазоны IP-адресов для защиты от SSRF. Если ваш корабль работает в частной сети (localhost, IP-адрес локальной сети, внутреннее имя хоста), явно разрешите это:

{  channels: {    tlon: {      url: "http://localhost:8080",      network: {        dangerouslyAllowPrivateNetwork: true,      },    },  },}

Применяется к целевым адресам наподобие http://localhost:8080, http://192.168.x.x:8080 и http://my-ship.local:8080. Включайте это только для доверенного URL корабля; данная настройка отключает защиту от SSRF для HTTP-запросов этой учётной записи.

Групповые каналы

Закрепите каналы вручную либо включите автоматическое обнаружение:

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

Если autoDiscoverChannels не задан в конфигурации, его значение по умолчанию — false; в мастере настройки ответ на этот вопрос по умолчанию положительный, и мастер явно записывает true. Когда эта настройка включена, OpenClaw при запуске запрашивает присоединённые группы через scry, отслеживает новые каналы по мере принятия приглашений в группы и повторяет проверку каждые 2 минуты.

Управление доступом

Список разрешённых отправителей личных сообщений (пустой список = личные сообщения запрещены всем, кроме ownerShip):

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

По умолчанию для каждого канала используется режим авторизации restricted. Задайте defaultAuthorizedShips как базовый список и переопределяйте его для отдельных гнёзд каналов:

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

После того как бот ответит в ветке, он продолжает отвечать на последующие сообщения в этой ветке, не требуя нового упоминания.

Владелец и система одобрения

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

Корабль владельца авторизован везде: приглашения в личные сообщения всегда принимаются автоматически, приглашения в группы всегда принимаются автоматически, а сообщения в каналах всегда проходят авторизацию. Владелец не обязан находиться в dmAllowlist, defaultAuthorizedShips или groupInviteAllowlist.

Если задан ownerShip, неавторизованные запросы не просто отбрасываются — они помещаются в очередь ожидания одобрения, а владельцу отправляется личное сообщение:

• Запросы на личные сообщения от кораблей, отсутствующих в dmAllowlist
• Упоминания в каналах, где отправитель не проходит авторизацию
• Приглашения в группы от кораблей, отсутствующих в groupInviteAllowlist (когда автоматическое принятие отключено либо включено, но пригласивший корабль отсутствует в списке разрешённых)

Чтобы обработать запрос, владелец отвечает в личном сообщении:

Если ownerShip не настроен, неавторизованные личные сообщения и упоминания в каналах просто отбрасываются и записываются в журнал; запрос на одобрение не отправляется.

Настройки автоматического принятия

Автоматически принимать приглашения в личные сообщения от кораблей, уже находящихся в dmAllowlist (приглашения от владельца всегда принимаются автоматически независимо от этого флага):

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

Автоматически принимать приглашения в группы от кораблей из списка разрешённых (безопасный отказ: при autoAcceptGroupInvites: true и пустом groupInviteAllowlist не принимаются приглашения ни от кого, кроме владельца):

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

Горячая перезагрузка через хранилище настроек Urbit

Большинство перечисленных выше настроек (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) при первом запуске копируются в агент %settings корабля (desk moltbot, bucket tlon), а затем считываются оттуда в реальном времени, поэтому изменения, внесённые через клиент Landscape или команды настройки встроенного плагина, применяются без перезапуска Gateway. channelRules и ожидающие запросы на одобрение также сохраняются там в формате JSON. Файловая конфигурация остаётся источником истины для значений, которые никогда не записывались в хранилище настроек.

Целевые адресаты доставки (CLI/cron)

Используйте с openclaw message send или для доставки через cron:

• Личное сообщение: ~sampel-palnet или dm/~sampel-palnet
• Группа: chat/~host-ship/channel или group:~host-ship/channel

Встроенный навык

Плагин включает @tloncorp/tlon-skill — CLI для непосредственных операций Urbit, который автоматически становится доступен после установки плагина:

• Активность: упоминания, ответы, непрочитанные сообщения
• Каналы: просмотр списка, создание, переименование
• Контакты: просмотр списка, получение и обновление профилей
• Группы: создание, присоединение, процессы приглашения и запроса, роли
• Перехватчики: управление перехватчиками каналов
• Сообщения: история, поиск
• Личные сообщения: отправка, реакции, принятие и отклонение
• Публикации: реакции, удаление
• Блокнот: публикация в каналах дневника
• Настройки: горячая перезагрузка конфигурации плагина через описанное выше хранилище настроек

Возможности

Устранение неполадок

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Распространённые сбои:

• Личные сообщения игнорируются: отправитель отсутствует в dmAllowlist, и ownerShip не настроен для процесса одобрения.
• Сообщения в группах игнорируются: канал не обнаружен и не закреплён либо отправитель не проходит авторизацию, а ownerShip для постановки запроса на одобрение в очередь отсутствует.
• Ошибки подключения: проверьте доступность URL корабля; для локальных кораблей задайте network.dangerouslyAllowPrivateNetwork.
• Ошибки аутентификации: коды входа меняются — скопируйте текущий код со своего корабля.

Справочник по конфигурации

Полная конфигурация: Конфигурация

Примечания

• Для ответов в группах требуется упоминание через @ (например, ~your-bot-ship), если бот ещё не присоединился к этой ветке.
• Ответы в ветках публикуются внутри ветки; бот также получает последние 10 сообщений контекста ветки, добавленные перед запросом для агента.
• Форматированный текст (полужирный, курсив, код, заголовки, списки) преобразуется в собственный формат Tlon.
• Входящее сообщение с просьбой составить сводку канала (например, «составь сводку этого канала») запускает встроенное суммирование истории вместо обычного процесса ответа.

Связанные материалы

• Обзор каналов — все поддерживаемые каналы
• Сопряжение — аутентификация в личных сообщениях и процесс сопряжения
• Группы — поведение групповых чатов и требование упоминаний
• Маршрутизация каналов — маршрутизация сеансов для сообщений
• Безопасность — модель доступа и усиление защиты