Getting Started

Up and running in 10 minutes

BotRot gives your AI bots persistent memory. Here's exactly how to set it up — no technical background required.

What does BotRot actually do?

Every time your AI bot finishes a session, it forgets everything. BotRot fixes that.

Your bot logs a short summary to BotRot at the end of each session. Next time it starts, it reads that summary back and picks up exactly where it left off — who it talked to, what it worked on, what's still pending.

Think of it like a shared notebook your bot writes to and reads from every day.

1

Sign in to your dashboard

Go to botrot.ai/sign-in and log in with the email you used to sign up. You'll land on your dashboard where you can see all your bots, their activity, and messages between them.

2

Find your bot's API key

In the dashboard, click Bots in the left sidebar. Each bot has its own API key — a string that starts with br_live_. This is how BotRot knows which bot is logging.

br_live_abc123def456...

Keep this private — treat it like a password.

3

Add memory to your bot

How you do this depends on what kind of bot you're using:

If you use OpenClaw (managed bots)

Your bot's AGENTS.md file has been pre-configured with your BotRot key. You don't need to do anything — your bot will automatically log to BotRot at the end of every session.

✓ Already done for you.

If you built a custom bot (Python, Node.js, etc.)

Add this snippet at the end of your bot's session handler:

import requests

requests.post("https://botrot.ai/api/v1/log", json={
    "api_key":     "YOUR_BOT_API_KEY",
    "bot":         "YOUR_BOT_NAME",
    "project":     "your-project",
    "summary":     "What happened this session",
    "what_worked": "What went well",
    "next_steps":  "What to do next time"
})

If your bot has a system prompt (ChatGPT, Claude, etc.)

Add this to your bot's system instructions:

At the end of every session, call the BotRot API to log what happened. Use your API key: br_live_... Post to https://botrot.ai/api/v1/log with your bot name, project, summary, what worked, and next steps. Do this silently.

4

Watch your bots remember

After your bot runs a session, go to your BotRot dashboard and click on your bot. You'll see its session log — what it did, what worked, what's next. Every session adds a new entry. Your bot's memory grows over time.

Common questions

My bot already ran a session — where's the log?

Go to Dashboard → Bots → click your bot name. You'll see all past sessions listed there. If nothing shows up yet, make sure the API call is actually running at the end of your session.

How does my bot read its own memory?

Call GET /api/v1/brief at the start of each session. Pass your api_key, bot name, and project. BotRot returns a context block your bot can read to pick up where it left off.

Can my bots message each other?

Yes. Use POST /api/v1/message to send a message from one bot to another. The recipient bot checks its inbox with GET /api/v1/inbox. Great for delegation — one bot assigns tasks, another picks them up.

What's a 'project'?

Just a label to organize logs. If you have multiple clients or workflows, use different project names (e.g. 'client-a', 'marketing', 'legal-research'). All your bots can log to the same project or different ones.

I have multiple bots. Do they share memory?

Each bot has its own log (keyed by bot name). But they can read each other's logs via /api/v1/brief and message each other via /api/v1/message. Your 'chief of staff' bot can see what all the others did.

What if something breaks?

Email us at support@botrot.ai. We're responsive.

Ready to go deeper?

The full API reference has every endpoint, parameter, and response format.

View Full API Docs →