OpenClaw

OpenClaw Tlon Kanal

Dezentral
Fortgeschritten

Verbinden Sie OpenClaw mit Tlon, dem dezentralen Messenger auf Urbit. Diese Integration ermöglicht es Ihrem KI-Assistenten, Direktnachrichten und Gruppenerwähnungen über Tlons Peer-to-Peer-Netzwerk zu empfangen und zu beantworten — ohne zentralen Server, ohne Unternehmenskonto, nur mit Ihrer Urbit-Schiff-Identität und einem Authentifizierungscode. Ideal für Sovereign-Computing-Enthusiasten und Organisationen, die echtes Dateneigentum schätzen.

Kurzinfo
SchwierigkeitsgradFortgeschritten
KategorieDezentral
Unterstützte Funktionen1 / 6

Tlon Unterstützte Funktionen

Textnachrichten

Unterstützt

Medien & Dateien

Nicht unterstützt

Reaktionen

Nicht unterstützt

Threads

Nicht unterstützt

Sprachnachrichten

Nicht unterstützt

Gruppenchat

Nicht unterstützt

Tlon Voraussetzungen

  • OpenClaw Gateway installiert und in Betrieb
  • Ein laufendes Urbit-Schiff (Planet, Stern oder Komet), das über HTTP erreichbar ist
  • Der Authentifizierungscode des Schiffs (über die Weboberfläche des Schiffs erhältlich)
  • Node.js 18+ auf Ihrem Server installiert

Tlon Schnelleinrichtung

1

Tlon-Plugin installieren

Führen Sie 'openclaw plugins install @openclaw/tlon' aus, um den Tlon-Kanal hinzuzufügen. Alternativ verwenden Sie 'openclaw onboard' oder 'openclaw channels add' und wählen Tlon aus der Plugin-Liste. Starten Sie das Gateway nach der Installation neu.

2

Urbit-Schiff-Anmeldedaten konfigurieren

