CLI commands

Configurar

`openclaw configure`

Prompt interativo para alterações direcionadas em uma configuração existente: credenciais, dispositivos, padrões de agentes, Gateway, canais, plugins, Skills e verificações de integridade.

Use openclaw onboard para o percurso inicial completo guiado, openclaw setup apenas para a configuração/espaço de trabalho de base e openclaw channels add quando você só precisar configurar a conta do canal.

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 os modelos selecionados na lista de permissões existente, em vez de substituir provedores não relacionados que já estejam na configuração.

Executar novamente a autenticação de provedor pelo 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 o configure começa 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 variantes de plano de codificação (volcengine-plan/*, byteplus-plan/*). Se o filtro de provedor preferido produzir uma lista vazia, o configure volta ao 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 a 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, o configure instala os plugins baixáveis selecionados quando o caminho de configuração escolhido os exige. A configuração de Gateway remoto não instala pacotes de plugins locais.
Serviços orientados a canais (Slack/Discord/Matrix/Microsoft Teams) solicitam listas de permissões de canal/sala 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, o 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 do token configurado não for resolvido, o 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, o configure bloqueia a instalação do daemon até que o modo seja definido explicitamente.

Exemplos

bash

openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

Relacionado

Was this useful?