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 ou openclaw setup para a jornada completa guiada da primeira execução, openclaw setup --baseline apenas para a configuração/espaço de trabalho de base, e openclaw channels add quando você só precisar configurar a conta de um canal.

Quando 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 deles (volcengine-plan/*, byteplus-plan/*). Se o filtro de provedor preferido produzir uma lista vazia, configure recorre ao catálogo não filtrado 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 o mesmo perfil OAuth ou chave de API da xAI 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: Configuração

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:

• O assistente completo e as seções relacionadas ao Gateway perguntam onde o Gateway é executado e atualizam gateway.mode. Filtros de seção que não incluem gateway, daemon ou health vão diretamente para a configuração solicitada.
• 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 remota do Gateway 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 será 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 tanto gateway.auth.token quanto 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 configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

Relacionado

• Referência da CLI
• Configuração