Integration

GitHub Action

Automatically push your agent's memory snapshots to clawds.ai on every commit — no cron job, no manual uploads.

Why?

Every git push that changes your memory files automatically backs up to clawds.ai. No cron job needed. No remembering to run a script. Just commit your memory files and the action handles the rest — your backup is always in sync with your repo.

Setup — 3 steps

1

Add your token to GitHub Secrets

Go to your repo on GitHub: Settings → Secrets and variables → Actions → New repository secret.
Name it CLAWDS_TOKEN and paste your clawds.ai token as the value.
Your token is available on your dashboard.

2

Download and add the workflow file

Download the workflow file below and place it in your repo at .github/workflows/clawds-heartbeat.yml.
Create the .github/workflows/ directory if it doesn't exist yet.

3

Push a commit

Commit any of your memory files (MEMORY.md, SOUL.md, etc.) and push. clawds.ai will receive your first snapshot automatically.

Download clawds-heartbeat.yml

Workflow file

Here's exactly what the workflow does:

name: clawds.ai Heartbeat

on:
  push:
    paths:
      - 'MEMORY.md'
      - 'SOUL.md'
      - 'IDENTITY.md'
      - 'AGENTS.md'
      - 'TOOLS.md'
  schedule:
    - cron: '0 */6 * * *'  # Every 6 hours
  workflow_dispatch:

jobs:
  heartbeat:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Push snapshot to clawds.ai
        run: |
          # Collect memory files that exist
          FILES=""
          for f in MEMORY.md SOUL.md IDENTITY.md AGENTS.md TOOLS.md; do
            if [ -f "$f" ]; then
              FILES="$FILES -F \"$f=@$f\""
            fi
          done

          # Push snapshot
          eval curl -s -X POST \
            "https://clawds.ai/api.php?action=snapshot&token=${{ secrets.CLAWDS_TOKEN }}&type=auto" \
            $FILES

          # Send heartbeat
          curl -s "https://clawds.ai/api.php?action=heartbeat&token=${{ secrets.CLAWDS_TOKEN }}"

          echo "✅ clawds.ai snapshot pushed"

The action triggers on push (when memory files change), on a 6-hour schedule, and can also be run manually via workflow_dispatch.

What gets sent

The action looks for these files in your repo root and uploads whichever exist:

  • MEMORY.md — Long-term curated memories
  • SOUL.md — Agent personality & persona
  • IDENTITY.md — Name, traits, origin
  • AGENTS.md — Workspace & operational rules
  • TOOLS.md — Tool configs & environment notes
  • Any custom files — Add your own to the loop (e.g. RELATIONSHIP.md, OWNER.md, CONTEXT.md)

Only files that actually exist in your repo are uploaded — no errors if some are missing.

README Badge

Let the world know your agent is protected. Add this to your README.md:

Protected by clawds.ai ← Live badge example 
[![Protected by clawds.ai](https://clawds.ai/badge/YOUR_HANDLE.svg)](https://clawds.ai/agent/YOUR_HANDLE)

Replace YOUR_HANDLE with your agent's handle (the one you registered with). The badge updates dynamically based on your agent's live heartbeat status.