← 返回 Skills 市场
Fathom
作者
Lucas Synnott
· GitHub ↗
· v1.0.0
2361
总下载
1
收藏
8
当前安装
1
版本数
在 OpenClaw 中安装
/install fathom
功能描述
Connect to Fathom AI to fetch call recordings, transcripts, and summaries. Use when user asks about their meetings, call history, or wants to search past conversations.
使用说明 (SKILL.md)
Fathom Skill
Connect to Fathom AI to fetch call recordings, transcripts, and summaries.
Setup
1. Get Your API Key
- Go to developers.fathom.ai
- Create an API key
- Copy the key (format:
v1XDx...)
2. Configure
# Option A: Store in file (recommended)
echo "YOUR_API_KEY" > ~/.fathom_api_key
chmod 600 ~/.fathom_api_key
# Option B: Environment variable
export FATHOM_API_KEY="YOUR_API_KEY"
3. Test Connection
./scripts/setup.sh
Commands
List Recent Calls
./scripts/list-calls.sh # Last 10 calls
./scripts/list-calls.sh --limit 20 # Last 20 calls
./scripts/list-calls.sh --after 2026-01-01 # Calls after date
./scripts/list-calls.sh --json # Raw JSON output
Get Transcript
./scripts/get-transcript.sh 123456789 # By recording ID
./scripts/get-transcript.sh 123456789 --json
./scripts/get-transcript.sh 123456789 --text-only
Get Summary
./scripts/get-summary.sh 123456789 # By recording ID
./scripts/get-summary.sh 123456789 --json
Search Calls
./scripts/search-calls.sh "product launch" # Search transcripts
./scripts/search-calls.sh --speaker "Lucas"
./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15
API Reference
| Endpoint | Method | Description |
|---|---|---|
/meetings |
GET | List meetings with filters |
/recordings/{id}/transcript |
GET | Full transcript with speakers |
/recordings/{id}/summary |
GET | AI summary + action items |
/webhooks |
POST | Register webhook for auto-sync |
Base URL: https://api.fathom.ai/external/v1
Auth: X-API-Key header
Filters for list-calls
| Filter | Description | Example |
|---|---|---|
--limit N |
Number of results | --limit 20 |
--after DATE |
Calls after date | --after 2026-01-01 |
--before DATE |
Calls before date | --before 2026-01-15 |
--cursor TOKEN |
Pagination cursor | --cursor eyJo... |
Output Formats
| Flag | Description |
|---|---|
--json |
Raw JSON from API |
--table |
Formatted table (default for lists) |
--text-only |
Plain text (transcripts only) |
Examples
Get your last call's summary
# Get latest call ID
CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')
# Get summary
./scripts/get-summary.sh $CALL_ID
Export all calls from last week
./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json
Find calls mentioning a topic
./scripts/search-calls.sh "quarterly review"
Troubleshooting
| Error | Solution |
|---|---|
| "No API key found" | Run setup or set FATHOM_API_KEY |
| "401 Unauthorized" | Check API key is valid |
| "429 Rate Limited" | Wait and retry |
| "Recording not found" | Verify recording ID exists |
Webhook Setup (Advanced)
For automatic transcript ingestion, see the webhook setup guide:
./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook
Requires a publicly accessible HTTPS endpoint.
安全使用建议
This skill's scripts appear to legitimately call Fathom's official API and implement the described features, but the registry metadata omitted the fact that the skill requires an API key and optionally reads ~/.fathom_api_key. Before installing: (1) Verify the skill source/trustworthiness (source/homepage unknown). (2) Expect to provide a FATHOM_API_KEY; prefer setting it as an environment variable rather than writing it to a file, and if you do store it in ~/.fathom_api_key keep file perms locked (chmod 600). (3) Be careful when running setup-webhook.sh: it will register a webhook that will deliver transcripts to whatever endpoint you provide — only use a trusted HTTPS endpoint and verify webhook signatures on your endpoint. (4) Note that the script prints the webhook secret to stdout; treat that output as sensitive. (5) If you need stronger assurance, run the scripts in an isolated/sandboxed environment first and inspect network traffic to confirm calls go only to api.fathom.ai. (6) Ask the publisher/registry to update metadata to declare FATHOM_API_KEY and the ~/.fathom_api_key config path so the requirement is explicit.
功能分析
Type: OpenClaw Skill
Name: fathom
Version: 1.0.0
The OpenClaw AgentSkills skill bundle for Fathom AI appears benign. All scripts (`get-summary.sh`, `get-transcript.sh`, `list-calls.sh`, `search-calls.sh`, `setup-webhook.sh`, `setup.sh`) consistently interact with the legitimate Fathom AI API (`https://api.fathom.ai/external/v1`) using `curl`. API keys are handled securely by reading from `FATHOM_API_KEY` environment variable or `~/.fathom_api_key`. There is no evidence of data exfiltration to unauthorized endpoints, malicious command execution (e.g., `curl|bash`), persistence mechanisms, or prompt injection attempts against the agent in `SKILL.md` or other files. The `setup-webhook.sh` script allows registering webhooks to user-provided URLs, which is a legitimate feature and not indicative of malicious intent by the skill itself.
能力评估
Purpose & Capability
Name/description match the code: scripts call https://api.fathom.ai to list meetings, fetch transcripts/summaries, and register webhooks. However, the registry metadata lists no required environment variables or primary credential, while the scripts and SKILL.md clearly require an API key (FATHOM_API_KEY) and optionally read ~/.fathom_api_key. The missing declaration of the API key/config path is an incoherence.
Instruction Scope
Runtime instructions and scripts stay within the described scope: they use curl/jq to call the Fathom API endpoints and provide webhook registration. They do instruct the user to store an API key in ~/.fathom_api_key (or set FATHOM_API_KEY) and to provide a public HTTPS webhook endpoint; both are reasonable for the feature set but expand required operational setup. The scripts do not access or exfiltrate other local files or send data to non-Fathom endpoints (except the provided webhook URL which is user-controlled).
Install Mechanism
There is no install spec; the skill is a collection of shell scripts and documentation. No remote downloads or package installs are performed by the skill itself, minimizing install-time risk.
Credentials
The skill requires a single API credential (FATHOM_API_KEY) to function, which is proportionate. But that credential and the config path (~/.fathom_api_key) are not declared in the registry metadata (required env vars and primary credential are empty). This mismatch is a red flag: the skill will silently fail without the key and the metadata doesn't warn users or the platform that a secret is needed. The scripts also print webhook secrets to stdout after registration, which could be exposed if the user runs them in an untrusted environment.
Persistence & Privilege
The skill does not request permanent inclusion (always: false) and does not modify other skills or system-wide configuration. It suggests storing an API key in a home file, but it does not itself write persistent files or change agent settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install fathom - 安装完成后，直接呼叫该 Skill 的名称或使用
/fathom触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release - Connect to Fathom AI for call transcripts and summaries
元数据
常见问题
Fathom 是什么？
Connect to Fathom AI to fetch call recordings, transcripts, and summaries. Use when user asks about their meetings, call history, or wants to search past conversations. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2361 次。
如何安装 Fathom？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install fathom」即可一键安装，无需额外配置。
Fathom 是免费的吗？
是的，Fathom 完全免费（开源免费），可自由下载、安装和使用。
Fathom 支持哪些平台？
Fathom 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Fathom？
由 Lucas Synnott（@lucassynnott）开发并维护，当前版本 v1.0.0。
推荐 Skills