Tlon

Tlon ist ein dezentraler Messenger, der auf Urbit basiert. OpenClaw verbindet sich mit Ihrem Urbit-Ship und antwortet auf Direktnachrichten und Gruppenchat-Nachrichten. Für Gruppenantworten ist standardmäßig eine @-Erwähnung erforderlich, zusätzlich gelten Autorisierungsregeln und ein Genehmigungsablauf durch den Eigentümer.

Status: gebündeltes Plugin. Direktnachrichten, Gruppenerwähnungen, Threads, Rich Text, Bildupload/-download und ein Genehmigungssystem für den Eigentümer werden unterstützt. Reaktionen und Umfragen werden nicht unterstützt.

Gebündeltes Plugin

Tlon ist in aktuellen OpenClaw-Versionen gebündelt; für paketierte Builds ist keine separate Installation erforderlich.

Installieren Sie bei einem älteren Build oder einer benutzerdefinierten Installation, die es ausschließt, das Paket von npm:

openclaw plugins install @openclaw/tlon

Verwenden Sie den reinen Paketnamen, um dem aktuellen Release-Tag zu folgen. Fixieren Sie eine Version (@openclaw/tlon@x.y.z) nur für reproduzierbare Installationen.

Aus einem lokalen Checkout:

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

Details: Plugins

Einrichtung

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

Oder bearbeiten Sie die Konfiguration direkt:

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // empfohlen: Ihr Ship, immer autorisiert    },  },}

Starten Sie den Gateway nach der direkten Bearbeitung der Konfiguration neu. Senden Sie dem Bot anschließend eine Direktnachricht oder erwähnen Sie ihn mit @ in einem Gruppenkanal.

Dauerhaftigkeit eingehender Nachrichten

OpenClaw speichert akzeptierte Tlon-Ereignisse aus Direktnachrichten und Gruppenchats dauerhaft, bevor sie an den Agenten weitergeleitet werden. Ausstehende oder erneut ausführbare Vorgänge überstehen einen Neustart des Gateway, und die Verarbeitung bleibt pro Gruppenkanal oder direktem Kommunikationspartner serialisiert. Stabile Urbit-Nachrichten-IDs unterdrücken außerdem ein erneut zugestelltes Ereignis, solange der zugehörige Warteschlangeneintrag oder der aufbewahrte Abschlussdatensatz vorhanden ist.

Die Zustellung über die Grenze zwischen Warteschlange und Agent erfolgt mindestens einmal: Ein Absturz während der Übergabe kann einen Vorgang erneut ausführen. Agentenaktionen mit externen Nebenwirkungen sollten daher, soweit praktikabel, idempotent bleiben.

Private Ships/LAN-Ships

OpenClaw blockiert zum Schutz vor SSRF standardmäßig private/interne Hostnamen und IP-Bereiche. Wenn Ihr Ship in einem privaten Netzwerk ausgeführt wird (localhost, LAN-IP, interner Hostname), müssen Sie dies ausdrücklich zulassen:

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

Dies gilt für Ziele wie http://localhost:8080, http://192.168.x.x:8080 und http://my-ship.local:8080. Aktivieren Sie dies nur für eine Ship-URL, der Sie vertrauen; dadurch wird der SSRF-Schutz für die HTTP-Anfragen dieses Kontos deaktiviert.

Gruppenkanäle

Heften Sie Kanäle manuell an oder aktivieren Sie die automatische Erkennung:

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

autoDiscoverChannels verwendet standardmäßig false, wenn der Wert in der Konfiguration nicht festgelegt ist; im Einrichtungsassistenten lautet die Standardantwort auf die Abfrage „Ja“, und true wird ausdrücklich geschrieben. Wenn die Option aktiviert ist, fragt OpenClaw beim Start beigetretene Gruppen ab, überwacht neue Kanäle, sobald Gruppeneinladungen angenommen werden, und prüft alle 2 Minuten erneut.

Zugriffskontrolle

Zulassungsliste für Direktnachrichten (leer = keine Direktnachrichten zulässig, außer der Absender ist ownerShip):

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

Die Gruppenautorisierung verwendet standardmäßig restricted pro Kanal. Legen Sie defaultAuthorizedShips als Ausgangsbasis fest und überschreiben Sie den Wert pro Kanal-Nest:

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

Sobald der Bot innerhalb eines Threads geantwortet hat, antwortet er weiterhin auf spätere Nachrichten in diesem Thread, ohne dass eine weitere Erwähnung erforderlich ist.

Legen Sie channels.tlon.implicitMentions.threadParticipation: false fest, um für diese Folgenachrichten eine neue ausdrückliche Erwähnung zu verlangen. Kontoüberschreibungen verwenden channels.tlon.accounts.<id>.implicitMentions. Tlon erzeugt derzeit keine Fakten vom Typ replyToBot oder quotedBot, daher haben diese Optionen hier keine Auswirkung.

Eigentümer- und Genehmigungssystem

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

Das Ship des Eigentümers ist überall autorisiert: Einladungen zu Direktnachrichten werden immer automatisch angenommen, Gruppeneinladungen werden immer automatisch angenommen und Kanalnachrichten bestehen stets die Autorisierungsprüfung. Das Ship des Eigentümers muss nicht in dmAllowlist, defaultAuthorizedShips oder groupInviteAllowlist enthalten sein.

