Tlon

Tlon is a decentralized chat application based on Urbit. OpenClaw connects to your Urbit ship and can respond to DMs and group messages. By default, group chats require @mention to reply; you can also further restrict via allowlists. Status: Supported via plugin. Supports DMs, group mentions, thread replies, and "text fallback" media sending (appending URL to caption). Does not support reactions, polls, or native media uploads.

Tlon is provided as a plugin and is not packaged with the core installation.

Install via CLI (npm registry):

openclaw plugins install @openclaw/tlon

Local installation (when running from git repository):

openclaw plugins install ./extensions/tlon

Details: ''/plugin''

1. Install the Tlon plugin.

2. Prepare ship URL and login code.

3. Configure ''channels.tlon''.

4. Restart gateway.

5. DM the bot, or @mention it in a group channel.

Minimal configuration (single account):

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

Auto-discovery is enabled by default. You can also manually pin the channel list:

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

Disable auto-discovery:

{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}

DM allowlist (empty means allow all):

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

Group authorization (default is restricted):

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

Use in ''openclaw message send'' or cron delivery:

- DM: ''~sampel-palnet'' or ''dm/~sampel-palnet''

- Group: ''chat/~host-ship/channel'' or ''group:~host-ship/channel''

- Group replies require mention (e.g., ''~your-bot-ship'').

- Thread replies: If inbound message is in a thread, OpenClaw will reply within the thread.

- Media: ''sendMedia'' will fallback to "text + URL" (no native upload).