Tlon

Tlon is een gedecentraliseerde messenger die op Urbit is gebouwd. OpenClaw maakt verbinding met je Urbit-ship en reageert op privéberichten en groepschatberichten. Voor groepsantwoorden is standaard een @-vermelding vereist, met daarbovenop autorisatieregels en een goedkeuringsproces door de eigenaar.

Status: gebundelde plugin. Privéberichten, groepsvermeldingen, threads, opgemaakte tekst, uploaden/downloaden van afbeeldingen en een goedkeuringssysteem voor de eigenaar worden ondersteund. Reacties en peilingen niet.

Gebundelde plugin

Tlon wordt gebundeld meegeleverd in huidige OpenClaw-releases; voor verpakte builds is geen afzonderlijke installatie nodig.

Installeer bij een oudere build of aangepaste installatie waarin deze niet is opgenomen vanuit npm:

openclaw plugins install @openclaw/tlon

Gebruik alleen de pakketnaam om de huidige releasetag te volgen. Zet een versie vast (@openclaw/tlon@x.y.z) uitsluitend voor reproduceerbare installaties.

Vanuit een lokale checkout:

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

Details: Plugins

Configuratie

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

Of bewerk de configuratie rechtstreeks:

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

Start de Gateway opnieuw nadat je de configuratie rechtstreeks hebt bewerkt. Stuur de bot vervolgens een privébericht of vermeld deze met @ in een groepskanaal.

Privé-/LAN-ships

OpenClaw blokkeert standaard privé/interne hostnamen en IP-bereiken ter bescherming tegen SSRF. Als je ship op een privénetwerk draait (localhost, LAN-IP, interne hostnaam), moet je dit expliciet inschakelen:

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

Dit geldt voor doelen zoals http://localhost:8080, http://192.168.x.x:8080 en http://my-ship.local:8080. Schakel dit alleen in voor een ship-URL die je vertrouwt; hierdoor wordt de SSRF- bescherming voor de HTTP-verzoeken van dat account uitgeschakeld.

Groepskanalen

Zet kanalen handmatig vast of schakel automatische detectie in:

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

autoDiscoverChannels is standaard false wanneer deze niet in de configuratie is ingesteld; de configuratiewizard stelt bij de vraag standaard ja voor en schrijft expliciet true. Wanneer dit is ingeschakeld, bevraagt OpenClaw bij het opstarten de groepen waarvan het lid is, volgt het nieuwe kanalen wanneer groepsuitnodigingen worden geaccepteerd en controleert het deze elke 2 minuten opnieuw.

Toegangsbeheer

Toegestane afzenders voor privéberichten (leeg = geen privéberichten toegestaan, tenzij de afzender ownerShip is):

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

Groepsautorisatie is standaard per kanaal ingesteld op restricted. Stel defaultAuthorizedShips in als basis en overschrijf dit per kanaalnest:

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

Zodra de bot binnen een thread heeft geantwoord, blijft deze op latere berichten in die thread reageren zonder dat een nieuwe vermelding nodig is.

Eigenaar en goedkeuringssysteem

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

De ship van de eigenaar is overal geautoriseerd: uitnodigingen voor privéberichten worden altijd automatisch geaccepteerd, groepsuitnodigingen worden altijd automatisch geaccepteerd en kanaalberichten doorstaan altijd de autorisatie. De eigenaar hoeft niet in dmAllowlist, defaultAuthorizedShips of groupInviteAllowlist te staan.

Wanneer ownerShip is ingesteld, worden ongeautoriseerde verzoeken niet simpelweg genegeerd — ze worden als wachtende goedkeuring in de wachtrij geplaatst en de eigenaar ontvangt een privébericht:

• Privéberichtverzoeken van ships die niet in dmAllowlist staan
• Vermeldingen in kanalen waar de afzender niet door de autorisatie komt
• Groepsuitnodigingen van ships die niet in groupInviteAllowlist staan (wanneer automatisch accepteren is uitgeschakeld, of ingeschakeld maar de uitnodiger niet op de lijst staat)

De eigenaar antwoordt via een privébericht om een verzoek af te handelen:

