CLI commands

Configurar

`openclaw configure`

Prompt interativo para configurar credenciais, dispositivos e padrões de agente.

Note

A seção Modelo inclui uma seleção múltipla para a lista de permissões agents.defaults.models (o que aparece em /model e no seletor de modelos). As escolhas de configuração com escopo de provedor mesclam seus modelos selecionados à lista de permissões existente, em vez de substituir provedores não relacionados que já estão na configuração.

Executar novamente a autenticação de provedor a partir de configure preserva um agents.defaults.model.primary existente, mesmo quando a etapa de autenticação do provedor retorna um patch de configuração com seu próprio modelo padrão recomendado. Isso significa que adicionar ou reautenticar xAI, OpenRouter ou outro provedor deve disponibilizar o novo modelo sem assumir o lugar do seu modelo primário atual. Use openclaw models auth login --provider <id> --set-default ou openclaw models set <model> quando você quiser alterar intencionalmente o modelo padrão.

Quando configure é iniciado a partir de uma escolha de autenticação de provedor, os seletores de modelo padrão e lista de permissões preferem esse provedor automaticamente. Para provedores pareados, como Volcengine e BytePlus, a mesma preferência também corresponde às suas variantes de plano de codificação (volcengine-plan/*, byteplus-plan/*). Se o filtro de provedor preferido produzir uma lista vazia, configure volta para o catálogo sem filtro em vez de mostrar um seletor em branco.

Para pesquisa na web, openclaw configure --section web permite escolher um provedor e configurar suas credenciais. Alguns provedores também mostram prompts de acompanhamento específicos do provedor:

Grok pode oferecer configuração opcional de x_search com a mesma XAI_API_KEY e permitir que você escolha um modelo x_search.
Kimi pode solicitar a região da API Moonshot (api.moonshot.ai vs api.moonshot.cn) e o modelo padrão de pesquisa na web do Kimi.

Relacionado:

Referência de configuração do Gateway: Configuração
CLI de configuração: Config

Opções

--section <section>: filtro de seção repetível

Seções disponíveis:

workspace
model
web
gateway
daemon
channels
plugins
skills
health

Observações:

Escolher onde o Gateway é executado sempre atualiza gateway.mode. Você pode selecionar "Continuar" sem outras seções se isso for tudo de que precisa.
Após gravações na configuração local, configure instala os plugins baixáveis selecionados quando o caminho de configuração escolhido exige isso. A configuração de gateway remoto não instala pacotes de plugin locais.
Serviços orientados a canais (Slack/Discord/Matrix/Microsoft Teams) solicitam listas de permissões de canais/salas durante a configuração. Você pode inserir nomes ou IDs; o assistente resolve nomes para IDs quando possível.
Se você executar a etapa de instalação do daemon, a autenticação por token exigir um token e gateway.auth.token for gerenciado por SecretRef, configure valida o SecretRef, mas não persiste valores de token em texto simples resolvidos nos metadados de ambiente do serviço supervisor.
Se a autenticação por token exigir um token e o SecretRef de token configurado não puder ser resolvido, configure bloqueia a instalação do daemon com orientações de correção acionáveis.
Se gateway.auth.token e gateway.auth.password estiverem configurados e gateway.auth.mode não estiver definido, configure bloqueia a instalação do daemon até que o modo seja definido explicitamente.

Exemplos

openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon

# openclaw configure

# Opções

# Exemplos

# Relacionado

`openclaw configure`

Opções

Exemplos

Relacionado