Legen Sie Ihren Urbit-Schiff-Bezeichner (z.B. ~sampel-palnet), die Host-URL des Schiffs (z.B. http://localhost:8080) und den Authentifizierungscode als Umgebungsvariablen fest. Referenzieren Sie diese in Ihrer openclaw.json-Konfiguration mit ${URBIT_SHIP}, ${URBIT_URL} und ${URBIT_CODE}.

3

Starten und Testnachricht senden

Starten Sie das Gateway mit 'openclaw start' neu. Öffnen Sie die Tlon-App auf Ihrem Urbit-Schiff und senden Sie eine Direktnachricht an das Bot-Schiff. Der Bot sollte automatisch entschlüsseln, verarbeiten und antworten.

Tlon Konfigurationsbeispiel

config.json
{
  "channels": {
    "tlon": {
      "ship": "${URBIT_SHIP}",
      "url": "${URBIT_URL}",
      "code": "${URBIT_CODE}",
      "enabled": true
    }
  }
}

Tlon Detaillierte Dokumentation

Architekturübersicht

Tlon ist eine Messaging-Anwendung, die auf Urbit aufgebaut ist, einer Peer-to-Peer-Computing-Plattform, auf der jeder Benutzer seinen eigenen Server (genannt "Schiff") betreibt. Im Gegensatz zu zentralisierten Plattformen befinden sich Ihre Daten auf Ihrem Schiff und Sie kontrollieren sie vollständig. Der Nachrichtenfluss funktioniert wie folgt: 1. Ein Benutzer sendet eine DM oder erwähnt den Bot in einem Tlon-Gruppenchat 2. Die Nachricht wird über Urbits Ames-Netzwerkprotokoll an das Schiff des Bots geliefert 3. OpenClaw empfängt die Nachricht über die HTTP-API des Schiffs 4. Das Gateway verarbeitet die Nachricht über Ihren KI-Agenten und sendet die Antwort über dieselbe API zurück Da Urbit ein Peer-to-Peer-Netzwerk ist, gibt es keinen zentralen Server, der abgeschaltet oder zensiert werden kann. Jedes Schiff pflegt seinen eigenen Zustand, und Nachrichten werden direkt zwischen Schiffen über das Ames-Protokoll zugestellt.
Der Bot läuft als Begleitprozess neben Ihrem Urbit-Schiff — er verbindet sich über die lokale HTTP-API des Schiffs, nicht über einen externen Dienst.
Urbit-Schiffe haben eine dauerhafte Identität: Ein Planet wie ~sampel-palnet ist Ihre permanente Adresse im Netzwerk.

Plugin-Installation

Der Tlon-Kanal wird als optionales OpenClaw-Plugin verteilt und ist nicht in das Kern-Gateway eingebaut. Dadurch bleibt die Basisinstallation schlank, während Sie bei Bedarf Tlon/Urbit-Unterstützung hinzufügen können. Installationsmethoden: • **npm (empfohlen):** Führen Sie 'openclaw plugins install @openclaw/tlon' aus, um die stabile Version zu installieren. • **Lokale Entwicklung:** Klonen Sie das Plugin-Repository und verwenden Sie 'openclaw plugins install ./extensions/tlon' für die Installation aus einem lokalen Verzeichnis. • **Interaktives Setup:** Führen Sie 'openclaw onboard' oder 'openclaw channels add' aus und wählen Sie Tlon aus der Liste. Starten Sie das Gateway nach der Installation neu, damit das Plugin wirksam wird.
Führen Sie 'openclaw plugins list' aus, um zu überprüfen, ob das Tlon-Plugin installiert und aktiv ist.

Urbit-Schiff-Einrichtung und Authentifizierung

Um OpenClaw mit Tlon zu verbinden, benötigen Sie drei Informationen von Ihrem Urbit-Schiff: 1. **Schiff-Bezeichner** — Ihre Urbit-Identität (z.B. ~sampel-palnet). Dies ist das Schiff, das als Bot fungiert. 2. **Host-URL** — Der HTTP-Endpunkt, über den das Schiff erreichbar ist. Urbit verwendet standardmäßig Port 80 und fällt auf 8080 zurück, wenn Port 80 belegt ist (z.B. http://localhost:8080). Prüfen Sie die Startprotokolle Ihres Schiffs für den tatsächlichen Port. 3. **Authentifizierungscode** — Ein geheimer Code zur Authentifizierung von API-Anfragen. Sie finden ihn in der Weboberfläche Ihres Schiffs unter Einstellungen oder indem Sie '+code' im Dojo (Urbits Kommandozeile) ausführen. OpenClaw verwendet diese Anmeldedaten, um sich bei der HTTP-API des Schiffs zu authentifizieren und eingehende Nachrichten zu abonnieren.
openclaw.json
{
  "channels": {
    "tlon": {
      "ship": "${URBIT_SHIP}",
      "url": "${URBIT_URL}",
      "code": "${URBIT_CODE}"
    }
  }
}
Codieren Sie Ihren Authentifizierungscode niemals direkt in openclaw.json. Verwenden Sie immer Umgebungsvariablen (z.B. ${URBIT_CODE}) und setzen Sie diese über 'export URBIT_CODE="sampel-ticlyt-migfun-falmel"' in Ihrer Shell oder einer .env-Datei.

Automatische Erkennung und Kanal-Pinning

Standardmäßig erkennt OpenClaw automatisch Gruppenkanäle auf Ihrem Urbit-Schiff, sodass der Bot auf Erwähnungen in jeder Gruppe reagieren kann, der er beigetreten ist. Sie können die automatische Erkennung deaktivieren und stattdessen bestimmte Kanäle manuell anpinnen. Kanalpfade in Tlon folgen dem Format: chat/~host-ship/channel-name. Beispielsweise bezieht sich 'chat/~host-ship/general' auf den 'general'-Chat-Kanal, der von ~host-ship gehostet wird. Wenn die automatische Erkennung deaktiviert ist, werden nur angepinnte Kanäle überwacht. Dies ist nützlich, wenn der Bot nur an bestimmten Gesprächen teilnehmen soll, ohne in jeder Gruppe ausgelöst zu werden.
openclaw.json
{
  "channels": {
    "tlon": {
      "autoDiscovery": false,
      "channels": [
        "chat/~host-ship/general",
        "chat/~host-ship/support"
      ]
    }
  }
}
Die automatische Erkennung ist standardmäßig aktiviert. Setzen Sie autoDiscovery: false, um den Bot auf angepinnte Kanäle zu beschränken.
Kanalpfade verwenden das Format chat/~host-ship/channel-name. Überprüfen Sie den genauen Pfad jedes Kanals in der Tlon-App.

DM-Richtlinien

DM-Richtlinien (Direktnachrichten) steuern, wer über Tlon mit Ihrem KI-Assistenten interagieren kann. Da Urbit-Schiffe dauerhafte Identitäten haben, basiert die Zugriffskontrolle auf Schiffadressen. OpenClaw unterstützt die folgenden DM-Richtlinien für den Tlon-Kanal: • **open (Standard)** — Jedes Schiff kann dem Bot eine DM senden. Da Tlon-DMs erfordern, dass beide Parteien im Urbit-Netzwerk sind, ist dies relativ sicher. • **allowlist** — Nur in allowFrom aufgelistete Schiffe können dem Bot Nachrichten senden. Andere werden ignoriert. Wenn allowFrom auf ein leeres Array gesetzt ist, sind alle Schiffe erlaubt (entspricht dem Open-Modus). Fügen Sie bestimmte Schiffadressen hinzu, um den Zugriff einzuschränken.
openclaw.json
{
  "channels": {
    "tlon": {
      "allowFrom": [
        "~sampel-palnet",
        "~timluc-miptev"
      ]
    }
  }
}

Gruppenzugriffskontrolle

Gruppenkanäle in Tlon haben ihre eigene Zugriffskontrollschicht. Standardmäßig sind Gruppen eingeschränkt — der Bot antwortet nur in Gruppen, in denen autorisierte Schiffe explizit aufgelistet sind. Jeder Gruppenkanal kann konfiguriert werden mit: • **authorized** — Eine Liste von Schiffadressen, die den Bot in dieser Gruppe auslösen können • **mode** — Entweder 'restricted' (nur autorisierte Schiffe können auslösen) oder 'open' (jedes Gruppenmitglied kann auslösen) In Gruppen antwortet der Bot nur, wenn er ausdrücklich mit @ erwähnt wird. Dies verhindert, dass der Bot auf jede Nachricht in einem geschäftigen Gruppenchat antwortet.
openclaw.json
{
  "channels": {
    "tlon": {
      "groups": {
        "chat/~host-ship/general": {
          "mode": "restricted",
          "authorized": ["~sampel-palnet"]
        },
        "chat/~host-ship/public": {
          "mode": "open"
        }
      }
    }
  }
}
Im eingeschränkten Modus können nur in 'authorized' aufgelistete Schiffe Bot-Antworten auslösen.
Gruppenantworten erfordern @-Erwähnungen — auch im offenen Modus antwortet der Bot nicht auf normale Nachrichten.

Zustellungsziele (CLI und geplante Aufgaben)

OpenClaw unterstützt das Senden proaktiver Nachrichten über die CLI oder geplante Cron-Jobs. Für den Tlon-Kanal können Sie sowohl DMs als auch Gruppenkanäle ansprechen. DM-Zustellungsziele: • ~sampel-palnet — Eine DM an dieses Schiff senden • dm/~sampel-palnet — Explizites DM-Format Gruppen-Zustellungsziele: • chat/~host-ship/channel — In einen bestimmten Gruppenkanal posten • group:~host-ship/channel — Alternatives Gruppenformat Dies ist nützlich für das Senden geplanter Benachrichtigungen, Warnungen oder regelmäßiger Berichte an bestimmte Schiffe oder Gruppenkanäle.
CLI examples
# Send a DM to a specific ship
openclaw send tlon ~sampel-palnet "Your daily report is ready."

# Post to a group channel
openclaw send tlon chat/~host-ship/general "System status: all clear."

Einschränkungen der Medienverarbeitung

Die aktuelle Tlon-Integration unterstützt nur Textnachrichten. Reaktionen, Umfragen und native Medien-Uploads werden aufgrund von Einschränkungen der Urbit-API-Integration des Plugins nicht unterstützt. Wenn der KI-Agent eine Antwort mit Medien (Bilder, Dateien usw.) generiert, fällt das Plugin auf reine Textzustellung zurück: • Bilder — Die URL wird dem Nachrichtentext angehängt, anstatt inline angezeigt zu werden • Dateien — Ein Download-Link wird in der Textantwort eingefügt • Reaktionen — Nicht unterstützt; der Bot kann nicht auf Nachrichten reagieren • Threads — Nicht unterstützt; alle Antworten gehen an die Hauptkonversation Zukünftige Plugin-Updates könnten native Medienunterstützung hinzufügen, wenn sich die Tlon-Plattform weiterentwickelt.
Wenn Ihr KI-Agent häufig Bildantworten generiert, erwägen Sie, im System-Prompt zu vermerken, dass der Tlon-Kanal nur Text unterstützt.
URLs in Nachrichten sind in der Tlon-App anklickbar — Benutzer können tippen, um Medieninhalte in ihrem Browser anzuzeigen.

Tlon Konfigurationsreferenz

ship
Type: stringDefault: (required)

Ihr Urbit-Schiff-Bezeichner (z.B. ~sampel-palnet). Dies ist das Schiff, das als Bot fungiert.

url
Type: stringDefault: "http://localhost:8080"

HTTP-Endpunkt, über den das Urbit-Schiff erreichbar ist

code
Type: stringDefault: (required)

Authentifizierungscode für die HTTP-API des Urbit-Schiffs. Verwenden Sie eine Umgebungsvariablen-Referenz.

enabled
Type: booleanDefault: true

Tlon-Kanal aktivieren oder deaktivieren

name
Type: stringDefault: ""

Anzeigename für diese Kanalinstanz

autoDiscovery
Type: booleanDefault: true

Alle Gruppenkanäle auf dem Schiff automatisch erkennen und überwachen

channels
Type: string[]Default: []

Liste der zu überwachenden Gruppenkanalpfade, wenn autoDiscovery deaktiviert ist (z.B. chat/~host-ship/general)

allowFrom
Type: string[]Default: []

Liste der Schiffadressen, die dem Bot DMs senden dürfen. Ein leeres Array erlaubt alle Schiffe.

groups
Type: objectDefault: {}

Zugriffskontrollkonfiguration pro Gruppe mit Modus und autorisierten Schifflisten

groups.<path>.mode
Type: stringDefault: "restricted"

Gruppenzugriffsmodus: 'restricted' (nur autorisierte Schiffe) oder 'open' (jedes Gruppenmitglied)

groups.<path>.authorized
Type: string[]Default: []

Liste der Schiffadressen, die den Bot in dieser Gruppe auslösen dürfen (wenn der Modus 'restricted' ist)

Tlon Häufig gestellte Fragen

Tlon Fehlerbehebung

Bot startet, empfängt aber keine Nachrichten

Die Schiff-URL oder der Authentifizierungscode könnte falsch sein, oder das Schiff läuft nicht.

Überprüfen Sie, ob das Schiff erreichbar ist, indem Sie die URL im Browser öffnen. Stellen Sie sicher, dass der Authentifizierungscode korrekt ist (führen Sie '+code' im Dojo aus). Stellen Sie sicher, dass die Umgebungsvariablen korrekt exportiert sind: 'echo $URBIT_URL' und 'echo $URBIT_CODE'.
Fehler: Authentifizierung fehlgeschlagen

Der Authentifizierungscode ist abgelaufen oder falsch. Urbit-Schiffe können ihre Authentifizierungscodes rotieren.

Holen Sie einen neuen Authentifizierungscode von der Weboberfläche des Schiffs (Einstellungen) oder führen Sie '+code' im Dojo aus. Aktualisieren Sie die Umgebungsvariable URBIT_CODE und starten Sie das Gateway neu.
Bot antwortet auf DMs, aber nicht in Gruppenkanälen

Die automatische Erkennung ist möglicherweise deaktiviert und der Gruppenkanal nicht angepinnt, oder die Gruppenzugriffskontrolle blockiert den Absender.

Prüfen Sie, ob autoDiscovery auf false gesetzt ist — wenn ja, fügen Sie den Gruppenkanal zum channels-Array hinzu. Überprüfen Sie, ob das Schiff des Absenders in der authorized-Liste der Gruppe ist (bei eingeschränktem Modus). Denken Sie daran, dass Gruppenantworten @-Erwähnungen erfordern.
Plugin nach der Installation nicht gefunden

Das Gateway wurde nach der Plugin-Installation nicht neu gestartet, oder die Installation ist stillschweigend fehlgeschlagen.

Führen Sie 'openclaw plugins list' aus, um zu überprüfen, ob das Tlon-Plugin installiert ist. Wenn nicht aufgelistet, führen Sie 'openclaw plugins install @openclaw/tlon' erneut aus. Starten Sie das Gateway nach der Installation mit 'openclaw start' neu.
Verbindung bricht häufig ab

Die HTTP-API des Urbit-Schiffs ist möglicherweise aufgrund von Netzwerkproblemen oder Überlastung des Schiffs nicht erreichbar.

Überprüfen Sie Ihre Netzwerkverbindung zum Schiff. Wenn Sie es remote betreiben, stellen Sie sicher, dass der HTTP-Port nicht von einer Firewall blockiert wird. Erwägen Sie, den Bot auf derselben Maschine wie das Schiff auszuführen, um die Latenz zu minimieren. Überprüfen Sie das Dojo des Schiffs auf Fehlermeldungen.