openclaw agents

Gestisci agenti isolati (spazi di lavoro + autenticazione + instradamento). L'esecuzione di openclaw agents senza sottocomandi equivale a openclaw agents list.

Correlati:

• Instradamento multi-agente
• Spazio di lavoro dell'agente
• Configurazione delle Skills: configurazione della visibilità delle Skills.

Esempi

openclaw agents listopenclaw agents list --bindingsopenclaw agents add work --workspace ~/.openclaw/workspace-workopenclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:*openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactiveopenclaw agents bindingsopenclaw agents bind --agent work --bind telegram:opsopenclaw agents unbind --agent work --bind telegram:opsopenclaw agents set-identity --workspace ~/.openclaw/workspace --from-identityopenclaw agents set-identity --agent main --avatar avatars/openclaw.pngopenclaw agents delete work

Superficie dei comandi

agents list

Opzioni: --json, --bindings (include le regole di instradamento complete, non solo i conteggi o i riepiloghi per agente).

agents add [name]

Opzioni: --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (ripetibile), --non-interactive, --json.

• Il passaggio di qualsiasi flag esplicito per l'aggiunta sposta il comando sul percorso non interattivo.
• La modalità non interattiva richiede sia un nome per l'agente sia --workspace.
• main è riservato e non può essere utilizzato come ID del nuovo agente.
• La modalità interattiva inizializza l'autenticazione copiando solo le credenziali statiche trasferibili (profili api_key e token statici), a meno che una credenziale non disabiliti la copia con copyToAgents: false; i profili con token di aggiornamento OAuth non vengono copiati, a meno che un provider non abiliti la copia con copyToAgents: true. Senza una copia, OAuth rimane disponibile solo tramite ereditarietà in lettura dall'archivio dell'agente main reale. Se l'agente predefinito configurato non è main, accedi separatamente ai profili OAuth sul nuovo agente.

agents bindings

Opzioni: --agent <id>, --json.

agents bind

Opzioni: --agent <id> (per impostazione predefinita, l'agente predefinito corrente), --bind <channel[:accountId]> (ripetibile), --json.

agents unbind

Opzioni: --agent <id> (per impostazione predefinita, l'agente predefinito corrente), --bind <channel[:accountId]> (ripetibile), --all, --json. Accetta --all oppure uno o più valori --bind, ma non entrambi.

agents set-identity

Opzioni: --agent <id>, --workspace <dir>, --identity-file <path>, --from-identity, --name <name>, --theme <theme>, --emoji <emoji>, --avatar <value>, --json. Vedi Impostare l'identità di seguito.

agents delete <id>

Opzioni: --force, --json.

• main non può essere eliminato.
• Senza --force, è richiesta una conferma interattiva (l'operazione non riesce in una sessione non TTY; riesegui con --force).
• Le directory dello spazio di lavoro, dello stato dell'agente e delle trascrizioni delle sessioni vengono spostate nel Cestino, non eliminate definitivamente.
• Quando il Gateway è raggiungibile, l'eliminazione viene instradata attraverso il Gateway, affinché la pulizia della configurazione e dell'archivio delle sessioni utilizzi lo stesso processo di scrittura del traffico in fase di esecuzione. Se il Gateway non è raggiungibile, la CLI ripiega sul percorso locale offline.
• Se lo spazio di lavoro di un altro agente corrisponde allo stesso percorso, si trova all'interno di questo spazio di lavoro o contiene questo spazio di lavoro, lo spazio di lavoro viene conservato e --json restituisce workspaceRetained, workspaceRetainedReason e workspaceSharedWith.

Associazioni di instradamento

Utilizza le associazioni di instradamento per vincolare il traffico in ingresso da un canale a un agente specifico.

Se desideri anche Skills visibili diverse per ciascun agente, configura agents.defaults.skills e agents.list[].skills in openclaw.json. Vedi Configurazione delle Skills e Riferimento per la configurazione.

Elenca le associazioni:

openclaw agents bindingsopenclaw agents bindings --agent workopenclaw agents bindings --json

Aggiungi associazioni:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

Puoi aggiungere associazioni anche durante la creazione di un agente:

openclaw agents add work --workspace ~/.openclaw/workspace-work --bind telegram:* --bind discord:*

Se ometti accountId (--bind <channel>), OpenClaw lo determina dagli hook di configurazione del plugin, dall'associazione forzata dell'account o dal numero di account configurati per il canale.

Se ometti --agent per bind o unbind, OpenClaw seleziona l'agente predefinito corrente.

Formato di --bind

Comportamento dell'ambito delle associazioni

• Un'associazione archiviata senza accountId corrisponde solo all'account predefinito del canale.
• accountId: "*" è il ripiego valido per l'intero canale (tutti gli account) ed è meno specifico di un'associazione esplicita a un account.
• Se lo stesso agente dispone già di un'associazione corrispondente al canale senza accountId e successivamente crei un'associazione con un accountId esplicito o determinato, OpenClaw aggiorna direttamente l'associazione esistente anziché aggiungerne una duplicata.

Esempi:

# corrisponde a tutti gli account del canaleopenclaw agents bind --agent work --bind telegram:* # corrisponde a un account specificoopenclaw agents bind --agent work --bind telegram:ops # associazione iniziale al solo canaleopenclaw agents bind --agent work --bind telegram # successivo aggiornamento a un'associazione con ambito accountopenclaw agents bind --agent work --bind telegram:alerts

Dopo l'aggiornamento, l'instradamento per tale associazione è limitato a telegram:alerts. Se desideri anche l'instradamento dell'account predefinito, aggiungilo esplicitamente (ad esempio --bind telegram:default).

Rimuovi le associazioni:

openclaw agents unbind --agent work --bind telegram:opsopenclaw agents unbind --agent work --all

File di identità

Ogni spazio di lavoro di un agente può includere un file IDENTITY.md nella propria radice:

• Percorso di esempio: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity legge dalla radice dello spazio di lavoro (o da un file --identity-file esplicito).

I percorsi degli avatar vengono risolti rispetto alla radice dello spazio di lavoro e non possono uscirne, nemmeno tramite un collegamento simbolico.

Impostare l'identità

set-identity scrive i campi in agents.list[].identity: name, theme, emoji, avatar (percorso relativo allo spazio di lavoro, URL http(s) o URI di dati).

• --agent o --workspace seleziona l'agente di destinazione. Se --workspace corrisponde a più agenti, il comando non riesce e richiede di passare --agent.
• I file immagine locali degli avatar con percorso relativo allo spazio di lavoro sono limitati a 2 MB. Gli URL HTTP(S) e gli URI data: non vengono verificati rispetto al limite locale delle dimensioni dei file.
• Se non vengono forniti campi di identità espliciti, il comando legge i dati di identità da IDENTITY.md.

Carica da IDENTITY.md:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

Sovrascrivi esplicitamente i campi:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

Esempio di configurazione:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OpenClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/openclaw.png",        },      },    ],  },}

Correlati

• Riferimento della CLI
• Instradamento multi-agente
• Spazio di lavoro dell'agente