OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Fundamentals

Agentwerkruimte

De werkruimte is de thuisbasis van de agent: de werkmap die wordt gebruikt voor bestandstools en werkruimtecontext. Houd deze privé en behandel deze als geheugen.

Dit staat los van ~/.openclaw/, waarin configuratie, aanmeldgegevens en sessies worden opgeslagen.

Standaardlocatie

  • Standaard: ~/.openclaw/workspace
  • Als OPENCLAW_PROFILE is ingesteld en niet "default" is, wordt de standaardwaarde ~/.openclaw/workspace-<profile>.
  • OPENCLAW_WORKSPACE_DIR overschrijft beide bovenstaande waarden wanneer deze is ingesteld.
  • Niet-standaardagents (agents.entries.*) zonder expliciete werkruimte worden omgezet naar <state-dir>/workspace-<agentId>, niet naar de gedeelde standaardwerkruimte.

Overschrijven in ~/.openclaw/openclaw.json:

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

Overschrijving per agent: agents.entries.*.workspace.

openclaw onboard, openclaw configure of openclaw setup maken de werkruimte aan en vullen de bootstrapbestanden als deze ontbreken.

Als je de werkruimtebestanden al zelf beheert, schakel je het aanmaken van bootstrapbestanden uit:

json5
{ agents: { defaults: { skipBootstrap: true } } }

Extra werkruimtemappen

Oudere installaties hebben mogelijk ~/openclaw aangemaakt. Het behouden van meerdere werkruimtemappen kan verwarrende afwijkingen in authenticatie of status veroorzaken, omdat er slechts één werkruimte tegelijk actief is.

Overzicht van werkruimtebestanden

Standaardbestanden die OpenClaw in de werkruimte verwacht:

AGENTS.md - bedieningsinstructies

Bedieningsinstructies voor de agent en hoe deze het geheugen moet gebruiken. Wordt aan het begin van elke sessie geladen. Een goede plek voor regels, prioriteiten en details over het gewenste gedrag.

SOUL.md - persona en toon

Persona, toon en grenzen. Wordt elke sessie geladen. Handleiding: persoonlijkheidshandleiding voor SOUL.md.

USER.md - wie de gebruiker is

Wie de gebruiker is en hoe deze moet worden aangesproken. Wordt elke sessie geladen.

IDENTITY.md - naam, uitstraling, emoji

De naam, uitstraling en emoji van de agent. Wordt tijdens het bootstrapritueel aangemaakt of bijgewerkt.

TOOLS.md - conventies voor lokale tools

Opmerkingen over je lokale tools en conventies. Bepaalt niet welke tools beschikbaar zijn; het dient alleen als richtlijn.

HEARTBEAT.md - Heartbeat-checklist

Optionele, kleine checklist voor Heartbeat-uitvoeringen. Houd deze kort om tokenverbruik te beperken.

BOOT.md - opstartchecklist

Optionele opstartchecklist die automatisch wordt uitgevoerd wanneer de Gateway opnieuw wordt gestart (als interne hooks zijn ingeschakeld). Houd deze kort; gebruik de berichtentool voor uitgaande verzendingen.

BOOTSTRAP.md - ritueel voor de eerste uitvoering

Eenmalig ritueel voor de eerste uitvoering. Wordt alleen voor een gloednieuwe werkruimte aangemaakt. Verwijder het nadat het ritueel is voltooid.

memory/YYYY-MM-DD.md - dagelijks geheugenlogboek

Dagelijks geheugenlogboek (één bestand per dag). Het wordt aanbevolen om bij het starten van een sessie dat van vandaag en gisteren te lezen.

MEMORY.md - samengesteld langetermijngeheugen (optioneel)

Samengesteld langetermijngeheugen: duurzame feiten, voorkeuren, beslissingen en korte samenvattingen. Bewaar gedetailleerde logboeken in memory/YYYY-MM-DD.md, zodat geheugentools deze op verzoek kunnen ophalen zonder ze in elke prompt te injecteren. Laad MEMORY.md alleen in de persoonlijke hoofdsessie (niet in gedeelde of groepscontexten). Zie Geheugen voor de workflow en het automatisch wegschrijven van het geheugen.

skills/ - werkruimte-Skills (optioneel)

Werkruimtespecifieke Skills. De locatie met de hoogste prioriteit voor Skills in die werkruimte, vóór projectagentskills, persoonlijke agentskills, beheerde Skills, meegeleverde Skills en skills.load.extraDirs wanneer namen conflicteren.

