Skip to main content

OpenClaw integration

OpenClaw is an open-source personal AI agent that you run yourself and reach through messaging apps such as WhatsApp, Slack, Telegram, Discord and Signal. With the Mind Your Now plugin installed, your OpenClaw agent can read and change your tasks, calendar, habits, lists and more from any of those apps.

There are two parts, and you can use the first on its own:

  1. The plugin gives your agent Mind Your Now tools, using an API key.
  2. Pairing connects your agent to Kaia, so the two can pass work and messages to each other.

Step 1: Create an API key​

  1. In Mind Your Now on a computer, go to Settings → API Keys.
  2. Click Create API Key.
  3. Enter a Name, for example "OpenClaw Agent".
  4. Under Permissions, check Full Agent Access.
  5. Click Create API Key, then copy the key. It is shown only once.

Step 2: Install the plugin​

Install the plugin package, @mind-your-now/myn, into OpenClaw:

openclaw plugins install @mind-your-now/myn

Then add it to your OpenClaw configuration with your key:

plugins:
entries:
myn:
enabled: true
config:
apiKey: "your-myn-api-key"
baseUrl: "https://api.mindyournow.com" # optional; this is the default

The plugin only connects over HTTPS.

Step 3: Check it works​

Send your agent a message from any connected app:

What's in Critical Now today?

It should answer with your current tasks.

Step 4 (optional): Pair your agent with Kaia​

  1. In Mind Your Now in a web browser, go to Settings → Kaia AI → Connected Agents and click Connect Agent.

  2. Click Generate Invite Code. You get a code like ABC-12345. It works once and expires shortly; the dialog shows the time.

  3. Ask your agent to pair, giving it the code:

    Pair with Mind Your Now using invite code ABC-12345
  4. Close the dialog. Your agent appears under Connected Agents as Connected, or Pending until pairing finishes. To remove it, use Disconnect.

Once paired, your agent can take tasks Kaia hands it, send her information, and act for you on things outside the app. Kaia replies only after you've allowed AI data sharing in Settings → Kaia AI. How much a paired agent can do depends on your Kaia plan.

The plugin's tools​

The plugin adds 14 tools to your agent:

ToolWhat it does
myn_tasksList, create, update, complete, archive and search tasks, habits and chores; build plans with ordered steps
myn_debriefCheck, write and read Compass reports, and apply their suggested changes
myn_calendarList calendars and events; create, update, move and delete events
myn_habitsStreaks, skips, habit chains, schedules and reminders
myn_listsGrocery and shopping lists
myn_searchSearch across tasks, events, notes and memories
myn_timersCountdowns, alarms and pomodoro sessions
myn_memoryRemember, recall, search and forget Kaia's memories
myn_profileYour profile, goals and preferences
myn_householdHousehold members, invites and chores
myn_projectsBrowse collections and file tasks into them
myn_planningPlan and reschedule your tasks on your calendar
myn_ynabYour YNAB budget, if you've connected YNAB in Settings → Integrations
myn_a2a_pairingPair with Kaia and send her messages

The plugin also passes your agent the Kaia memories that are relevant to each message, so you don't have to repeat yourself.

Security​

  • Your API key is stored hashed on our servers and shown to you only once. Revoke it at any time in Settings → API Keys.
  • Pairing creates a separate pair of keys for messages between your agent and Kaia. They are not your API key.
  • The plugin removes anything that looks like a secret (tokens, keys, passwords) from tool results before your agent sees them.
  • If a paired agent suddenly sends far more messages than usual, Mind Your Now pauses the connection for a while.

Example​

You (in Slack): Add a task to review the Q1 budget, starting Friday.

Agent: Added "Review the Q1 budget", starting Friday.

Troubleshooting​

  • The agent has no Mind Your Now tools. Check that apiKey is set in the plugin config and that baseUrl, if set, starts with https://.
  • Requests are refused. Make sure the key has Full Agent Access and hasn't expired or been revoked.
  • Pairing fails. The code may have expired or already been used. Generate a new one.

For developers​

Questions: support@mindyournow.com.