Wenn ownerShip festgelegt ist, werden nicht autorisierte Anfragen nicht einfach verworfen – sie werden als ausstehende Genehmigung in die Warteschlange gestellt und dem Eigentümer per Direktnachricht gesendet:

• Direktnachrichtenanfragen von Ships, die nicht in dmAllowlist enthalten sind
• Erwähnungen in Kanälen, in denen der Absender die Autorisierungsprüfung nicht besteht
• Gruppeneinladungen von Ships, die nicht in groupInviteAllowlist enthalten sind (wenn die automatische Annahme deaktiviert ist oder aktiviert ist, aber der Einladende nicht auf der Zulassungsliste steht)

Der Eigentümer antwortet per Direktnachricht, um eine Anfrage zu bearbeiten:

Wenn ownerShip nicht konfiguriert ist, werden nicht autorisierte Direktnachrichten und Kanalerwähnungen einfach verworfen und protokolliert; es wird keine Genehmigungsabfrage angezeigt.

Einstellungen für die automatische Annahme

Nehmen Sie Einladungen zu Direktnachrichten von Ships, die bereits in dmAllowlist enthalten sind, automatisch an (das Ship des Eigentümers wird unabhängig von dieser Option immer automatisch angenommen):

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

Nehmen Sie Gruppeneinladungen aus einer Zulassungsliste automatisch an (standardmäßig abweisend: Bei autoAcceptGroupInvites: true und einer leeren groupInviteAllowlist wird keine Einladung eines anderen Ships als des Eigentümers angenommen):

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

Hot-Reload über den Urbit-Einstellungsspeicher

Die meisten der oben genannten Einstellungen (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) werden beim ersten Start in den %settings-Agenten des Ships (Desk moltbot, Bucket tlon) gespiegelt und anschließend live von dort gelesen, sodass Änderungen über einen Landscape-Client oder die Einstellungsbefehle des gebündelten Skills ohne einen Neustart des Gateway wirksam werden. channelRules und ausstehende Genehmigungen werden dort ebenfalls als JSON dauerhaft gespeichert. Die Dateikonfiguration bleibt die maßgebliche Quelle für Werte, die nie in den Einstellungsspeicher geschrieben wurden.

Zustellungsziele (CLI/Cron)

Verwenden Sie diese mit openclaw message send oder für die Cron-Zustellung:

• Direktnachricht: ~sampel-palnet oder dm/~sampel-palnet
• Gruppe: chat/~host-ship/channel oder group:~host-ship/channel

Gebündelter Skill

Das Plugin enthält @tloncorp/tlon-skill, eine CLI für direkte Urbit-Operationen, die nach der Installation des Plugins automatisch verfügbar ist:

• Aktivität: Erwähnungen, Antworten, ungelesene Nachrichten
• Kanäle: auflisten, erstellen, umbenennen
• Kontakte: Profile auflisten/abrufen/aktualisieren
• Gruppen: erstellen, beitreten, Einladungs-/Anfrageabläufe, Rollen
• Hooks: Kanal-Hooks verwalten
• Nachrichten: Verlauf, Suche
• Direktnachrichten: senden, reagieren, annehmen/ablehnen
• Beiträge: reagieren, löschen
• Notizbuch: in Tagebuchkanälen veröffentlichen
• Einstellungen: Plugin-Konfiguration über den oben genannten Einstellungsspeicher per Hot-Reload aktualisieren

Funktionen

Fehlerbehebung

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Häufige Fehler:

• Direktnachrichten werden ignoriert: Der Absender ist nicht in dmAllowlist enthalten, und für den Genehmigungsablauf ist kein ownerShip konfiguriert.
• Gruppennachrichten werden ignoriert: Der Kanal wurde nicht erkannt/angeheftet, oder der Absender besteht die Autorisierungsprüfung nicht und es gibt kein ownerShip, um eine Genehmigung in die Warteschlange zu stellen.
• Verbindungsfehler: Prüfen Sie, ob die Ship-URL erreichbar ist; legen Sie network.dangerouslyAllowPrivateNetwork für lokale Ships fest.
• Authentifizierungsfehler: Anmeldecodes wechseln regelmäßig – kopieren Sie den aktuellen Code von Ihrem Ship.

Konfigurationsreferenz

Vollständige Konfiguration: Konfiguration

Hinweise

• Antworten in Gruppen benötigen eine @-Erwähnung (z. B. ~your-bot-ship), sofern der Bot diesem Thread nicht bereits beigetreten ist.
• Antworten auf Threads werden im jeweiligen Thread veröffentlicht; außerdem werden dem Bot die letzten 10 Nachrichten aus dem Thread-Kontext für den Agenten vorangestellt.
• Rich Text (Fettdruck, Kursivschrift, Code, Überschriften, Listen) wird in das native Format von Tlon konvertiert.
• Wenn eine eingehende Nachricht um eine Zusammenfassung eines Kanals bittet (zum Beispiel „Diesen Kanal zusammenfassen“), wird anstelle des normalen Antwortablaufs eine integrierte Zusammenfassung des Verlaufs ausgelöst.

Verwandte Themen

• Kanalübersicht — alle unterstützten Kanäle
• Kopplung — DM-Authentifizierung und Kopplungsablauf
• Gruppen — Verhalten von Gruppenchats und Erwähnungsbeschränkung
• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Sicherheit — Zugriffsmodell und Absicherung