Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
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.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_searchcom a mesmaXAI_API_KEYe permitir que você escolha um modelox_search. - Kimi pode solicitar a região da API Moonshot (
api.moonshot.aivsapi.moonshot.cn) e o modelo padrão de pesquisa na web do Kimi.
- Referência de configuração do Gateway: Configuração
- CLI de configuração: Config
Opções
--section <section>: filtro de seção repetível
workspacemodelwebgatewaydaemonchannelspluginsskillshealth
- 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.tokenfor 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.tokenegateway.auth.passwordestiverem configurados egateway.auth.modenão estiver definido, o configure bloqueia a instalação do daemon até que o modo seja definido explicitamente.