canvas/ - Canvas-UI-bestanden (optioneel)

Canvas-UI-bestanden voor Node-weergaven (bijvoorbeeld canvas/index.html).

Wat NIET in de werkruimte staat

Deze bevinden zich onder ~/.openclaw/ en mogen NIET aan de werkruimterepository worden toegevoegd:

  • ~/.openclaw/openclaw.json (configuratie)
  • ~/.openclaw/state/openclaw.sqlite (gedeelde instellingsstatus en attestaties van de werkruimte)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profielen voor modelauthenticatie: OAuth + API-sleutels)
  • ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (sessierijen, transcripten en runtimestatus per agent)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (Codex-runtimeaccount, configuratie, Skills, plugins en systeemeigen threadstatus per agent)
  • ~/.openclaw/credentials/ (kanaal-/providerstatus plus verouderde OAuth-importgegevens)
  • ~/.openclaw/agents/<agentId>/sessions/ (verouderde migratiebronnen en archief-/ondersteuningsartefacten)
  • ~/.openclaw/skills/ (beheerde Skills)

Als je sessies of configuratie moet migreren, kopieer deze dan afzonderlijk en houd ze buiten versiebeheer.

Oudere releases van OpenClaw schreven de werkruimte-sidecars openclaw-workspace-state.json, .openclaw/workspace-state.json en .attested. De huidige runtime gebruikt voor die status alleen de gedeelde SQLite-database. Als Doctor een van deze bestanden meldt, voer dan openclaw doctor --fix uit; Doctor importeert geldige verouderde status en verwijdert een bron pas nadat de databaserijen zijn geverifieerd.

Git-back-up (aanbevolen, privé)

Behandel de werkruimte als privégeheugen. Plaats deze in een privé-gitrepository, zodat er een back-up van wordt gemaakt en herstel mogelijk is.

Voer deze stappen uit op de machine waarop de Gateway draait (daar bevindt de werkruimte zich).

  • De repository initialiseren

    Als git is geïnstalleerd, worden gloednieuwe werkruimten automatisch geïnitialiseerd. Als deze werkruimte nog geen repository is, voer je het volgende uit:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

  • Een privéremote toevoegen

    GitHub-web-UI

    1. Maak een nieuwe privérepository op GitHub.
    2. Initialiseer deze niet met een README (dit voorkomt samenvoegingsconflicten).
    3. Kopieer de HTTPS-remote-URL.
    4. Voeg de remote toe en push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

    bash
    gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

    GitLab-web-UI

    1. Maak een nieuwe privérepository op GitLab.
    2. Initialiseer deze niet met een README (dit voorkomt samenvoegingsconflicten).
    3. Kopieer de HTTPS-remote-URL.
    4. Voeg de remote toe en push:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Doorlopende updates

    bash
    git statusgit add .git commit -m "Update memory"git push

    • Leg geen geheimen vast

    Voorgestelde basisinhoud voor .gitignore:

    gitignore
    .DS_Store.env**/*.key**/*.pem**/secrets*

    De werkruimte naar een nieuwe machine verplaatsen

  • De repository klonen

    Kloon de repository naar het gewenste pad (standaard ~/.openclaw/workspace).

  • De configuratie bijwerken

    Stel agents.defaults.workspace in op dat pad in ~/.openclaw/openclaw.json.

  • Ontbrekende bestanden vullen

    Voer openclaw setup --workspace <path> uit om ontbrekende bestanden te vullen.

  • Sessies kopiëren (optioneel)

    Als je sessies nodig hebt, kopieer je ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite afzonderlijk vanaf de oude machine. Kopieer ~/.openclaw/agents/<agentId>/sessions/ alleen als je ook verouderde migratie-invoer of archief-/ondersteuningsartefacten nodig hebt.

    • Geavanceerde opmerkingen

    • Routering met meerdere agents kan via agents.entries.*.workspace verschillende werkruimten per agent gebruiken. Zie Kanaalroutering voor de routeringsconfiguratie.
    • Als agents.defaults.sandbox is ingeschakeld, kunnen niet-hoofdsessies sandboxwerkruimten per sessie onder agents.defaults.sandbox.workspaceRoot gebruiken.

    Gerelateerd

    Was this useful?
    On this page

    On this page