Skip to main content

🔗 OpenClaw Integration

Connect Kaia with OpenClaw, an open-source personal AI gateway, to manage your productivity system from WhatsApp, Slack, Telegram, Discord, Signal, and 20+ other messaging channels.

What Is OpenClaw? 🌐​

OpenClaw is an open-source personal AI assistant that acts as a messaging gateway. It connects to the channels where you already communicate and gives you a single AI agent that works everywhere.

When paired with Mind Your Now, OpenClaw becomes a bridge between your messaging world and your productivity system. You can manage tasks, check your calendar, trigger your daily Compass briefing, and more — all without opening the MYN app.

How It Works 🤝​

Kaia and OpenClaw communicate using the Agent-to-Agent (A2A) protocol — a lightweight, secure messaging system built specifically for AI agents to collaborate.

The Architecture​

You ↔ WhatsApp/Slack/Telegram ↔ OpenClaw ↔ Kaia (MYN)
  1. You send a message on any connected channel
  2. OpenClaw receives it and understands your intent
  3. OpenClaw calls the appropriate MYN tool (tasks, calendar, briefing, etc.)
  4. Kaia processes the request and returns results
  5. OpenClaw formats the response and sends it back to you

Both agents maintain their own capabilities and can delegate work to each other. Kaia handles productivity; OpenClaw handles communication.

Setting Up the Pairing 🔐​

Step 1: Generate an Invite Code​

  1. Open Mind Your Now web app
  2. Go to Settings → Agent Pairing
  3. Click Generate Invite Code
  4. Copy the code (format: ABC-12345)
tip

Invite codes are single-use and expire after 24 hours. Generate a new one if yours expires.

Step 2: Install the MYN Plugin in OpenClaw​

If you're self-hosting OpenClaw, install the MYN plugin:

npm install @mind-your-now/openclaw-plugin

Add it to your OpenClaw configuration:

{
  "plugins": {
    "myn": {
      "apiKey": "your-myn-api-key",
      "baseUrl": "https://api.mindyournow.com"
    }
  }
}

Step 3: Redeem the Invite Code​

In your OpenClaw agent, use the pairing tool:

Pair with MYN using invite code ABC-12345

OpenClaw will:

  1. Send the invite code to MYN
  2. Exchange capability manifests
  3. Receive bilateral authentication keys
  4. Confirm the pairing

Step 4: Verify the Connection​

Send a test message through any connected channel:

What's on my task list today?

If everything is working, OpenClaw will query Kaia and return your current tasks.

Available Tools 🛠️​

Once paired, OpenClaw has access to 13 MYN tools:

Task Management​

  • List tasks — View tasks filtered by priority, status, or date
  • Create tasks — Add new tasks with priority, schedule, and duration
  • Update tasks — Change priority, dates, descriptions, and more
  • Complete tasks — Mark tasks as done
  • Archive tasks — Move completed tasks to archive
  • Search tasks — Find tasks by keyword across your entire system

Daily Briefings​

  • Check briefing status — See if today's Compass briefing is ready
  • Generate briefing — Trigger a fresh Compass analysis
  • Get briefing — Retrieve the full daily briefing with corrections
  • Apply corrections — Accept AI-suggested task adjustments
  • Complete session — Mark the briefing session as finished

Calendar​

  • List events — View upcoming calendar events in a date range
  • Create events — Add standalone events to your calendar
  • Update events — Modify existing events
  • Delete events — Remove events

Habits​

  • View streaks — Check your current habit streak progress
  • Skip habits — Skip a habit without breaking your streak
  • View chains — See grouped habit sequences
  • Manage schedule — Set habit schedules and reminders

Household​

  • List members — See who's in your household
  • Manage chores — View, assign, and complete household chores
  • Invite members — Send household invitations

Memory​

  • Recall — Retrieve stored contextual information
  • Search memories — Find specific memories by keyword, category, or tags
  • Forget — Remove a specific memory

Other Tools​

  • Planning — AI-powered schedule generation and rescheduling
  • Search — Unified search across tasks, events, notes, and memories
  • Timers — Create countdowns, alarms, and pomodoro sessions
  • Lists — Manage grocery and shopping lists
  • Profile — Access goals and preferences
  • Projects — Organize tasks into project groups

Security & Trust 🔒​

Authentication​

The pairing uses bilateral pre-shared keys — each agent gets a unique key to authenticate requests to the other. These are separate from your MYN API key and are scoped specifically for agent-to-agent communication.

  • Standard tools: Authenticated via X-API-KEY header
  • A2A protocol: Authenticated via X-Agent-Key header (distinct key)

Capability Hash Exchange​

