Developer and self-hosted

Tlon

Tlon to zdecentralizowany komunikator zbudowany na Urbit. OpenClaw łączy się z Twoim statkiem Urbit i może odpowiadać na wiadomości prywatne oraz wiadomości czatu grupowego. Odpowiedzi w grupach domyślnie wymagają wzmianki @ i można je dodatkowo ograniczyć za pomocą list dozwolonych.

Status: wbudowany Plugin. Obsługiwane są wiadomości prywatne, wzmianki grupowe, odpowiedzi w wątkach, formatowanie tekstu sformatowanego oraz przesyłanie obrazów. Reakcje i ankiety nie są jeszcze obsługiwane.

Wbudowany Plugin

Tlon jest dostarczany jako wbudowany Plugin w aktualnych wydaniach OpenClaw, więc zwykłe pakietowane kompilacje nie wymagają osobnej instalacji.

Jeśli używasz starszej kompilacji lub niestandardowej instalacji, która wyklucza Tlon, zainstaluj aktualny pakiet npm:

Instalacja przez CLI (rejestr npm):

openclaw plugins install @openclaw/tlon

Użyj samego pakietu, aby śledzić aktualny oficjalny znacznik wydania. Przypnij dokładną wersję tylko wtedy, gdy potrzebujesz powtarzalnej instalacji.

Lokalny checkout (podczas uruchamiania z repozytorium git):

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

Szczegóły: Pluginy

Konfiguracja

Upewnij się, że Plugin Tlon jest dostępny.
- Aktualne pakietowane wydania OpenClaw już go zawierają.
- Starsze/niestandardowe instalacje mogą dodać go ręcznie za pomocą powyższych poleceń.
Zbierz adres URL statku i kod logowania.
Skonfiguruj channels.tlon.
Uruchom ponownie gateway.
Wyślij wiadomość prywatną do bota albo wspomnij o nim w kanale grupowym.

Minimalna konfiguracja (jedno konto):

{
  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
    },
  },
}

Prywatne statki/LAN

Domyślnie OpenClaw blokuje prywatne/wewnętrzne nazwy hostów i zakresy adresów IP w celu ochrony przed SSRF. Jeśli Twój statek działa w sieci prywatnej (localhost, adres IP LAN lub wewnętrzna nazwa hosta), musisz jawnie wyrazić na to zgodę:

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

Dotyczy to adresów URL takich jak:

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

⚠️ Włącz tę opcję tylko wtedy, gdy ufasz swojej sieci lokalnej. To ustawienie wyłącza zabezpieczenia SSRF dla żądań do adresu URL Twojego statku.

Kanały grupowe

Automatyczne wykrywanie jest domyślnie włączone. Możesz też ręcznie przypiąć kanały:

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

Wyłącz automatyczne wykrywanie:

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

Kontrola dostępu

Lista dozwolonych wiadomości prywatnych (pusta = brak dozwolonych wiadomości prywatnych, użyj ownerShip dla przepływu zatwierdzania):

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

Autoryzacja grup (domyślnie ograniczona):

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

Właściciel i system zatwierdzania

Ustaw statek właściciela, aby otrzymywać prośby o zatwierdzenie, gdy nieautoryzowani użytkownicy próbują wejść w interakcję:

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

Statek właściciela jest automatycznie autoryzowany wszędzie — zaproszenia do wiadomości prywatnych są automatycznie akceptowane, a wiadomości na kanałach są zawsze dozwolone. Nie musisz dodawać właściciela do dmAllowlist ani defaultAuthorizedShips.

Po ustawieniu właściciel otrzymuje powiadomienia w wiadomościach prywatnych dla:

Próśb o wiadomość prywatną od statków spoza listy dozwolonych
Wzmianek na kanałach bez autoryzacji
Próśb o zaproszenie do grupy

Ustawienia automatycznej akceptacji

Automatycznie akceptuj zaproszenia do wiadomości prywatnych (dla statków w dmAllowlist):

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

Automatycznie akceptuj zaproszenia do grup od zaufanych statków:

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

autoAcceptGroupInvites domyślnie odmawia, gdy groupInviteAllowlist jest pusta. Ustaw listę dozwolonych na statki, których zaproszenia do grup mają być akceptowane automatycznie.

Cele dostarczania (CLI/Cron)

Używaj ich z openclaw message send lub dostarczaniem Cron:

Wiadomość prywatna: ~sampel-palnet lub dm/~sampel-palnet
Grupa: chat/~host-ship/channel lub group:~host-ship/channel

Wbudowana umiejętność

Plugin Tlon zawiera wbudowaną umiejętność (@tloncorp/tlon-skill), która zapewnia dostęp z CLI do operacji Tlon:

