← Back to Skills Marketplace
Roam HQ
by
Rob Figueiredo
· GitHub ↗
· v1.0.3
· MIT-0
332
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install 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 ab...
Usage Guidance
This skill appears coherent, but before installing: 1) Only provide a Roam API key you trust—prefer a token scoped to the minimum privileges (read-only if available) and limit group/post permissions if possible. 2) Be aware that transcripts and prompts will be sent to Roam's API (data leaves your environment to that service). 3) Because the agent can invoke the skill autonomously, it could post messages using chat.post — review and monitor Roam activity/logs and revoke the token if you see unexpected actions. 4) The skill metadata lacks a homepage and the publisher is not human-readable; if provenance matters, try to verify the publisher or test with a restricted account/token first. 5) No install or files are included, which reduces disk risk, but you should still follow the precautions above regarding API key scope and monitoring.
Capability Analysis
Type: OpenClaw Skill
Name: roam
Version: 1.0.3
The 'roam' skill is a standard API integration for Roam HQ, providing instructions for an AI agent to manage meetings, transcripts, and chat messages. It uses the official Roam API (api.ro.am) and requires a user-provided API key, with no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description, declared requirement (ROAM_API_KEY), and the listed endpoints (transcript.*, chat.post, groups.list) align with a Roam HQ REST integration. One minor note: the registry entry has no homepage and source is 'unknown', so the publisher cannot be verified from the metadata alone — this affects trust but not coherence.
Instruction Scope
SKILL.md instructs the agent to call Roam API endpoints only, and does not reference local files, other env vars, or unrelated services. It does, however, explicitly transmit transcript contents to Roam (via transcript.prompt) and can post messages (chat.post), which is expected behavior for this skill but means user data and messages can be read/sent through the provided API key.
Install Mechanism
Instruction-only skill with no install spec and no code files. Nothing is written to disk or downloaded during install, which minimizes install-time risk.
Credentials
Only ROAM_API_KEY is required and is appropriate for the described API interactions. The SKILL.md does not access any other environment variables. Recommend using a token with the minimal permissions necessary.
Persistence & Privilege
The skill is not always-enabled (always:false). It can be invoked autonomously by the agent (platform default). Because the skill can call chat.post, autonomous invocation could result in outbound posts to Roam groups — expected for its purpose but worth considering before granting the API key.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install roam - After installation, invoke the skill by name or use
/roam - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated API base URL from https://api.ro.am/v0 to https://api.ro.am.
- Updated endpoint paths to include versioning (e.g., /v0/transcript.list).
- Changed the groups listing endpoint to /v1/groups.list.
- No code or functionality changes, only documentation updates to reflect new API structure.
v1.0.2
- Removed documentation for the `POST /webhook.subscribe` endpoint.
- Minor formatting update to the base URL documentation (removed environment variable usage).
v1.0.1
- Improved SKILL.md formatting and structure for clarity.
- Added metadata section, including emoji and environment requirements.
- Simplified and condensed setup instructions.
- No functional or API changes.
v1.0.0
- Initial release of the Roam skill for integrating with Roam HQ via REST API.
- Search meetings, retrieve transcripts, and analyze transcripts with AI prompts.
- Send messages and manage groups through chat features.
- Simple environment setup with persistent API key storage.
- Supports common workflows: meeting summaries, topic/person search, and follow-ups.
- Includes rate limit handling per Roam API guidelines.
Metadata
Frequently Asked Questions
What is Roam HQ?
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... It is an AI Agent Skill for Claude Code / OpenClaw, with 332 downloads so far.
How do I install Roam HQ?
Run "/install roam" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Roam HQ free?
Yes, Roam HQ is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Roam HQ support?
Roam HQ is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Roam HQ?
It is built and maintained by Rob Figueiredo (@robfig); the current version is v1.0.3.
More Skills