Every message between agents includes a SHA-256 hash of the sender's capability manifest. If either agent's capabilities change (new tools, version upgrade), the hash mismatch is detected and capabilities automatically re-sync.

This means the integration self-heals — no manual reconfiguration needed after updates.

Circuit Breakers​

Built-in rate monitoring tracks message volume using exponential moving averages. If an agent suddenly exceeds 3x its normal message rate, the circuit breaker trips and suspends communication for one hour.

This protects against:

  • Runaway agent loops
  • Accidental message floods
  • Compromised agent keys

Autonomy Tiers​

Access levels are tied to your MYN subscription:

TierAccess LevelDescription
FreeReactive queriesAsk questions, get answers
ExecutiveFull autonomousOpenClaw can proactively create tasks, manage habits, and schedule your day

Data Privacy​

  • All communication uses HTTPS with TLS encryption
  • Memory writes are tagged with source agent (provenance tracking)
  • API keys are BCrypt-hashed on the server
  • Rate limits: 60 requests/minute per API key

Example Conversations 💬​

Morning Routine (via WhatsApp)​

You: "Good morning, what's my day look like?"

OpenClaw → Kaia: Generates Compass briefing

OpenClaw: "Morning! Here's your briefing: You have 3 Critical Now tasks, 2 meetings, and your 'Morning workout' habit is due. Your calendar is clear from 9-11 AM — great focus time. Want me to start a pomodoro session?"

Quick Task Creation (via Slack)​

You: "Add a task: Review Q1 budget report, due Friday, critical priority"

OpenClaw → Kaia: Creates task via MYN Tasks API

OpenClaw: "Done! Created 'Review Q1 budget report' as Critical Now, due Friday. You now have 3 critical tasks (healthy max is 5). Want me to check if Friday has focus time available?"

Habit Check-in (via Telegram)​

You: "How are my habit streaks?"

OpenClaw → Kaia: Queries habit chains

OpenClaw: "Looking good! 🔥 Morning workout: 14-day streak. 📚 Reading: 7-day streak. 💧 Water intake: 3-day streak. You have 'Evening meditation' due today — want me to set a reminder?"

Grocery List (via Signal)​

You: "Add milk, eggs, and bread to the grocery list"

OpenClaw → Kaia: Bulk adds items to grocery list

OpenClaw: "Added 3 items to your grocery list. You now have 8 items total. Want me to convert any of them to tasks for your next shopping trip?"

Troubleshooting 🔧​

Pairing Fails​

  • Expired code: Invite codes expire after 24 hours. Generate a new one.
  • Already redeemed: Each code can only be used once. Generate a fresh code.
  • Network issues: Ensure OpenClaw can reach https://api.mindyournow.com.

Commands Not Working​

  • Check API key: Verify your MYN API key has AGENT_FULL scope.
  • Check pairing status: Use the A2A ping tool to verify the connection.
  • Rate limited: If you're getting 429 errors, wait a minute and retry.

Capability Mismatch​

If OpenClaw reports stale capabilities:

  1. The auto-sync should handle this automatically
  2. If it persists, re-pair the agents with a fresh invite code

For Developers 👩‍💻​

npm Packages​

Source Code​

A2A Protocol Reference​

The Agent-to-Agent protocol uses three core endpoints:

Redeem Invite (no auth)

POST /api/v1/agent/redeem-invite
{
  "inviteCode": "ABC-12345",
  "agentName": "openclaw",
  "displayName": "My OpenClaw Agent",
  "capabilityHash": "<sha256-hex>",
  "capabilityManifest": { ... }
}
→ Returns: { mynInboundKey, agentId }

Ping (X-Agent-Key auth)

POST /a2a/message
Headers: X-Agent-Key: <mynInboundKey>
{
  "from": "openclaw",
  "intent": "ping",
  "capabilityHash": "<sha256-hex>"
}
→ Returns: { capabilityUpdatePending?: boolean }

Send Message (X-Agent-Key auth)

POST /a2a/message
Headers: X-Agent-Key: <mynInboundKey>
{
  "from": "openclaw",
  "intent": "chat",
  "message": "What tasks are due today?",
  "capabilityHash": "<sha256-hex>"
}

Capability Hash Computation​

The capability hash is a deterministic SHA-256 of the deep-sorted capability manifest:

import { createHash } from 'crypto';

function computeCapabilityHash(manifest) {
  const sorted = deepSortKeys(manifest);
  const json = JSON.stringify(sorted);
  return createHash('sha256').update(json, 'utf8').digest('hex');
}

Key-order independence ensures the same manifest always produces the same hash, regardless of serialization order.

Questions about the OpenClaw integration? Contact support or check out the OpenClaw GitHub repository.