Area di lavoro dell'agente

Lo spazio di lavoro è la casa dell'agente. È l'unica directory di lavoro usata per gli strumenti sui file e per il contesto dello spazio di lavoro. Mantienilo privato e trattalo come memoria.

È separato da ~/.openclaw/, che memorizza configurazione, credenziali e sessioni.

# Posizione predefinita

• Predefinita: ~/.openclaw/workspace
• Se OPENCLAW_PROFILE è impostato e non è "default", il valore predefinito diventa ~/.openclaw/workspace-<profile>.
• Sovrascrivi in ~/.openclaw/openclaw.json:

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

openclaw onboard, openclaw configure o openclaw setup creeranno lo spazio di lavoro e inizializzeranno i file di bootstrap se mancano.

Se gestisci già tu i file dello spazio di lavoro, puoi disabilitare la creazione dei file di bootstrap:

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

# Cartelle aggiuntive dello spazio di lavoro

Le installazioni più vecchie potrebbero aver creato ~/openclaw. Tenere più directory di spazio di lavoro può causare confusione nell'autenticazione o deriva dello stato, perché è attivo un solo spazio di lavoro alla volta.

# Mappa dei file dello spazio di lavoro

Questi sono i file standard che OpenClaw si aspetta dentro lo spazio di lavoro:

# Cosa NON si trova nello spazio di lavoro

Questi elementi si trovano sotto ~/.openclaw/ e NON dovrebbero essere sottoposti a commit nel repo dello spazio di lavoro:

• ~/.openclaw/openclaw.json (configurazione)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profili di autenticazione del modello: OAuth + chiavi API)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (account runtime Codex per agente, configurazione, Skills, plugins e stato nativo dei thread)
• ~/.openclaw/credentials/ (stato di canale/provider più dati di importazione OAuth legacy)
• ~/.openclaw/agents/<agentId>/sessions/ (trascrizioni delle sessioni + metadati)
• ~/.openclaw/skills/ (Skills gestite)

Se devi migrare sessioni o configurazione, copiale separatamente e tienile fuori dal controllo versione.

# Backup Git (consigliato, privato)

Tratta lo spazio di lavoro come memoria privata. Mettilo in un repo git privato in modo che sia sottoposto a backup e recuperabile.

Esegui questi passaggi sulla macchina su cui gira il Gateway (è lì che si trova lo spazio di lavoro).

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"

git branch -M main
git remote add origin <https-url>
git push -u origin main

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

git branch -M main
git remote add origin <https-url>
git push -u origin main

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

# Non effettuare commit di segreti

Starter .gitignore suggerito:

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

# Spostare lo spazio di lavoro su una nuova macchina

# Note avanzate

• Il routing multi-agente può usare spazi di lavoro diversi per agente. Vedi routing dei canali per la configurazione del routing.
• Se agents.defaults.sandbox è abilitato, le sessioni non principali possono usare spazi di lavoro sandbox per sessione sotto agents.defaults.sandbox.workspaceRoot.

# Correlati

• Heartbeat - file dello spazio di lavoro HEARTBEAT.md
• Sandboxing - accesso allo spazio di lavoro in ambienti sandbox
• Sessione - percorsi di archiviazione delle sessioni
• Ordini permanenti - istruzioni persistenti nei file dello spazio di lavoro