Pular para o conteúdo principal

​
openclaw agents

Gerencie agentes isolados (workspaces + autenticação + roteamento). Relacionado:

​
Exemplos

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

​
Bindings de roteamento

Use bindings de roteamento para fixar o tráfego de entrada do canal em um agente específico. Se você também quiser Skills visíveis diferentes por agente, configure agents.defaults.skills e agents.list[].skills em openclaw.json. Consulte Configuração de Skills e Referência de configuração. Listar bindings: 
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json
Adicionar bindings: 
openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a
Se você omitir accountId (--bind <channel>), o OpenClaw o resolve a partir dos padrões do canal e dos hooks de configuração do plugin, quando disponíveis. Se você omitir --agent em bind ou unbind, o OpenClaw direciona para o agente padrão atual.

​
Comportamento do escopo de binding

  • Um binding sem accountId corresponde apenas à conta padrão do canal.
  • accountId: "*" é o fallback para todo o canal (todas as contas) e é menos específico do que um binding explícito de conta.
  • Se o mesmo agente já tiver um binding de canal correspondente sem accountId, e depois você fizer bind com um accountId explícito ou resolvido, o OpenClaw atualiza esse binding existente no local em vez de adicionar uma duplicata.
Exemplo: 
# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:ops
Após a atualização, o roteamento desse binding fica restrito a telegram:ops. Se você também quiser roteamento para a conta padrão, adicione-o explicitamente (por exemplo --bind telegram:default). Remover bindings: 
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all
unbind aceita --all ou um ou mais valores --bind, não ambos.

​
Superfície de comando

​
agents

Executar openclaw agents sem subcomando equivale a openclaw agents list.

​
agents list

Opções:
  • --json
  • --bindings: inclui regras de roteamento completas, não apenas contagens/resumos por agente

​
agents add [name]

Opções:
  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]> (repetível)
  • --non-interactive
  • --json
Observações:
  • Passar qualquer flag explícita de add muda o comando para o caminho não interativo.
  • O modo não interativo exige tanto um nome de agente quanto --workspace.
  • main é reservado e não pode ser usado como novo ID de agente.

​
agents bindings

Opções:
  • --agent <id>
  • --json

​
agents bind

Opções:
  • --agent <id> (o padrão é o agente padrão atual)
  • --bind <channel[:accountId]> (repetível)
  • --json

​
agents unbind

Opções:
  • --agent <id> (o padrão é o agente padrão atual)
  • --bind <channel[:accountId]> (repetível)
  • --all
  • --json

​
agents delete <id>

Opções:
  • --force
  • --json
Observações:
  • main não pode ser excluído.
  • Sem --force, é necessária confirmação interativa.
  • Os diretórios de workspace, estado do agente e transcrição de sessão são movidos para a Lixeira, não excluídos permanentemente.

​
Arquivos de identidade

Cada workspace de agente pode incluir um IDENTITY.md na raiz do workspace:
  • Caminho de exemplo: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity lê a partir da raiz do workspace (ou de um --identity-file explícito)
Caminhos de avatar são resolvidos em relação à raiz do workspace.

​
Definir identidade

set-identity grava campos em agents.list[].identity:
  • name
  • theme
  • emoji
  • avatar (caminho relativo ao workspace, URL http(s) ou URI de dados)
Opções:
  • --agent <id>
  • --workspace <dir>
  • --identity-file <path>
  • --from-identity
  • --name <name>
  • --theme <theme>
  • --emoji <emoji>
  • --avatar <value>
  • --json
Observações:
  • --agent ou --workspace podem ser usados para selecionar o agente de destino.
  • Se você depender de --workspace e vários agentes compartilharem esse workspace, o comando falhará e pedirá que você passe --agent.
  • Quando nenhum campo de identidade explícito é fornecido, o comando lê os dados de identidade de IDENTITY.md.
Carregar de IDENTITY.md: 
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
Substituir campos explicitamente: 
openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
Exemplo de configuração: 
{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}