Skip to main content

​
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.
openclaw config sem subcomando abre o mesmo assistente. Use openclaw config get|set|unset para edições não interativas.

​
Opções

--section <section>: filtro de seção repetível. Seções disponíveis: workspace, model, web, gateway, daemon, channels, plugins, skills, health
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.
openclaw configure requer um terminal interativo (tanto stdin quanto stdout devem ser TTYs). Sem um terminal interativo, o comando exibe os comandos não interativos equivalentes openclaw config get|set|patch|validate e encerra com um erro, em vez de executar apenas parcialmente.

​
Seção de modelo

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 opções de configuração específicas de um provedor incorporam os modelos selecionados à 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 um provedor por meio de configure preserva um agents.defaults.model.primary existente, mesmo quando a etapa de autenticação do provedor retorna uma atualização de configuração com seu próprio modelo padrão recomendado. Adicionar ou autenticar novamente um provedor disponibiliza os modelos dele sem substituir seu modelo principal atual. Use openclaw models auth login --provider <id> --set-default ou openclaw models set <model> para alterar intencionalmente o modelo padrão.
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