Zonder een geconfigureerde ownerShip worden ongeautoriseerde privéberichten en kanaalvermeldingen simpelweg genegeerd en gelogd; er verschijnt geen goedkeuringsverzoek.

Instellingen voor automatisch accepteren

Accepteer uitnodigingen voor privéberichten automatisch van ships die al in dmAllowlist staan (de eigenaar wordt altijd automatisch geaccepteerd, ongeacht deze vlag):

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

Accepteer groepsuitnodigingen automatisch op basis van een lijst met toegestane ships (weigert standaard: met autoAcceptGroupInvites: true en een lege groupInviteAllowlist wordt geen uitnodiging van een niet-eigenaar geaccepteerd):

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

Opnieuw laden zonder herstart via de Urbit-instellingenopslag

De meeste bovenstaande instellingen (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) worden bij de eerste uitvoering gespiegeld naar de %settings-agent van de ship (desk moltbot, bucket tlon) en daarna rechtstreeks daaruit gelezen, zodat wijzigingen via een Landscape-client of de instellingenopdrachten van de gebundelde Skill worden toegepast zonder dat de Gateway opnieuw hoeft te worden gestart. channelRules en wachtende goedkeuringen worden daar ook als JSON opgeslagen. De bestandsconfiguratie blijft de bron van waarheid voor waarden die nooit naar de instellingenopslag zijn geschreven.

Afleverdoelen (CLI/Cron)

Gebruik met openclaw message send of aflevering via Cron:

• Privébericht: ~sampel-palnet of dm/~sampel-palnet
• Groep: chat/~host-ship/channel of group:~host-ship/channel

Gebundelde Skill

De plugin bundelt @tloncorp/tlon-skill, een CLI voor rechtstreekse Urbit-bewerkingen die automatisch beschikbaar is zodra de plugin is geïnstalleerd:

• Activiteit: vermeldingen, antwoorden, ongelezen berichten
• Kanalen: weergeven, maken, hernoemen
• Contacten: profielen weergeven/ophalen/bijwerken
• Groepen: maken, deelnemen, uitnodigings-/aanvraagprocessen, rollen
• Hooks: kanaalhooks beheren
• Berichten: geschiedenis, zoeken
• Privéberichten: verzenden, reageren, accepteren/afwijzen
• Berichten: reageren, verwijderen
• Notitieboek: publiceren in dagboekkanalen
• Instellingen: pluginconfiguratie zonder herstart opnieuw laden via de bovenstaande instellingenopslag

Mogelijkheden

Probleemoplossing

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Veelvoorkomende fouten:

• Privéberichten worden genegeerd: de afzender staat niet in dmAllowlist en er is geen ownerShip geconfigureerd voor het goedkeuringsproces.
• Groepsberichten worden genegeerd: het kanaal is niet gedetecteerd/vastgezet, of de afzender komt niet door de autorisatie en er is geen ownerShip om een goedkeuring in de wachtrij te plaatsen.
• Verbindingsfouten: controleer of de ship-URL bereikbaar is; stel network.dangerouslyAllowPrivateNetwork in voor lokale ships.
• Authenticatiefouten: aanmeldcodes rouleren — kopieer de huidige code van je ship.

Configuratiereferentie

Volledige configuratie: Configuratie

Opmerkingen

• Voor groepsantwoorden is een @-vermelding nodig (bijv. ~your-bot-ship), tenzij de bot al aan die thread deelneemt.
• Threadantwoorden worden binnen de thread geplaatst; de bot krijgt ook de laatste 10 berichten uit de threadcontext vooraf toegevoegd voor de agent.
• Opgemaakte tekst (vet, cursief, code, koppen, lijsten) wordt naar de systeemeigen indeling van Tlon geconverteerd.
• Het verzenden van een inkomend bericht waarin om een kanaalsamenvatting wordt gevraagd (bijvoorbeeld "vat dit kanaal samen") activeert een ingebouwde samenvatting van de geschiedenis in plaats van het normale antwoordproces.

Gerelateerd

• Overzicht van kanalen — alle ondersteunde kanalen
• Koppeling — authenticatie en koppelingsproces voor privéberichten
• Groepen — gedrag van groepschats en vereiste vermeldingen
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en beveiliging