名称： fathom
描述： 连接 Fathom AI，获取通话录音、转录文本和摘要。当用户询问其会议、通话历史，或想搜索过往对话时使用。
阅读时间：
- 用户询问其 Fathom 通话或会议
- 用户想要搜索通话转录文本
- 用户需要通话摘要或行动项
- 用户想要设置 Fathom 集成
元数据：
clawdbot:
emoji: "📞"
requires:
bins: ["curl", "jq"]

Fathom 技能

连接 Fathom AI，获取通话录音、转录文本和摘要。

设置

1. 获取 API 密钥

1. 访问 developers.fathom.ai
2. 创建一个 API 密钥
3. 复制密钥（格式：v1XDx...）

2. 配置

# 选项 A：存储在文件中（推荐）
echo "YOUR_API_KEY" > ~/.fathom_api_key
chmod 600 ~/.fathom_api_key

# 选项 B：环境变量
export FATHOM_API_KEY="YOUR_API_KEY"

3. 测试连接

./scripts/setup.sh

命令

列出近期通话

./scripts/list-calls.sh                    # 最近 10 条通话
./scripts/list-calls.sh --limit 20         # 最近 20 条通话
./scripts/list-calls.sh --after 2026-01-01 # 指定日期之后的通话
./scripts/list-calls.sh --json             # 原始 JSON 输出

获取转录文本

./scripts/get-transcript.sh 123456789      # 通过录音 ID
./scripts/get-transcript.sh 123456789 --json
./scripts/get-transcript.sh 123456789 --text-only

获取摘要

./scripts/get-summary.sh 123456789         # 通过录音 ID
./scripts/get-summary.sh 123456789 --json

搜索通话

./scripts/search-calls.sh "product launch" # 在转录文本中搜索
./scripts/search-calls.sh --speaker "Lucas"
./scripts/search-calls.sh --after 2026-01-01 --before 2026-01-15

API 参考

基础 URL： https://api.fathom.ai/external/v1
认证： X-API-Key 请求头

list-calls 命令的筛选器

输出格式

示例

获取最近一次通话的摘要

# 获取最新通话的 ID
CALL_ID=$(./scripts/list-calls.sh --limit 1 --json | jq -r '.[0].recording_id')

# 获取摘要
./scripts/get-summary.sh $CALL_ID

导出上周的所有通话

./scripts/list-calls.sh --after $(date -d '7 days ago' +%Y-%m-%d) --json > last_week_calls.json

查找提及某个主题的通话

./scripts/search-calls.sh "quarterly review"

故障排除

Webhook 设置（高级）

如需自动转录文本摄取，请参阅 Webhook 设置指南：

./scripts/setup-webhook.sh --url https://your-endpoint.com/webhook

需要可公开访问的 HTTPS 端点。