# OpenClaw

[OpenClaw](https://openclaw.ai/) is an open-source AI agent that connects to messaging platforms like WhatsApp, Telegram, Slack, and Discord. By installing the [Roam skill](https://clawhub.ai/robfig/roam), 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

- A running [OpenClaw instance](https://docs.openclaw.ai/gateway/setup)
- A Roam API token (see below)

## Choose Your Access Model

Roam supports two access models. Choose the one that fits your use case. See the [Access Models guide](/docs/guides/access-models) for a full comparison.

### Organization Access (recommended for shared agents)

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](/docs/guides/access-models#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](https://clawhub.ai/robfig/roam) gives your OpenClaw agent access to the Roam API — meetings, transcripts, chat, and groups.

### Install from ClawHub

```bash
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`:

```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](/docs/roam-api/roam-hq-api) for a complete endpoint reference.