ef42fe0094
* docs: fix thinking link and add reasoning anchor reference * docs(channels): rename LINE setup heading to onboarding * docs(channels): normalize Nextcloud Talk onboarding headings * docs(channels): use onboarding heading for Matrix setup * docs(channels): standardize Discord onboarding heading * docs(channels): standardize Telegram onboarding heading * docs(channels): standardize WhatsApp onboarding heading * docs(channels): rename iMessage onboarding and configuration sections * docs(channels): rename Slack onboarding and configuration sections * docs(channels): rename Signal onboarding heading * docs(channels): standardize Nostr onboarding and configuration headings * docs(channels): standardize Zalo onboarding and configuration headings * docs(channels): standardize Twitch onboarding heading * docs(channels): standardize Google Chat onboarding heading * docs(channels): standardize Mattermost onboarding heading * docs(channels): standardize Zalo Personal onboarding heading * docs(channels): normalize Discord configuration heading * docs(channels): standardize Microsoft Teams onboarding heading * docs(channels): rename Signal configuration reference heading * docs(channels): rename Matrix configuration reference heading * docs(channels): normalize WhatsApp configuration heading * docs(thinking): link reasoning section heading to in-page anchor * docs(channels): normalize BlueBubbles configuration heading * docs(channels): normalize Feishu configuration heading * docs(channels): standardize Signal setup option headings * docs(channels): refine Twitch setup heading clarity * docs(channels): simplify Zalo setup heading phrasing * docs(channels): trim Microsoft Teams minimal setup heading * docs(channels): rename Tlon setup to onboarding
149 lines
2.9 KiB
Markdown
149 lines
2.9 KiB
Markdown
---
|
|
summary: "Tlon/Urbit support status, capabilities, and configuration"
|
|
read_when:
|
|
- Working on Tlon/Urbit channel features
|
|
title: "Tlon"
|
|
---
|
|
|
|
# Tlon (plugin)
|
|
|
|
Tlon is a decentralized messenger built on Urbit. OpenClaw connects to your Urbit ship and can
|
|
respond to DMs and group chat messages. Group replies require an @ mention by default and can
|
|
be further restricted via allowlists.
|
|
|
|
Status: supported via plugin. DMs, group mentions, thread replies, and text-only media fallback
|
|
(URL appended to caption). Reactions, polls, and native media uploads are not supported.
|
|
|
|
## Plugin required
|
|
|
|
Tlon ships as a plugin and is not bundled with the core install.
|
|
|
|
Install via CLI (npm registry):
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/tlon
|
|
```
|
|
|
|
Local checkout (when running from a git repo):
|
|
|
|
```bash
|
|
openclaw plugins install ./extensions/tlon
|
|
```
|
|
|
|
Details: [Plugins](/tools/plugin)
|
|
|
|
## Onboarding
|
|
|
|
1. Install the Tlon plugin.
|
|
2. Gather your ship URL and login code.
|
|
3. Configure `channels.tlon`.
|
|
4. Restart the gateway.
|
|
5. DM the bot or mention it in a group channel.
|
|
|
|
Minimal config (single account):
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
enabled: true,
|
|
ship: "~sampel-palnet",
|
|
url: "https://your-ship-host",
|
|
code: "lidlut-tabwed-pillex-ridrup",
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Private/LAN ship URLs (advanced):
|
|
|
|
By default, OpenClaw blocks private/internal hostnames and IP ranges for this plugin (SSRF hardening).
|
|
If your ship URL is on a private network (for example `http://192.168.1.50:8080` or `http://localhost:8080`),
|
|
you must explicitly opt in:
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
allowPrivateNetwork: true,
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Group channels
|
|
|
|
Auto-discovery is enabled by default. You can also pin channels manually:
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Disable auto-discovery:
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
autoDiscoverChannels: false,
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Access control
|
|
|
|
DM allowlist (empty = allow all):
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
dmAllowlist: ["~zod", "~nec"],
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
Group authorization (restricted by default):
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
tlon: {
|
|
defaultAuthorizedShips: ["~zod"],
|
|
authorization: {
|
|
channelRules: {
|
|
"chat/~host-ship/general": {
|
|
mode: "restricted",
|
|
allowedShips: ["~zod", "~nec"],
|
|
},
|
|
"chat/~host-ship/announcements": {
|
|
mode: "open",
|
|
},
|
|
},
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Delivery targets (CLI/cron)
|
|
|
|
Use these with `openclaw message send` or cron delivery:
|
|
|
|
- DM: `~sampel-palnet` or `dm/~sampel-palnet`
|
|
- Group: `chat/~host-ship/channel` or `group:~host-ship/channel`
|
|
|
|
## Notes
|
|
|
|
- Group replies require a mention (e.g. `~your-bot-ship`) to respond.
|
|
- Thread replies: if the inbound message is in a thread, OpenClaw replies in-thread.
|
|
- Media: `sendMedia` falls back to text + URL (no native upload).
|