English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

Agentwerkruimte

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

Dit staat los van ~/.openclaw/, waar configuratie, inloggegevens en sessies worden opgeslagen.

Standaardlocatie

  • Standaard: ~/.openclaw/workspace
  • Als OPENCLAW_PROFILE is ingesteld en niet "default" is, wordt de standaard ~/.openclaw/workspace-<profile>.
  • Overschrijven in ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

openclaw onboard, openclaw configure of openclaw setup maakt de werkruimte aan en vult de bootstrapbestanden als ze ontbreken.

Als je de werkruimtebestanden al zelf beheert, kun je het aanmaken van bootstrapbestanden uitschakelen:

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

Extra werkruimtemappen

Oudere installaties hebben mogelijk ~/openclaw aangemaakt. Meerdere werkruimtemappen laten staan kan verwarrende auth- of statusafwijkingen veroorzaken, omdat er maar één werkruimte tegelijk actief is.

Bestandskaart van de werkruimte

Dit zijn de standaardbestanden die OpenClaw in de werkruimte verwacht:

AGENTS.md - bedieningsinstructies

Bedieningsinstructies voor de agent en hoe die geheugen moet gebruiken. Wordt geladen aan het begin van elke sessie. Goede plek voor regels, prioriteiten en details over "hoe te gedragen".

SOUL.md - persona en toon

Persona, toon en grenzen. Wordt elke sessie geladen. Gids: SOUL.md-persoonlijkheidsgids.

USER.md - wie de gebruiker is

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

IDENTITY.md - naam, sfeer, emoji

De naam, sfeer en emoji van de agent. Aangemaakt/bijgewerkt tijdens het bootstrapritueel.

TOOLS.md - lokale hulpmiddelconventies

Notities over je lokale hulpmiddelen en conventies. Regelt de beschikbaarheid van hulpmiddelen niet; het is alleen begeleiding.

HEARTBEAT.md - Heartbeat-checklist

Optionele kleine checklist voor Heartbeat-runs. Houd deze kort om tokenverbruik te voorkomen.

BOOT.md - opstartchecklist

Optionele opstartchecklist die automatisch wordt uitgevoerd bij herstart van de Gateway (wanneer interne hooks zijn ingeschakeld). Houd deze kort; gebruik de berichttool voor uitgaande verzendingen.

BOOTSTRAP.md - eerste-runritueel

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

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

Dagelijks geheugenlogboek (één bestand per dag). Aanbevolen om vandaag + gisteren te lezen bij het starten van een sessie.

MEMORY.md - beheerd langetermijngeheugen (optioneel)

Beheerd langetermijngeheugen. Laad dit alleen in de hoofd-, privésessie (niet in gedeelde/groepscontexten). Zie Geheugen voor de workflow en automatische geheugenflush.

skills/ - werkruimte-Skills (optioneel)

Werkruimtespecifieke Skills. Skill-locatie met hoogste prioriteit voor die werkruimte. Overschrijft projectagent-Skills, persoonlijke agent-Skills, beheerde Skills, gebundelde Skills en skills.load.extraDirs wanneer namen botsen.

canvas/ - Canvas UI-bestanden (optioneel)

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

Wat NIET in de werkruimte staat

Deze staan onder ~/.openclaw/ en mogen NIET worden gecommit naar de werkruimterepo:

  • ~/.openclaw/openclaw.json (configuratie)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (model-authprofielen: OAuth + API-sleutels)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (Codex-runtimeaccount, configuratie, Skills, plugins en native threadstatus per agent)
  • ~/.openclaw/credentials/ (kanaal-/providerstatus plus verouderde OAuth-importgegevens)
  • ~/.openclaw/agents/<agentId>/sessions/ (sessietranscripten + metadata)
  • ~/.openclaw/skills/ (beheerde Skills)

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

Git-back-up (aanbevolen, privé)

Behandel de werkruimte als privégeheugen. Zet deze in een privé git-repo zodat er een back-up is en deze herstelbaar is.

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

  • Initialiseer de repo

    Als git is geïnstalleerd, worden gloednieuwe werkruimten automatisch geïnitialiseerd. Als deze werkruimte nog geen repo is, voer dan uit:

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

  • Voeg een privé-remote toe

    GitHub-webinterface

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

    GitHub CLI (gh)

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

    GitLab-webinterface

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

  • Doorlopende updates

    git status
git add .
git commit -m "Update memory"
git push

    • Commit geen geheimen

    Voorgestelde starter voor .gitignore:

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

    De werkruimte naar een nieuwe machine verplaatsen

  • Clone de repo

    Clone de repo naar het gewenste pad (standaard ~/.openclaw/workspace).

  • Werk configuratie bij

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

  • Vul ontbrekende bestanden

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

  • Kopieer sessies (optioneel)

    Als je sessies nodig hebt, kopieer ~/.openclaw/agents/<agentId>/sessions/ apart vanaf de oude machine.

    • Geavanceerde notities

    • Multi-agentroutering kan verschillende werkruimten per agent gebruiken. Zie Kanaalroutering voor routeringsconfiguratie.
    • Als agents.defaults.sandbox is ingeschakeld, kunnen niet-hoofdsessies sandboxwerkruimten per sessie gebruiken onder agents.defaults.sandbox.workspaceRoot.

    Gerelateerd