# Send Fathom to your agent
Use the source page and any available docs to guide the install because the item requires authentication or permission before the package can be fetched.
## Fast path
- Open the source page via Open source page.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item requires authentication or permission before the package can be fetched. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fathom-meetings",
    "name": "Fathom",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/lauren-hayes-ai/fathom-meetings",
    "canonicalUrl": "https://clawhub.ai/lauren-hayes-ai/fathom-meetings",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/fathom-meetings",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fathom-meetings",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api-endpoints.md",
      "scripts/sync-fathom.js"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "fathom-meetings",
      "status": "auth_required",
      "reason": "login_required",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-03T04:23:38.979Z",
      "expiresAt": "2026-05-06T04:23:38.979Z",
      "httpStatus": 403,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fathom-meetings",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fathom-meetings",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "fathom-meetings"
      },
      "scope": "item",
      "summary": "Item requires authentication.",
      "detail": "This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually.",
      "primaryActionLabel": "Open source page",
      "primaryActionHref": "https://clawhub.ai/lauren-hayes-ai/fathom-meetings"
    },
    "validation": {
      "installChecklist": [
        "Sign in or confirm the required access before retrying the download.",
        "Review SKILL.md after authentication succeeds.",
        "Treat this source as manual setup until the package can be fetched directly."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fathom-meetings",
    "downloadUrl": "https://openagent3.xyz/downloads/fathom-meetings",
    "agentUrl": "https://openagent3.xyz/skills/fathom-meetings/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fathom-meetings/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fathom-meetings/agent.md"
  }
}
```
## Documentation

### Fathom

Pull meeting recordings, transcripts, summaries, and action items from Fathom AI Notetaker.

### Setup

Store the API key in ~/.openclaw/secrets/fathom.env:

FATHOM_API_KEY=your-api-key-here
FATHOM_WEBHOOK_SECRET=your-webhook-secret-here

Get API key from Fathom: Settings → Integrations → API → Generate Key.

### API Reference

Base URL: https://api.fathom.ai/external/v1
Auth header: X-Api-Key: <FATHOM_API_KEY>

### List Meetings

curl "https://api.fathom.ai/external/v1/meetings?limit=20" \\
  -H "X-Api-Key: $FATHOM_API_KEY"

Key query params:

limit (1-100, default 10)
created_after / created_before (ISO 8601)
recorded_by[] (email filter)
include_transcript=true (include full transcript)
include_action_items=true (include action items)
include_summary=true (include AI summary)

Response shape:

{
  "items": [{
    "title": "Meeting Name",
    "meeting_title": "Calendar Event Name",
    "url": "https://fathom.video/calls/123",
    "share_url": "https://fathom.video/share/abc",
    "created_at": "2026-02-17T20:00:00Z",
    "scheduled_start_time": "...",
    "scheduled_end_time": "...",
    "recording_start_time": "...",
    "recording_end_time": "...",
    "recording_id": 123,
    "transcript": "...",
    "default_summary": "...",
    "action_items": ["..."],
    "calendar_invitees": [{"name": "...", "email": "...", "is_external": true}],
    "recorded_by": {"name": "...", "email": "..."}
  }],
  "next_cursor": "..."
}

### Pagination

Use next_cursor from response as cursor param in next request.

### Matching Fathom to Calendar

Match by time overlap (recording_start_time within event window ± 15 min) or by title similarity. The calendar_invitees field shows who was invited; is_external flags non-org attendees.

### Pull action items from recent calls

source ~/.openclaw/secrets/fathom.env
curl -s "https://api.fathom.ai/external/v1/meetings?include_action_items=true&limit=20" \\
  -H "X-Api-Key: $FATHOM_API_KEY"

### Get full transcript for a specific date range

curl -s "https://api.fathom.ai/external/v1/meetings?include_transcript=true&created_after=2026-02-17T00:00:00Z&created_before=2026-02-18T00:00:00Z" \\
  -H "X-Api-Key: $FATHOM_API_KEY"

### Filter to external meetings only

After fetching, filter meetings where at least one calendar_invitees entry has is_external: true, or check the calendar_invitees_domains_type field for "one_or_more_external".

### Sync script (calendar + Fathom → database)

See scripts/sync-fathom.js for a complete local sync script that:

Refreshes Google OAuth token
Pulls Google Calendar events for a date range
Pulls Fathom meetings with action items
Matches Fathom recordings to calendar events
Upserts everything to Supabase (or any database)

Adapt the database layer to your needs.

### Webhooks

Fathom can POST to your endpoint when recordings complete. Verify with FATHOM_WEBHOOK_SECRET. Use this for real-time sync instead of polling.

### Tips

Action items from Fathom are AI-generated — review for accuracy
recorded_by shows who ran the Fathom bot, not necessarily the meeting organizer
Duplicate recordings happen when multiple team members run Fathom on the same call — deduplicate by matching scheduled_start_time + similar titles
The API returns meetings from all team members if using a team API key
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lauren-hayes-ai
- Version: 1.0.0
## Source health
- Status: auth_required
- Item requires authentication.
- This item appears to require sign-in or permission before the package can be fetched. Open the source page and confirm access manually.
- Health scope: item
- Reason: login_required
- Checked at: 2026-05-03T04:23:38.979Z
- Expires at: 2026-05-06T04:23:38.979Z
- Recommended action: Open source page
## Links
- [Detail page](https://openagent3.xyz/skills/fathom-meetings)
- [Send to Agent page](https://openagent3.xyz/skills/fathom-meetings/agent)
- [JSON manifest](https://openagent3.xyz/skills/fathom-meetings/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/fathom-meetings/agent.md)
- [Download page](https://openagent3.xyz/downloads/fathom-meetings)