Skip to main content

OpenClaw

OpenClaw is an open-source AI agent that connects to messaging platforms like WhatsApp, Telegram, Slack, and Discord. By installing the Roam skill, your agent can search meetings, get transcripts, run AI analysis on transcripts, send chat messages, and manage groups — all through natural conversation on any platform OpenClaw supports.

OpenClaw works for both team-wide and individual use cases. A shared agent can serve your entire organization — answering questions about meetings, posting summaries, and providing SOPs — while a personal agent connects to a single user's data.

Prerequisites​

Choose Your Access Model​

Roam supports two access models. Choose the one that fits your use case. See the Access Models guide for a full comparison.

Use this when your whole team will interact with the same OpenClaw agent. The agent acts as its own bot persona and can access all public groups, all meetings, and any private groups it's added to.

  1. As a Roam admin, open Roam Administration > Developer.
  2. Create a new API Client and select API Key as the authorization type.
  3. Give it a name (e.g. "OpenClaw").
  4. Select the scopes you need:
    • chat:history — Read messages from public chats or chats the app is added to
    • chat:read — List public chats or ones the bot is added to
    • chat:send_message — Send chat messages in any public group
    • groups:read — View a list of all public groups
    • meetings:read — View a list of all meetings
    • recordings:read — View a list of all meeting recordings
    • transcript:read — View a list of all meeting transcripts
  5. Click Create and copy the API key.

Personal Access (for individual use)​

Use this when a single user wants to connect OpenClaw to their own Roam data. The agent acts as that user and only sees their meetings, messages, and groups.

Prerequisite: Your workspace admin must enable Personal Access Tokens (see Admin Policy for Personal Access).

  1. In Roam, open User Settings > Developer.
  2. Click Create Personal Access Token.
  3. Give it a name (e.g. "OpenClaw").
  4. Select the scopes you need:
    • Chat Read — Search and read your messages
    • Chat Send — Send messages as you
    • Meetings Read — Search your meetings and read transcripts
  5. Click Create Token and copy it.

Install the Roam Skill​

The Roam HQ skill gives your OpenClaw agent access to the Roam API — meetings, transcripts, chat, and groups.

Install from ClawHub​

clawhub install roam

Configure Your API Token​

You can provide your token on first use and ask the agent to save it, or configure it manually in ~/.openclaw/openclaw.json:

{
  "env": {
    "ROAM_API_KEY": "YOUR_API_TOKEN"
  }
}

Replace YOUR_API_TOKEN with the API key or Personal Access Token you created above. No restart is needed — the environment is read per session.

Verify the Connection​

Send your agent a message to confirm the Roam skill is working:

"What meetings did I have this week?"

The agent should use the Roam API to list your recent meetings.

What You Can Do​

Once the skill is installed, try asking your agent:

  • "Summarize my meetings from this week"
  • "What did we decide about pricing in last week's meeting?"
  • "What action items came out of the product review?"
  • "What meetings happened across the team this week?"
  • "Send a message to Engineering: deploy is complete"
  • "Post the weekly standup summary to General"

The skill uses the Roam API to list meetings, retrieve transcripts, run AI-powered transcript analysis, send messages, and browse chat history. See the API documentation for a complete endpoint reference.