π¦ ClawHub
Roam HQ
by @robfig
Interact with Roam HQ via REST API. Search meetings, get transcripts, prompt transcripts with AI, send messages, and manage groups. Use when the user asks ab...
TERMINAL
clawhub install roamπ About This Skill
name: roam description: > Interact with Roam HQ via REST API. Search meetings, get transcripts, prompt transcripts with AI, send messages, and manage groups. Use when the user asks about meetings, call notes, transcripts, or wants to send messages in Roam. metadata: { "openclaw": { "emoji": "π’", "requires": { "env": ["ROAM_API_KEY"] }, "primaryEnv": "ROAM_API_KEY", }, }
Roam HQ
API docs: https://developer.ro.am β fetch endpoint details from there as needed.
Auth
ROAM_API_KEY env var (Personal Access Token from Roam Settings β Developer).
All requests: Authorization: Bearer $ROAM_API_KEY
Base URL: https://api.ro.am
Key Endpoints
GET /v0/transcript.list β list meetings (supports after, before, limit)GET /v0/transcript.info?id= β transcript details + summaryPOST /v0/transcript.prompt { "id": "...", "prompt": "..." } β AI analysis of a transcriptPOST /v0/chat.post { "groupId": "...", "text": "..." } β send a messageGET /v0/chat.history?groupId= β message historyGET /v1/groups.list β list groupsRate Limits
10 burst, 1 req/sec sustained. Respect Retry-After on 429s.
Common Patterns
1. Summarize recent meetings: transcript.list β transcript.prompt for each
2. Find discussions about a topic/person: transcript.list β filter by participants β transcript.prompt
3. Post follow-up: Get transcript β prompt for action items β chat.post to a group