Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

  1. 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ń.
  2. Zbierz adres URL statku i kod logowania.
  3. Skonfiguruj channels.tlon.
  4. Uruchom ponownie gateway.
  5. 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

FunkcjaStatus
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