{"skill":{"slug":"roam","displayName":"Roam HQ","summary":"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...","description":"---\nname: roam\ndescription: >\n  Interact with Roam HQ via REST API. Search meetings, get transcripts,\n  prompt transcripts with AI, send messages, and manage groups. Use when\n  the user asks about meetings, call notes, transcripts, or wants to send\n  messages in Roam.\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"🏢\",\n        \"requires\": { \"env\": [\"ROAM_API_KEY\"] },\n        \"primaryEnv\": \"ROAM_API_KEY\",\n      },\n  }\n---\n\n# Roam HQ\n\nAPI docs: https://developer.ro.am — fetch endpoint details from there as needed.\n\n## Auth\n\n`ROAM_API_KEY` env var (Personal Access Token from Roam Settings → Developer).\n\nAll requests: `Authorization: Bearer $ROAM_API_KEY`\n\nBase URL: `https://api.ro.am`\n\n## Key Endpoints\n\n- `GET /v0/transcript.list` — list meetings (supports `after`, `before`, `limit`)\n- `GET /v0/transcript.info?id=<id>` — transcript details + summary\n- `POST /v0/transcript.prompt` `{ \"id\": \"...\", \"prompt\": \"...\" }` — AI analysis of a transcript\n- `POST /v0/chat.post` `{ \"groupId\": \"...\", \"text\": \"...\" }` — send a message\n- `GET /v0/chat.history?groupId=<id>` — message history\n- `GET /v1/groups.list` — list groups\n\n## Rate Limits\n\n10 burst, 1 req/sec sustained. Respect `Retry-After` on 429s.\n\n## Common Patterns\n\n1. **Summarize recent meetings:** `transcript.list` → `transcript.prompt` for each\n2. **Find discussions about a topic/person:** `transcript.list` → filter by participants → `transcript.prompt`\n3. **Post follow-up:** Get transcript → prompt for action items → `chat.post` to a group\n","tags":{"latest":"1.0.3"},"stats":{"comments":0,"downloads":674,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":4},"createdAt":1773349363542,"updatedAt":1778491869269},"latestVersion":{"version":"1.0.3","createdAt":1773361554990,"changelog":"- Updated API base URL from https://api.ro.am/v0 to https://api.ro.am.\n- Updated endpoint paths to include versioning (e.g., /v0/transcript.list).\n- Changed the groups listing endpoint to /v1/groups.list.\n- No code or functionality changes, only documentation updates to reflect new API structure.","license":"MIT-0"},"metadata":{"setup":[{"key":"ROAM_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"robfig","userId":"s178m7h58r8azjpdddyzfcw0rd8849g9","displayName":"Rob Figueiredo","image":"https://avatars.githubusercontent.com/u/536325?v=4"},"moderation":null}