Kontakty: pobieranie/aktualizowanie profili, wyświetlanie listy kontaktów
Kanały: wyświetlanie listy, tworzenie, publikowanie wiadomości, pobieranie historii
Grupy: wyświetlanie listy, tworzenie, zarządzanie członkami
Wiadomości prywatne: wysyłanie wiadomości, reagowanie na wiadomości
Reakcje: dodawanie/usuwanie reakcji emoji do postów i wiadomości prywatnych
Ustawienia: zarządzanie uprawnieniami Plugin za pomocą poleceń ukośnikiem

Umiejętność jest automatycznie dostępna po zainstalowaniu Plugin.

Możliwości

Funkcja	Status
Wiadomości bezpośrednie	✅ Obsługiwane
Grupy/kanały	✅ Obsługiwane (domyślnie wymagają wzmianki)
Wątki	✅ Obsługiwane (automatyczne odpowiedzi w wątku)
Tekst sformatowany	✅ Markdown konwertowany do formatu Tlon
Obrazy	✅ Przesyłane do magazynu Tlon
Reakcje	✅ Przez wbudowaną umiejętność
Ankiety	❌ Jeszcze nieobsługiwane
Polecenia natywne	✅ Obsługiwane (domyślnie tylko dla właściciela)

Rozwiązywanie problemów

Najpierw uruchom tę sekwencję:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

Typowe awarie:

Wiadomości prywatne ignorowane: nadawca nie znajduje się w dmAllowlist i nie skonfigurowano ownerShip dla przepływu zatwierdzania.
Wiadomości grupowe ignorowane: kanał nie został wykryty albo nadawca nie jest autoryzowany.
Błędy połączenia: sprawdź, czy adres URL statku jest osiągalny; włącz allowPrivateNetwork dla lokalnych statków.
Błędy uwierzytelniania: sprawdź, czy kod logowania jest aktualny (kody rotują).

Dokumentacja konfiguracji

Pełna konfiguracja: Konfiguracja

Opcje dostawcy:

channels.tlon.enabled: włącza/wyłącza uruchamianie kanału.
channels.tlon.ship: nazwa statku Urbit bota (np. ~sampel-palnet).
channels.tlon.url: adres URL statku (np. https://sampel-palnet.tlon.network).
channels.tlon.code: kod logowania statku.
channels.tlon.allowPrivateNetwork: zezwalaj na adresy URL localhost/LAN (obejście SSRF).
channels.tlon.ownerShip: statek właściciela dla systemu zatwierdzania (zawsze autoryzowany).
channels.tlon.dmAllowlist: statki, które mogą wysyłać wiadomości prywatne (puste = brak).
channels.tlon.autoAcceptDmInvites: automatycznie akceptuj wiadomości prywatne od statków z listy dozwolonych.
channels.tlon.autoAcceptGroupInvites: automatycznie akceptuj zaproszenia do grup od statków z listy dozwolonych.
channels.tlon.groupInviteAllowlist: statki, których zaproszenia do grup mogą być automatycznie akceptowane.
channels.tlon.autoDiscoverChannels: automatycznie wykrywaj kanały grupowe (domyślnie: true).
channels.tlon.groupChannels: ręcznie przypięte gniazda kanałów.
channels.tlon.defaultAuthorizedShips: statki autoryzowane dla wszystkich kanałów.
channels.tlon.authorization.channelRules: reguły autoryzacji dla poszczególnych kanałów.
channels.tlon.showModelSignature: dołącz nazwę modelu do wiadomości.

Uwagi

Odpowiedzi grupowe wymagają wzmianki (np. ~your-bot-ship), aby odpowiedzieć.
Odpowiedzi w wątku: jeśli przychodząca wiadomość jest w wątku, OpenClaw odpowiada w wątku.
Tekst sformatowany: formatowanie Markdown (pogrubienie, kursywa, kod, nagłówki, listy) jest konwertowane do natywnego formatu Tlon.
Obrazy: adresy URL są przesyłane do magazynu Tlon i osadzane jako bloki obrazów.

Powiązane

Przegląd kanałów — wszystkie obsługiwane kanały
Parowanie — uwierzytelnianie wiadomości prywatnych i przepływ parowania
Grupy — zachowanie czatu grupowego i wymaganie wzmianki
Routing kanałów — routing sesji dla wiadomości
Bezpieczeństwo — model dostępu i utwardzanie

# Wbudowany Plugin

# Konfiguracja

# Prywatne statki/LAN

# Kanały grupowe

# Kontrola dostępu

# Właściciel i system zatwierdzania

# Ustawienia automatycznej akceptacji

# Cele dostarczania (CLI/Cron)

# Wbudowana umiejętność

# Możliwości

# Rozwiązywanie problemów

# Dokumentacja konfiguracji

# Uwagi

# Powiązane