AGENTS.md — OpenClaw personlig assistent (standard)¶

Första körningen (rekommenderas)¶

OpenClaw använder en dedikerad arbetsyta-katalog för agenten. Standard: ~/.openclaw/workspace (konfigurerbar via agents.defaults.workspace).

1. Skapa arbetskatalogen (om den inte redan finns):

mkdir -p ~/.openclaw/workspace

2. Kopiera standardmallarna för arbetskatalogen till arbetskatalogen:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. Valfritt: om du vill ha färdighetslistan för personlig assistent, ersätt AGENTS.md med den här filen:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. Valfritt: välj en annan arbetskatalog genom att sätta agents.defaults.workspace (stöder ~):

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

Säkerhetsstandarder¶

• Dumpa inte kataloger eller hemligheter i chatten.
• Kör inte destruktiva kommandon om det inte uttryckligen efterfrågas.
• Skicka inte partiella/strömmande svar till externa meddelandeytor (endast slutliga svar).

Sessionsstart (krävs)¶

• Läs SOUL.md, USER.md, memory.md samt idag+igår i memory/.
• Gör det innan du svarar.

Själ (krävs)¶

• SOUL.md definierar identitet, ton och gränser. Behåll den aktuell.
• Om du ändrar SOUL.md, informera användaren.
• Du är en ny instans varje session; kontinuitet finns i dessa filer.

Delade utrymmen (rekommenderas)¶

• Du är inte användarens röst; var försiktig i gruppchattar eller offentliga kanaler.
• Dela inte privata data, kontaktuppgifter eller interna anteckningar.

Minnesystem (rekommenderas)¶

• Daglig logg: memory/YYYY-MM-DD.md (skapa memory/ vid behov).
• Långtidsminne: memory.md för varaktiga fakta, preferenser och beslut.
• Vid sessionsstart, läs idag + igår + memory.md om den finns.
• Fånga: beslut, preferenser, begränsningar, öppna trådar.
• Undvik hemligheter om det inte uttryckligen efterfrågas.

Verktyg & Skills¶

• Verktyg finns i Skills; följ varje Skills SKILL.md när du behöver det.
• Håll miljöspecifika anteckningar i TOOLS.md (Notes for Skills).

Säkerhetskopieringstips (rekommenderas)¶

Om du behandlar den här arbetskatalogen som Clawds ”minne”, gör den till ett git-repo (helst privat) så att AGENTS.md och dina minnesfiler säkerhetskopieras.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

Vad OpenClaw gör¶

• Kör WhatsApp-gateway + Pi-kodningsagent så att assistenten kan läsa/skriva chattar, hämta kontext och köra Skills via värd-Macen.
• macOS-appen hanterar behörigheter (skärminspelning, notiser, mikrofon) och exponerar openclaw CLI via sin medföljande binär.
• Direktchattar kollapsar som standard till agentens main-session; grupper förblir isolerade som agent:<agentId>:<channel>:group:<id> (rum/kanaler: agent:<agentId>:<channel>:channel:<id>); heartbeats håller bakgrundsuppgifter vid liv.

Kärn-Skills (aktivera i Inställningar → Skills)¶

• mcporter — Körningsmiljö/CLI för verktygsservrar för att hantera externa Skills-backends.
• Peekaboo — Snabba macOS-skärmdumpar med valfri AI-bildanalys.
• camsnap — Fånga bildrutor, klipp eller rörelselarm från RTSP/ONVIF-säkerhetskameror.
• oracle — OpenAI-redo agent-CLI med sessionsuppspelning och webbläsarkontroll.
• eightctl — Styr din sömn från terminalen.
• imsg — Skicka, läs och strömma iMessage & SMS.
• wacli — WhatsApp-CLI: synk, sök, skicka.
• diskret — Discord-åtgärder: reagera, klistermärken, omröstningar. Använd user:<id> eller channel:<id> mål (nakna numeriska id är tvetydiga).
• gog — Google Suite-CLI: Gmail, Kalender, Drive, Kontakter.
• spotify-player — Terminalklient för Spotify för att söka/köa/styra uppspelning.
• sag — ElevenLabs-tal med mac-stil ”say”-UX; strömmar till högtalare som standard.
• Sonos CLI — Styr Sonos-högtalare (upptäckt/status/uppspelning/volym/gruppering) från skript.
• blucli — Spela, gruppera och automatisera BluOS-spelare från skript.
• OpenHue CLI — Philips Hue-belysningsstyrning för scener och automatiseringar.
• OpenAI Whisper — Lokal tal-till-text för snabb diktering och röstbrevlådsutskrifter.
• Gemini CLI — Google Gemini-modeller från terminalen för snabb Q&A.
• agent-tools — Verktygslåda för automatiseringar och hjälpskript.

Användningsnoteringar¶

• Föredra openclaw CLI för skriptning; mac-appen hanterar behörigheter.
• Kör installationer från Skills-fliken; den döljer knappen om en binär redan finns.
• Håll heartbeats aktiverade så att assistenten kan schemalägga påminnelser, övervaka inkorgar och trigga kamerafångster.
• Canvas UI kör helskärm med infödda överlägg. Undvik att placera kritiska kontroller i övre vänster/övre höger/nedre kanter; lägg till explicita rännor i layouten och förlita sig inte på säkerhets-områdesinställningar.
• För webbläsardriven verifiering, använd openclaw browser (flikar/status/skärmdump) med OpenClaw-hanterad Chrome-profil.
• För DOM-inspektion, använd openclaw browser eval|query|dom|snapshot (och --json/--out när du behöver maskinutdata).
• För interaktioner, använd openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run (klick/skriv kräver snapshot-referenser; använd evaluate för CSS-selektorer).