Community translations by veiseule.ai — Help improve them on Crowdin
Skip to main content

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:

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#ffffff',
    'primaryTextColor': '#000000',
    'primaryBorderColor': '#000000',
    'lineColor': '#000000',
    'secondaryColor': '#f9f9fb',
    'tertiaryColor': '#ffffff',
    'clusterBkg': '#f9f9fb',
    'clusterBorder': '#000000',
    'nodeBorder': '#000000',
    'mainBkg': '#ffffff',
    'edgeLabelBackground': '#ffffff'
  }
}}%%
flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>Pi agent"]

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

  1. Para WhatsApp Web (visar QR; skanna med assistenttelefonen):
openclaw channels login
  1. Starta Gateway (låt den vara igång):
openclaw gateway --port 18789
  1. 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

veiseule.ai — Community translations maintained by John Kelly. Improve translations on Crowdin.