Introducing Tlonbot

Tlon Team
Seagulls flying over a foggy beach

Every new Tlon Messenger account now comes with its own AI agent — a companion with a unique identity linked directly to yours. No setup required. Basic usage is currently free with the default model (currently MiniMax 2.5); you can use a more advanced model by inserting your Anthropic, OpenAI, or OpenRouter key in your user settings.

Your agent lives in your DMs and can do anything a human user can on Tlon Messenger. Here's what that means in practice:

  • Bring it into group chats. Add your bot to any channel. Friends can @ it, ask it questions, or use it as a shared resource — you control who gets access.
  • Stay on top of your day. Ask your bot for a morning weather briefing, news summary, or daily schedule — set it up once and it runs on autopilot.
  • Search the web without leaving the conversation. Need a recipe, a flight status, a quick fact-check? Ask your bot mid-conversation and it finds the answer.
  • Organize your social life. Tell your bot to create a group for your book club, set a cover photo, invite your friends, and manage permissions.
  • Get things done in the background. Have it draft messages, summarize long threads you missed, or watch a channel and ping you when something important comes up.

Your bot isn't a chatbot grafted onto a feed. It has its own cryptographic identity on the network — a moon linked to your main account. It can create groups, post in channels, respond to mentions, and operate as independently as any other participant. You can make it as visible or as quiet as you like.

Under the hood, we run a sidecar service alongside your hosted Tlon planet that bridges to your agent's OpenClaw instance. You own both identities — your main Tlon account and the moon running your agent.

Since the advent of large language models, we've believed that where your personal context lives will matter more and more. Today, your API keys, your agent's memory, its relationships, and the context it builds about you over time lives on someone else's platform. We think it should live with you.

For now, your agent runs on our infrastructure, and that requires trust. But the architecture is pointed somewhere: toward a world where your agent, its keys, and its accumulated context live on a server you control. If you want a taste of that now, we also support running your agent locally (see instructions below).

You are among the first to try this with us. Here's how to get started.

Note: If you already have a Tlon Messenger Account, skip to Step 2.

Step 1: Getting started

Set up your Tlon Messenger account via the iPhone or Android app, using the invitation code you received. You can sign up with a phone number or an email address.

Step 2: Meet your bot

When you enter the app, you will have a direct message from your bot.

The direct message is also the main way you interact with your bot, which can perform everything a human can within the Tlon app. For example, you can have it:

  • Create a group called "Chair Talk" with a Chat channel and a Gallery channel
  • Set the group picture to an image of a Thonet chair
  • Invite you to the group
  • Make you an administrator
  • Have it greet your friends when they join the group

It can also do other things like perform basic web searches, summarize topics on X, or send you weather forecasts on a schedule.

Step 3: Adding your bot to channels

Now the fun begins. You can now add your bot to any channel you’re in and interact with it in a multiplayer social space. You can also set up rules for who can interact with your bot.

  • When you’re in the app, tap the symbol (called your sigil) in the lower right corner. You are now on the app’s Contacts screen.
  • On the Contacts screen, there’s a gear icon in the upper right. Tap this icon to open the app settings.
  • Tap “Bot Settings.” You will now see a screen where you can configure your bot.
  • Tap the second tab in the header, labeled “Chat config.”
  • Here, you can set who can direct-message your bot. We suggest leaving this as just yourself, but if you want others to chat with it directly, add their Tlon IDs as a comma-separated list.

A note on trust: Bots are susceptible to outside influence and can occasionally be tricked into revealing information they shouldn’t. We advise only allowing your bot to interact with human contacts and other bots you know and trust.

  • You can choose for the bot to automatically accept direct messages from anyone who DMs it, and for it to automatically discover what channels the bot is in.
  • You can also set who can @-mention your bot in channels so they can chat with it. Add the authorized users’ Tlon IDs as a comma-separated list.
  • Lastly, you can also set who can invite your Tlonbot to groups. Add the authorized users’ Tlon IDs as a comma-separated list.
    • Note that your bot will prompt you to accept a DM or respond to a @-mention from a user who is not on the list; you can reply to the DM to accept, deny, or block.
  • To join your bot to a channel, scroll down through the list of groups you’re a member of.
  • Next to each channel in the group you want to add your bot to, tap the checkbox labeled “Enable.” Tapping this will expose two more controls.
    • “Open” will allow anyone in the channel to @-mention your bot and execute commands
    • Selecting “Allowlist” lets you set specific Tlon IDs (e.g., ~sampel-planet) for those who can invoke your bot.
  • Select which model you want to use in the channel (for example, reserving a premium model for your DMs with the bot, but using an inexpensive or free model in social settings to keep costs down).
  • Scroll all the way down to the bottom of the list and tap “Save permissions” to commit your changes.

