← 返回 Skills 市场
Roam HQ
作者
Rob Figueiredo
· GitHub ↗
· v1.0.3
· MIT-0
332
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install roam
功能描述
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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install roam - 安装完成后，直接呼叫该 Skill 的名称或使用
/roam触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 332 次。
如何安装 Roam HQ？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install roam」即可一键安装，无需额外配置。
Roam HQ 是免费的吗？
是的，Roam HQ 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Roam HQ 支持哪些平台？
Roam HQ 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Roam HQ？
由 Rob Figueiredo（@robfig）开发并维护，当前版本 v1.0.3。
推荐 Skills