Bygga en personlig assistent med OpenClaw

OpenClaw är en WhatsApp + Telegram + Discord + iMessage gateway för Pi agenter. Tillägg till Mattermost. Denna guide är “personlig assistent” setup: en dedikerad WhatsApp nummer som beter sig som din alltid ombud.

⚠️ Säkerhet först

Du placerar en agent i en position att:

köra kommandon på din maskin (beroende på din Pi-verktygskonfiguration)
läsa/skriva filer i din arbetsyta
skicka meddelanden vidare via WhatsApp/Telegram/Discord/Mattermost (plugin)

Börja försiktigt:

Sätt alltid channels.whatsapp.allowFrom (kör aldrig öppet mot hela världen på din personliga Mac).
Använd ett dedikerat WhatsApp-nummer för assistenten.
Heartbeats är nu standard för var 30:e minut. Inaktivera tills du litar på installationen genom att ställa in agents.defaults.heartbeat.every: "0m".

Förutsättningar

OpenClaw installerat och introducerat — se Kom igång om du inte har gjort detta än
Ett andra telefonnummer (SIM/eSIM/kontantkort) för assistenten

Tvåtelefonersuppsättningen (rekommenderas)

Du vill ha detta: Om du länkar din personliga WhatsApp till OpenClaw, varje meddelande till dig blir “agent input”. Det är sällan det du vill.

Snabbstart på 5 minuter

Para WhatsApp Web (visar QR; skanna med assistenttelefonen):

openclaw channels login

Starta Gateway (låt den vara igång):

openclaw gateway --port 18789

Lägg in en minimal konfig i ~/.openclaw/openclaw.json:

{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Meddela nu assistentnumret från din tillåtelselista. När onboarding är klar öppnar vi instrumentbrädan automatiskt och skriver ut en ren (icke-tokenized) länk. Om det ber om att få auth, klistra in token från gateway.auth.token i kontrollgränssnittets inställningar. För att öppna senare: openclaw dashboard.

Ge agenten en arbetsyta (AGENTS)

OpenClaw läser driftinstruktioner och ”minne” från sin arbetsytekatalog. Som standard använder OpenClaw ~/.openclaw/workspace som agentens arbetsyta, och kommer att skapa det (plus start-AGENTS. d, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md) automatiskt vid setup/första agent kör. BOOTSTRAP.md skapas bara när arbetsytan är helt ny (det bör inte komma tillbaka efter att du tagit bort den). MEMORY.md är valfritt (inte automatiskt skapat); när närvarande, är det laddat för normala sessioner. Underagent sessioner endast injicera AGENTS.md och TOOLS.md. Tips: behandla den här mappen som OpenClaws ”minne” och gör den till en git repo (helst privat) så att dina AGENTS.md + minnesfiler säkerhetskopieras. Om git är installerat är helt nya arbetsytor autoinitierade.

openclaw setup

Fullständig arbetsytestruktur + guide för säkerhetskopiering: Agent workspace
Minnesarbetsflöde: Memory Valfritt: välj en annan arbetsyta med agents.defaults.workspace (stödjer ~).

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

Om du redan levererar dina egna arbetsytefiler från ett repo kan du inaktivera skapandet av bootstrap‑filer helt:

{
  agent: {
    skipBootstrap: true,
  },
}

Konfigen som gör den till ”en assistent”

OpenClaw har som standard en bra assistentuppsättning, men du vill oftast justera:

persona/instruktioner i SOUL.md
tänkandeförval (om önskat)
heartbeats (när du väl litar på den)

Exempel:

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // Start with 0; enable later.
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

Sessioner och minne

Sessionsfiler: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
Sessionsmetadata (tokenanvändning, senaste rutt, etc): ~/.openclaw/agents/<agentId>/sessions/sessions.json (legacy: ~/.openclaw/sessions/sessions.json)
/new eller /reset startar en ny session för den chatten (konfigurerbar via resetTriggers). Om den skickas ensam, svarar agenten med en kort hej för att bekräfta återställningen.
/compact [instructions] komprimerar sessionskontexten och rapporterar återstående kontextbudget.

Heartbeats (proaktivt läge)

Som standard kör OpenClaw ett hjärtslag var 30:e minut med prompten:

Read HEARTBEAT.md om det finns (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.

Set agents.defaults.heartbeat.every: "0m" för att inaktivera.

Om HEARTBEAT.md finns men i praktiken är tom (endast tomma rader och markdown‑rubriker som # Heading), hoppar OpenClaw över heartbeat‑körningen för att spara API‑anrop.
Om filen saknas körs heartbeat ändå och modellen avgör vad som ska göras.
Om agenten svarar med HEARTBEAT_OK (valfritt med kort utfyllnad; se agents.defaults.heartbeat.ackMaxChars), undertrycker OpenClaw utgående leverans för den heartbeaten.
Heartbeats kör fullständiga agentvarv — kortare intervall förbrukar fler tokens.

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

Media in och ut

Inkommande bilagor (bilder/ljud/dokument) kan exponeras till ditt kommando via mallar:

{{MediaPath}} (lokal temporär filsökväg)
{{MediaUrl}} (pseudo‑URL)
{{Transcript}} (om ljudtranskribering är aktiverad)

Utgående bilagor från agenten: inkludera MEDIA:<path-or-url> på sin egen linje (inga mellanslag). Exempel:

Here’s the screenshot.
MEDIA:https://example.com/screenshot.png

OpenClaw extraherar dessa och skickar dem som media tillsammans med texten.

Driftchecklista

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # adds gateway health probes (Telegram + Discord)
openclaw health --json   # gateway health snapshot (WS)

Loggar finns under /tmp/openclaw/ (standard: openclaw-YYYY-MM-DD.log).

Nästa steg

WebChat: WebChat
Gateway‑drift: Gateway runbook
Cron + väckningar: Cron jobs
macOS‑menyradskompanjon: OpenClaw macOS app
iOS‑nodeapp: iOS app
Android‑nodeapp: Android app
Windows‑status: Windows (WSL2)
Linux‑status: Linux app
Säkerhet: Security

Hem

Översikt

Grundläggande koncept

Första stegen

Guider

Konfigurering av personlig assistent

Bygga en personlig assistent med OpenClaw

⚠️ Säkerhet först

Förutsättningar

Tvåtelefonersuppsättningen (rekommenderas)

Snabbstart på 5 minuter

Ge agenten en arbetsyta (AGENTS)

Konfigen som gör den till ”en assistent”

Sessioner och minne

Heartbeats (proaktivt läge)

Media in och ut

Driftchecklista

Nästa steg

​Bygga en personlig assistent med OpenClaw

​⚠️ Säkerhet först

​Förutsättningar

​Tvåtelefonersuppsättningen (rekommenderas)

​Snabbstart på 5 minuter

​Ge agenten en arbetsyta (AGENTS)

​Konfigen som gör den till ”en assistent”

​Sessioner och minne

​Heartbeats (proaktivt läge)

​Media in och ut

​Driftchecklista

​Nästa steg

Bygga en personlig assistent med OpenClaw

⚠️ Säkerhet först

Förutsättningar

Tvåtelefonersuppsättningen (rekommenderas)

Snabbstart på 5 minuter

Ge agenten en arbetsyta (AGENTS)

Konfigen som gör den till ”en assistent”

Sessioner och minne

Heartbeats (proaktivt läge)

Media in och ut

Driftchecklista

Nästa steg