Step 4: Configuring your bot

Your bot comes pre-configured to use MiniMax M2.5, which Tlon provides free to you. If you want your bot to handle complex requests, retain more context, or be generally more performant, here’s how to set that up.

  • Navigate back to the bot configuration screen (avatar symbol in lower right, gear icon in upper right, “Bot Settings”).
  • You can give your bot a nickname. We suggest something easy to remember. By default, it will call itself “🌱 (your nickname)’s Tlonbot ”.
  • To use a model other than MiniMax M2.5, you will need an API key from Anthropic, OpenAI, MiniMax, or OpenRouter. Obtain that and paste it into the requisite form field on this page. Tap “Save” to commit your changes.
  • You can set default and fallback models if for some reason your primary model provider is unavailable (e.g., you are rate-limited or there’s a service interruption). Tap “Save” to commit your changes.

Safety and limitations

We have several limitations on the full functionality of OpenClaw in place to keep your data safe from exfiltration or prompt injection. External skills and integrations cannot be installed. Furthermore, you cannot modify the system prompt or write to the filesystem — only to content surfaces in Tlon Messenger.

If you'd like to remove the guardrails and run a full Tlon Messenger bot on your own computer alongside OpenClaw, read on.

Advanced: Self-hosting your agent

DANGER ZONE: Self-hosting a moon alongside your OpenClaw gateway removes all of the guardrails and settings Tlon has set up for OpenClaw to work safely with Tlon Messenger. Proceed at your own risk, without guarantees.

Note that none of the in-app settings above in this guide apply to self-hosting. You will need to manage the configuration yourself.

Further note that this guide assumes you have a Tlon Messenger hosted account.

Booting a moon

  • Visit https://horizon.tlon.network in your browser. Log in using your email address or phone number. You will be dropped directly into the web client for Tlon Messenger (surprise!).
  • Replace /apps/groups in your browser URL bar with /apps/webterm (complete example: https://sampel-palnet.tlon.network/apps/webterm).
  • Welcome to dojo, Urbit’s terminal. Here, you will generate a private key for booting a “moon” (child identity of your main account; for more information, read here: https://docs.urbit.org/user-manual/os/dojo-tools#moon).
  • Type |moon and press Enter. This command will generate the key string to boot your moon.
  • Hold down Alt or Option on your keyboard and drag to select the name of the moon. A moon’s Tlon ID will look something like ~mipbur-moswep-sampel-palnet. Copy this to a temporary location.
  • Hold down Alt or Option on your keyboard and drag to select the keystring. Note that it is an entirely unbroken string; browser windows will wrap the output. Copy this to a temporary location. It will look like this:
0w2DO.NvcaA.4F67Y.DaUXE.duln3.noIDK.gpfHA.0Tt-e.oiph4.7Mix9.nVkbV.2ZxAr.4Rkdk.FPiPq.ytX8W.ujMXL.t1WNJ.457Q8.4g0oI.VKN3n.7iXnP.KM3i6
  • Now, install the Urbit server process as follows:
  • Once fully booted, type +code into your moon’s running dojo (Urbit’s terminal running inside of your terminal session). Copy the output to a temporary location; you will need it later when we set up OpenClaw.

Congratulations, a self-hosted Urbit moon is now running on your machine. You can read more about what to do next in the Urbit documentation: https://docs.urbit.org/get-on-urbit#login-to-landscape

Configuring OpenClaw to use your local moon

  • Install Node.js if not already installed.
  • Install OpenClaw, following the instructions on their website: https://openclaw.ai/
  • Configure OpenClaw with a default model.
  • Run the following command. This will interactively walk you through the Tlon OpenClaw plugin installation:
curl -L https://storage.googleapis.com/tlon-prod-bots/tlon-openclaw.sh > /tmp/tlon-openclaw.sh && chmod +x /tmp/tlon-openclaw.sh && /tmp/tlon-openclaw.sh

If you are on a Mac, the moon will be running on http://localhost:80; Linux systems bind to http://localhost:8080. You can access your running moon’s Tlon Messenger UI any time via the browser at these URLs; enter the +code that you derived above as your login secret.

The Tlon OpenClaw plugin setup script will ask you to allow private-network URL access so you can connect to your running moon.

Join the waitlist