Todos os produtos
Search
Central de documentação

PolarDB:UpdatePolarClawAgent

Última atualização: Jun 30, 2026

Atualiza um agente PolarClaw.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ApplicationId

string

Sim

O ID da aplicação.

pa-**************

AgentId

string

Sim

O ID do agente a ser atualizado.

work

Name

string

Não

O novo nome de exibição do agente.

Work Bot

Workspace

string

Não

O novo caminho do diretório de trabalho.

/home/node/.openclaw/workspace-work-v2

Model

string

Não

A sobrescrita do modelo.

claude-sonnet-4-5

Avatar

string

Não

O novo avatar.

test

Files

array<object>

Não

A lista de arquivos a serem atualizados.

[{"FileName":"SOUL.md","FileContent":"You are a helpful assistant."}]

object

Não

A lista de arquivos.

FileName

string

Não

O nome do arquivo. O valor deve ser um dos seguintes nomes de arquivo permitidos: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md, MEMORY.md ou MEMORY.alt.md.

SOUL.md

FileContent

string

Não

O conteúdo do arquivo.

You are a helpful assistant.

Restart

boolean

Não

Especifica se o gateway deve ser reiniciado após a criação. Valor padrão: true.

true

IsDefault

boolean

Não

Especifica se o agente deve ser definido como o agente padrão.

true

KeepWorkspaceFiles

boolean

Não

Especifica se os arquivos devem ser mantidos ao alternar o workspace.

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

CDB3258F-B5DE-43C4-8935-CBA0CA******

Message

string

A mensagem da resposta.

successful

Code

integer

O código de status da resposta.

200

ApplicationId

string

O ID da aplicação.

pa-**************

AgentId

string

O ID do agente.

main

Agent

object

Os detalhes do agente atualizado.

Id

string

O ID do agente.

main

Name

string

O nome de exibição do agente.

PolarClaw

Identity

object

As informações de identidade.

Name

string

O nome da identidade.

PolarClaw

Theme

string

O tema.

soul lobster

Emoji

string

O identificador de emoji (formato Unicode, como U+1F99E, ou caractere de emoji direto).

U+1F99E

Avatar

string

O caminho ou conteúdo do avatar.

test

AvatarUrl

string

A URL do avatar.

test

Workspace

string

O caminho do diretório de trabalho.

/home/node/.openclaw/workspace-work-v2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CDB3258F-B5DE-43C4-8935-CBA0CA******",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "AgentId": "main",
  "Agent": {
    "Id": "main",
    "Name": "PolarClaw",
    "Identity": {
      "Name": "PolarClaw",
      "Theme": "soul lobster",
      "Emoji": "U+1F99E",
      "Avatar": "test",
      "AvatarUrl": "test"
    },
    "Workspace": "/home/node/.openclaw/workspace-work-v2"
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.