Tlon

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

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

Вбудований Plugin

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. Потім надішліть боту приватне повідомлення або згадайте його через @ у груповому каналі.

Приватні кораблі та кораблі в LAN

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

{  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 або команди налаштувань вбудованого Skills, застосовуються без перезапуску Gateway. channelRules і запити на схвалення, що очікують, також зберігаються там у форматі JSON. Файлова конфігурація залишається джерелом істини для значень, які ніколи не записувалися до сховища налаштувань.

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

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

• Приватне повідомлення: ~sampel-palnet або dm/~sampel-palnet
• Група: chat/~host-ship/channel або group:~host-ship/channel

Вбудований Skills

Plugin містить @tloncorp/tlon-skill — CLI для безпосередніх операцій Urbit, який стає доступним автоматично після встановлення Plugin:

• Активність: згадки, відповіді, непрочитані повідомлення
• Канали: перегляд списку, створення, перейменування
• Контакти: перегляд списку, отримання й оновлення профілів
• Групи: створення, приєднання, процеси запрошення та запиту, ролі
• Хуки: керування хуками каналів
• Повідомлення: історія, пошук
• Приватні повідомлення: надсилання, реакції, прийняття або відхилення
• Дописи: реакції, видалення
• Нотатник: публікація в каналах щоденника
• Налаштування: гаряче перезавантаження конфігурації Plugin через описане вище сховище налаштувань

Можливості

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

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Поширені помилки:

• Приватні повідомлення ігноруються: відправника немає в dmAllowlist, а ownerShip для процесу схвалення не налаштовано.
• Групові повідомлення ігноруються: канал не виявлено й не закріплено або відправник не проходить авторизацію, а ownerShip для додавання запиту на схвалення до черги не задано.
• Помилки підключення: перевірте доступність URL-адреси корабля; для локальних кораблів задайте network.dangerouslyAllowPrivateNetwork.
• Помилки автентифікації: коди входу змінюються — скопіюйте поточний код зі свого корабля.

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

Повна конфігурація: Конфігурація

Примітки

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

Пов’язані матеріали

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