​

Hjärtslag (Gateway)

Heartbeat vs Cron? Se Cron vs Heartbeat för vägledning om när du ska använda respektive.

​

Snabbstart (nybörjare)

1. Låt heartbeats vara aktiverade (standard är 30m, eller 1h för Anthropic OAuth/setup-token) eller ställ in din egen frekvens.
2. Skapa en liten HEARTBEAT.md-checklista i agentens arbetsyta (valfritt men rekommenderat).
3. Bestäm vart heartbeat-meddelanden ska skickas (target: "last" är standard).
4. Valfritt: aktivera leverans av heartbeat-resonemang för transparens.
5. Valfritt: begränsa heartbeats till aktiva timmar (lokal tid).

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
        // activeHours: { start: "08:00", end: "24:00" },
        // includeReasoning: true, // optional: send separate `Reasoning:` message too
      },
    },
  },
}

​

Standardvärden

• Interval: 30m (eller 1h när Anthropic OAuth/setup-token är det detekterade auth läget). Ange agents.defaults.heartbeat.every eller per-agent agents.list[].heartbeat.every; använd 0m för att inaktivera.
• Prompt kropp (konfigurerbar via agents.defaults.heartbeat.prompt): Read HEARTBEAT.md om den existerar (arbetsytans sammanhang). Följ den strikt. Sluta inte eller upprepa gamla uppgifter från tidigare chattar. Om inget behöver uppmärksamhet, svara HEARTBEAT_OK.
• Hjärtslag-prompten skickas ordagrande som användarmeddelande. Systemet prompten innehåller en “Heartbeat” sektion och körningen är flaggad internt.
• Aktiva timmar (heartbeat.activeHours) kontrolleras i den konfigurerade tidszonen. Utanför fönstret hoppas hjärtslag över till nästa fästing inne i fönstret.

​

Vad heartbeat-prompten är till för

• Bakgrundsuppgifter: ”Consider outstanding tasks” uppmanar agenten att granska uppföljningar (inkorg, kalender, påminnelser, köat arbete) och lyfta fram det som är brådskande.
• Mänsklig avstämning: ”Checkup sometimes on your human during day time” uppmuntrar till ett ibland förekommande lättviktigt ”behöver du något?”-meddelande, men undviker nattligt spam genom att använda din konfigurerade lokala tidszon (se /concepts/timezone).

​

Svarskontrakt

• Om inget kräver uppmärksamhet, svara med HEARTBEAT_OK.
• Under hjärtslag körs behandlar OpenClaw HEARTBEAT_OK som en ack när det visas vid början eller slutet av svaret. Talet är borttaget och svaret är tappat om det återstående innehållet är ≤ ackMaxChars (standard: 300).
• Om HEARTBEAT_OK förekommer i mitten av ett svar behandlas den inte särskilt.
• För larm ska du inte inkludera HEARTBEAT_OK; returnera endast larmtexten.

​

Konfig

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // default: 30m (0m disables)
        model: "anthropic/claude-opus-4-6",
        includeReasoning: false, // default: false (deliver separate Reasoning: message when available)
        target: "last", // last | none | <channel id> (core or plugin, e.g. "bluebubbles")
        to: "+15551234567", // optional channel-specific override
        accountId: "ops-bot", // optional multi-account channel id
        prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        ackMaxChars: 300, // max chars allowed after HEARTBEAT_OK
      },
    },
  },
}

​

Omfattning och prioritet

• agents.defaults.heartbeat sätter globalt heartbeat-beteende.
• agents.list[].heartbeat slås samman ovanpå; om någon agent har ett heartbeat-block kör endast dessa agenter heartbeats.
• channels.defaults.heartbeat sätter synlighetsstandarder för alla kanaler.
• kanaler.<channel>.heartbeat åsidosätter kanalstandard.
• kanaler.<channel>.accounts.<id>.heartbeat (multi-account kanaler) åsidosätter inställningar per kanal.

​

Per-agent-heartbeats

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​

Exempel: aktiva timmar

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optional; uses your userTimezone if set, otherwise host tz
        },
      },
    },
  },
}

​

Exempel: flera konton

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678",
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Fältnoteringar

