Tlon mit OpenClaw verbinden

Dezentrale Kommunikation ist oft kompliziert aufzusetzen. Wenn du versuchst, Bots in Urbit zu integrieren, stößt du schnell auf Hürden bei der Authentifizierung oder der Nachrichtenverarbeitung. Man möchte einfach nur, dass der Bot auf DMs reagiert oder in Gruppenchats präsent ist, ohne sich mit der zugrunde liegenden Komplexität der Protokolle herumzuschlagen.

Meistens endet man damit, Scripte manuell zu flicken, nur um eine einfache Antwortfunktion zu erhalten. OpenClaw löst das über ein Plugin, das die Verbindung zu deinem Urbit Ship übernimmt und direkt auf Nachrichten reagiert.

Voraussetzungen

• Tlon Plugin
• Urbit Ship URL
• Login Code für dein Ship
• Ein installiertes OpenClaw Gateway

Schnellstart

In weniger als fünf Minuten ist dein Bot auf Tlon einsatzbereit. Folge diesen Schritten:

1. Plugin installieren Installiere das Plugin über die CLI aus dem npm Registry:

   openclaw plugins install @openclaw/tlon

   Falls du direkt aus dem Git-Repo arbeitest, nutze den lokalen Pfad:

   openclaw plugins install ./extensions/tlon

2. Konfiguration anlegen Füge deine Zugangsdaten in die Konfigurationsdatei ein. Hier ist ein minimales Beispiel für einen einzelnen Account:

   {
     channels: {
       tlon: {
         enabled: true,
         ship: "~sampel-palnet",
         url: "https://your-ship-host",
         code: "lidlut-tabwed-pillex-ridrup",
       },
     },
   }

3. Gateway neu starten Starte dein Gateway neu, damit die Änderungen aktiv werden.

4. Verbindung testen Schreibe deinem Bot eine DM oder erwähne ihn in einem Gruppenkanal.

Gruppen-Kanäle und Zugriff

Standardmäßig ist die Auto-Discovery für Kanäle aktiviert. Wenn du mehr Kontrolle willst, kannst du Kanäle manuell pinnen oder die automatische Suche deaktivieren:

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

Für die Sicherheit empfehle ich die Nutzung von Allowlists. DMs können auf bestimmte Ships beschränkt werden (bleibt die Liste leer, ist alles erlaubt). Gruppen sind standardmäßig restriktiv eingestellt:

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

Fehlerbehebung

• Bot antwortet nicht in der Gruppe: In Gruppenchats reagiert OpenClaw standardmäßig nur, wenn der Bot per @ erwähnt wird (z. B. ~your-bot-ship).
• Medien werden nicht hochgeladen: Tlon unterstützt keine nativen Media Uploads über das Plugin. OpenClaw nutzt einen Fallback, bei dem die URL einfach an den Text angehängt wird.
• Reaktionen oder Umfragen fehlen: Diese Funktionen sowie native Media Uploads werden aktuell nicht unterstützt.
• Nachrichten-Formatierung: Das Plugin unterstützt DMs, Group Mentions und Thread Replies. Wenn die eingehende Nachricht in einem Thread ist, antwortet OpenClaw automatisch im selben Thread.

Du hast Fragen zur Installation? Nutze den AI Setup Assistant.

Nächste Schritte

• Plugins Dokumentation
• CLI Referenz für Messaging