B Buffy Agent
Buffy Agent Docs

Set up Buffy with OpenClaw

How to connect your OpenClaw project to Buffy so your agent can create habits, tasks, routines, and reminders using one behavior core.

If you build or use agents in OpenClaw, you can wire them to Buffy so habits, tasks, and routines are stored and reminded in one place—instead of each OpenClaw workflow having its own state.

This doc covers how to set up that connection: Buffy account, API access, and how to point OpenClaw at Buffy’s behavior core.

What you get

Once Buffy is connected to OpenClaw:

  • Your OpenClaw agent can create and update activities (habits, tasks, routines) via Buffy’s API.
  • Reminders are sent by Buffy (e.g. to Telegram or Slack) based on the same data—no duplicate logic in OpenClaw.
  • Daily briefings and history live in Buffy, so you have one place to see “what’s on today” and “what actually happened.”

OpenClaw stays the orchestration and UX layer; Buffy is the behavior engine.

Prerequisites

  • A Buffy account (sign up at buffyai.org).
  • An OpenClaw project (or equivalent) where you can configure an API endpoint and credentials.

Step 1: Create a Buffy account and sign in

  1. Go to buffyai.org and sign up (or log in).
  2. Complete sign-in so you have access to the dashboard (e.g. Account, API keys, settings).

You’ll use the dashboard to create an API key and (optionally) to connect Telegram or Slack for reminders.

Step 2: Create an API key for OpenClaw

Buffy uses API keys so OpenClaw can call the Buffy API on your behalf.

  1. In the Buffy dashboard, open Account (or Settings) and find API keys.
  2. Create a new API key. Choose:
    • User-scoped key — if OpenClaw will act as you (one user). Use this for a personal “habit agent” or “todo agent” in OpenClaw.
    • System key — if you’re building a multi-user integration and will send a user id on each request (see Buffy + OpenClaw API Integration).
  3. Copy and store the key securely. You won’t see it again in full; if you lose it, revoke it and create a new one.

For most “use Buffy from my OpenClaw agent” setups, a user-scoped key is enough: one key per Buffy user, used by that user’s OpenClaw project.

Step 3: Configure OpenClaw to use Buffy

In your OpenClaw project (or the tool that runs your agent):

  1. Set the Buffy API base URL to:
    • https://api.buffyai.org (production)
  2. Set the API key you created in Step 2 (e.g. as an environment variable or in OpenClaw’s config for the Buffy skill/action).
  3. Send requests to Buffy’s API:
    • Main endpoint for conversation: POST /v1/message with the user’s message and any context.
    • Auth: send the API key as a Bearer token in the Authorization header.

Exact steps depend on how OpenClaw exposes “skills” or “actions.” Typically you’ll add a Buffy “action” or “tool” that:

  • Calls POST https://api.buffyai.org/v1/message with the user’s text (and optionally user id, channel, etc.).
  • Passes the API key in Authorization: Bearer <your-api-key>.
  • Returns Buffy’s reply to the user.

If you’re building the integration yourself, see the message format and auth details in:

Step 4: Choose where reminders go (optional)

Buffy can send reminders (e.g. for habits and routines) to Telegram, Slack, or other channels. To get reminders outside OpenClaw:

  1. In the Buffy dashboard, open Account or Settings.
  2. Connect Telegram and/or Slack (or the channels your plan supports).
  3. When you create a habit or routine in OpenClaw, you can say “remind me in Telegram” (or Slack); Buffy will use the connected channel.

If you don’t connect any channel, reminders may still be visible in the Buffy dashboard or the next time you talk to your OpenClaw agent—depending on how your setup is configured.

Step 5: Test the connection

  1. In OpenClaw (or your agent UI), send a message that should create an activity, for example:
    • “Weekdays 7:30–8:00, morning startup: water, 10 min planning, stretch.”
  2. Buffy should create the routine and confirm.
  3. In the Buffy dashboard, check Activities (or the equivalent) to see the new routine.
  4. If you connected Telegram or Slack, wait for the time window or check that reminders are configured for that activity.

If nothing appears, check:

  • API key is correct and sent as Authorization: Bearer <key>.
  • Base URL is https://api.buffyai.org.
  • Your OpenClaw action is actually calling POST /v1/message (or the correct endpoint) with the user’s message.

Summary

| Step | Action | |------|--------| | 1 | Sign up / log in at buffyai.org. | | 2 | Create an API key (Account → API keys); use a user-scoped key for a single-user OpenClaw agent. | | 3 | In OpenClaw, set base URL https://api.buffyai.org and the API key; call POST /v1/message with Bearer auth. | | 4 | (Optional) Connect Telegram/Slack in Buffy for reminders. | | 5 | Test by creating a habit or routine from OpenClaw and confirming it in Buffy. |

Further reading

Buffy Agent · Personal behavior agent for habits, tasks and routines.