• every: heartbeat-intervall (varaktighetssträng; standardenhet = minuter).
• model: valfri modellåsidosättning för heartbeat-körningar (provider/model).
• includeReasoning: när aktiverad, levererar även det separata Reasoning:-meddelandet när tillgängligt (samma form som /reasoning on).
• session: valfri sessionsnyckel för heartbeat-körningar.
  • main (standard): agentens huvudsession.
  • Explicit sessionsnyckel (kopiera från openclaw sessions --json eller sessions CLI).
  • Format för sessionsnycklar: se Sessions och Groups.
• target:
  • last (standard): leverera till senast använda externa kanal.
  • Explicit kanal: whatsapp / telegram / discord / googlechat / slack / msteams / signal / imessage.
  • none: kör heartbeaten men leverera inte externt.
• to: valfri mottagare åsidosätter (kanalspecifikt id, t.ex. E.164 för WhatsApp eller ett Telegram chatt-id).
• accountId: valfritt kontonummer för kanaler med flera konton. När target: "last", gäller konto-id för den lösta sista kanalen om den stöder konton; annars ignoreras. Om konto-id inte matchar ett konfigurerat konto för den lösta kanalen, hoppas leveransen över.
• prompt: åsidosätter standardpromptens text (slås inte samman).
• ackMaxChars: max antal tecken som tillåts efter HEARTBEAT_OK före leverans.
• activeHours: begränsar hjärtslag körs till ett tidsfönster. Objekt med start (HH:MM, inclusive), end (HH:MM exklusive; 24:00 tillåts för slut-av-dag) och valfri timezone.
  • Utelämnad eller "user": använder din agents.defaults.userTimezone om den är satt, annars faller den tillbaka till värdsystemets tidszon.
  • "local": använder alltid värdsystemets tidszon.
  • Någon IANA identifierare (t.ex. America/New_York): används direkt; om ogiltigt, faller tillbaka till "användar" beteende ovan.
  • Utanför det aktiva fönstret hoppas heartbeats över till nästa tick inom fönstret.

​

Leveransbeteende

• Heartbeats körs i agentens huvudsession som standard (agent:<id>:<mainKey>), eller global när session.scope = "global". Set session to override to a specific channel session (Discord/WhatsApp/etc.).
• session påverkar endast körningskontexten; leverans styrs av target och to.
• För att leverera till en specifik kanal / mottagare, sätt target + to. Med target: "last", använder leverans den sista externa kanalen för den sessionen.
• Om huvudkön är upptagen hoppas heartbeaten över och försöks igen senare.
• Om target löses till ingen extern destination körs varvet ändå men inget utgående meddelande skickas.
• Endast-heartbeat-svar håller inte sessionen vid liv; den senaste updatedAt återställs så att inaktiv utgång beter sig normalt.

​

Synlighetskontroller

channels:
  defaults:
    heartbeat:
      showOk: false # Hide HEARTBEAT_OK (default)
      showAlerts: true # Show alert messages (default)
      useIndicator: true # Emit indicator events (default)
  telegram:
    heartbeat:
      showOk: true # Show OK acknowledgments on Telegram
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Suppress alert delivery for this account

​

Vad varje flagga gör

• showOk: skickar en HEARTBEAT_OK-kvittens när modellen returnerar ett svar som endast är OK.
• showAlerts: skickar larm-innehållet när modellen returnerar ett icke-OK-svar.
• useIndicator: emitterar indikatorhändelser för UI-statusytor.

​

Exempel: per kanal vs per konto

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # all Slack accounts
    accounts:
      ops:
        heartbeat:
          showAlerts: false # suppress alerts for the ops account only
  telegram:
    heartbeat:
      showOk: true

​

Vanliga mönster

​

HEARTBEAT.md (valfritt)

# Heartbeat checklist

- Quick scan: anything urgent in inboxes?
- If it’s daytime, do a lightweight check-in if nothing else is pending.
- If a task is blocked, write down _what is missing_ and ask Peter next time.

​

Kan agenten uppdatera HEARTBEAT.md?

• ”Uppdatera HEARTBEAT.md för att lägga till en daglig kalenderkontroll.”
• ”Skriv om HEARTBEAT.md så att den blir kortare och fokuserad på inkorgsuppföljningar.”

​

Manuell väckning (on-demand)

openclaw system event --text "Check for urgent follow-ups" --mode now

​

Leverans av resonemang (valfritt)

• agents.defaults.heartbeat.includeReasoning: true

​

Kostnadsmedvetenhet