openclaw configure

Prompts interativos para alterações específicas 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 realizar todo o processo guiado da primeira execução, openclaw setup --baseline somente para a configuração básica e o espaço de trabalho, e openclaw channels add quando você precisar apenas configurar uma conta de canal.

Opções

--section <section>: filtro de seção repetível. Seções disponíveis:

workspace, model, web, gateway, daemon, channels, plugins, skills, health

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

Selecionar gateway, daemon ou health (ou executar o assistente completo sem --section) solicita onde o Gateway é executado e atualiza gateway.mode. Os filtros de seção que ignoram as três opções seguem diretamente para a configuração solicitada, sem solicitar o modo do Gateway. Escolher o modo de Gateway remoto grava a configuração remota e encerra imediatamente; essa opção não executa etapas exclusivamente locais, como instalações de plugins.

Seção de modelo

Quando configure é iniciado a partir de uma opção de autenticação de provedor, os seletores de modelo padrão e da lista de permissões priorizam automaticamente esse provedor. Para provedores pareados, como Volcengine e BytePlus, a mesma preferência também corresponde às variantes de planos de programação (volcengine-plan/*, byteplus-plan/*). Se o filtro do provedor preferencial produzir uma lista vazia, configure usa o catálogo sem filtro, em vez de exibir um seletor vazio.

Seção web

openclaw configure --section web seleciona um provedor de pesquisa na web e configura suas credenciais. Alguns provedores exibem opções adicionais específicas:

• Grok pode oferecer a configuração opcional de x_search com o mesmo perfil OAuth da xAI ou chave de API e permitir a escolha de um modelo de x_search.
• Kimi pode solicitar a região da API Moonshot (api.moonshot.ai ou api.moonshot.cn) e o modelo padrão de pesquisa na web do Kimi.

Outras observações

• Após gravar a configuração local, configure instala os plugins selecionados disponíveis para download quando o caminho de configuração escolhido os exige. A configuração do Gateway remoto não instala pacotes locais de plugins.
• Serviços voltados 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 os nomes em IDs quando possível.
• Se você executar a etapa de instalação do daemon, a autenticação por token exigirá um token. Se gateway.auth.token for gerenciado por SecretRef, configure validará o SecretRef, mas não persistirá os valores resolvidos do token em texto simples nos metadados de ambiente do serviço supervisor; se o SecretRef não puder ser resolvido, configure bloqueará a instalação do daemon e fornecerá orientações práticas para a correção.
• Se gateway.auth.token e gateway.auth.password estiverem configurados e gateway.auth.mode não estiver definido, configure bloqueará a instalação do daemon até que você defina explicitamente o modo.

Conteúdo relacionado

• Referência da CLI
• Configuração
• CLI de configuração: Configuração