openclaw doctor

Verificações de integridade e correções rápidas para o Gateway, canais, plugins, Skills, roteamento de modelos, estado local e migrações de configuração. Use-o sempre que algo não estiver funcionando como esperado e você quiser que um único comando explique o problema.

Relacionado:

• Solução de problemas: Solução de problemas
• Auditoria de segurança: Segurança

Modos de operação

O Doctor tem cinco modos de operação:

Prefira --lint quando a automação precisar de um resultado estável. Prefira --fix quando um operador humano quiser que o Doctor edite a configuração ou o estado.

Exemplos

openclaw doctoropenclaw doctor --lintopenclaw doctor --lint --jsonopenclaw doctor --lint --severity-min warningopenclaw doctor --lint --allopenclaw doctor --lint --allow-execopenclaw doctor --deepopenclaw doctor --fixopenclaw doctor --fix --non-interactiveopenclaw doctor --generate-gateway-tokenopenclaw doctor --post-upgradeopenclaw doctor --post-upgrade --jsonopenclaw doctor --state-sqlite compactopenclaw doctor --state-sqlite compact --jsonopenclaw doctor --session-sqlite inspect --session-sqlite-all-agentsopenclaw doctor --session-sqlite dry-run --session-sqlite-agent main --jsonopenclaw doctor --session-sqlite import --session-sqlite-all-agentsopenclaw doctor --session-sqlite validate --session-sqlite-all-agents --jsonopenclaw doctor --session-sqlite compact --session-sqlite-all-agentsopenclaw doctor --session-sqlite recover --github-issueopenclaw doctor --session-sqlite restore --session-sqlite-all-agents

Para permissões específicas de canais, use as sondagens de canal em vez de doctor:

openclaw channels capabilities --channel discord --target channel:<channel-id>openclaw channels status --probe

channels capabilities informa as permissões efetivas do bot para um destino de canal específico. channels status --probe audita todos os canais configurados e os destinos de entrada automática em canais de voz.

Opções

--severity-min, --all, --only e --skip são aceitos apenas em conjunto com --lint; --json é aceito com --lint, --post-upgrade, --state-sqlite e --session-sqlite.

Modo Lint

openclaw doctor --lint é somente leitura: sem prompts, sem reparos e sem regravações de configuração/estado.

openclaw doctor --lintopenclaw doctor --lint --severity-min warningopenclaw doctor --lint --jsonopenclaw doctor --lint --allopenclaw doctor --lint --allow-execopenclaw doctor --lint --only core/doctor/gateway-config --jsonopenclaw doctor --lint --only core/doctor/local-audio-acceleration --severity-min info

A saída para pessoas é compacta:

doctor --lint: executou 6 verificação(ões), 1 resultado(s)  [warning] core/doctor/gateway-config gateway.mode - gateway.mode não está definido; a inicialização do gateway será bloqueada.    correção: Execute `openclaw configure` e defina o modo do Gateway (local/remoto), ou `openclaw config set gateway.mode local`.

A saída JSON é a interface para scripts:

{  "ok": false,  "checksRun": 5,  "checksSkipped": 0,  "findings": [    {      "checkId": "core/doctor/gateway-config",      "severity": "warning",      "message": "gateway.mode não está definido; a inicialização do gateway será bloqueada.",      "path": "gateway.mode",      "fixHint": "Execute `openclaw configure` e defina o modo do Gateway (local/remoto), ou `openclaw config set gateway.mode local`."    }  ]}

Códigos de saída:

--severity-min controla tanto quais resultados são exibidos quanto o limiar de saída: openclaw doctor --lint --severity-min error pode não exibir nada e sair com 0, mesmo quando houver resultados info/warning de gravidade inferior.

--all controla quais verificações são selecionadas antes da filtragem por gravidade. A execução padrão do lint exclui verificações profundas, históricas ou com maior probabilidade de revelar resíduos legados reparáveis; use --all para obter o inventário completo. --only <id> é o seletor mais preciso e pode executar qualquer verificação registrada pelo ID.

core/doctor/local-audio-acceleration informa o comando STT local selecionado automaticamente, evidências separadas de backend compatível/solicitado/observado e a ordem de fallback sem carregar um modelo de fala. Ele emite um resultado informativo, portanto inclua --severity-min info para exibi-lo.

Verificações estruturadas de integridade

As verificações modernas do Doctor usam um pequeno contrato dividido:

detect(ctx, scope?) -> HealthFinding[]repair?(ctx, findings) -> HealthRepairResult

detect() alimenta o doctor --lint. repair() é opcional e só é executado com doctor --fix / doctor --repair. As verificações que ainda não foram migradas para esse formato continuam usando o fluxo legado de contribuição do Doctor.

Os contextos de reparo podem conter solicitações dryRun/diff; os resultados de reparo podem retornar diffs estruturados (edições de configuração/arquivo) e effects (efeitos colaterais em serviços, processos, pacotes, estado ou outros), permitindo que as verificações convertidas evoluam para doctor --fix --dry-run sem mover o planejamento de mutações para detect().

repair() informa status: "repaired" | "skipped" | "failed" (a omissão do status significa repaired). Quando o reparo retorna skipped ou failed, o Doctor informa o motivo e ignora a validação dessa verificação. Após um reparo bem-sucedido, o Doctor executa novamente detect() com o escopo limitado aos resultados reparados; se o resultado ainda estiver presente, o Doctor informa um aviso de reparo em vez de considerar a alteração concluída.

Um resultado inclui:

As verificações modernizadas do doctor do núcleo permanecem vinculadas à contribuição ordenada do doctor responsável por seu comportamento humano em doctor / doctor --fix. O registro compartilhado de integridade estruturada é o ponto de extensão: as verificações incluídas e baseadas em plugins são executadas após as verificações do doctor do núcleo, assim que o pacote responsável as registra no caminho de comando ativo. openclaw/plugin-sdk/health expõe o mesmo contrato para autores de plugins.

Seleção de verificações

openclaw doctor --lint --only core/doctor/gateway-config --jsonopenclaw doctor --lint --skip core/doctor/skills-readinessopenclaw doctor --lint --all --skip core/doctor/session-locks

--only e --skip aceitam IDs completos de verificações e podem ser repetidos. Se um ID de --only não estiver registrado, nenhuma verificação será executada para esse ID; use checksRun/checksSkipped na saída para confirmar que uma porta de controle direcionada seleciona as verificações esperadas.

Modo pós-atualização

openclaw doctor --post-upgrade executa sondagens de compatibilidade de plugins para encadeamento após uma compilação ou atualização. As constatações são enviadas para stdout; o código de saída é 1 se qualquer constatação tiver level: "error". Adicione --json para obter um envelope legível por máquina ({ probesRun, findings }), adequado para CI, a skill fork-upgrade da comunidade e outras ferramentas de verificação rápida pós-atualização. Se o índice de plugins instalados estiver ausente ou malformado, o modo JSON ainda emitirá o envelope com uma constatação de erro plugin.index_unavailable.

A inicialização da imagem de contêiner é a exceção ao fluxo habitual de "executar o doctor após a atualização". Quando openclaw gateway run é iniciado em uma nova versão do OpenClaw, ele executa reparos seguros de estado e plugins antes de informar que está pronto. Se o reparo não puder ser concluído com segurança, a inicialização será encerrada e instruirá você a executar a mesma imagem uma vez com openclaw doctor --fix usando o mesmo estado/configuração montado antes de reiniciar o contêiner normalmente.

Compaction do SQLite de estado compartilhado

openclaw doctor --state-sqlite compact é uma manutenção offline explícita do banco de dados canônico de estado compartilhado em <state-dir>/state/openclaw.sqlite. Ele não aceita um caminho arbitrário de banco de dados, nunca é invocado pela operação normal do Gateway e não faz parte de openclaw doctor --fix.

Primeiro, pare o Gateway e crie um backup verificado:

openclaw gateway stopopenclaw backup create --verifyopenclaw doctor --state-sqlite compact --jsonopenclaw gateway start

O comando:

1. Exige um arquivo regular no caminho canônico de estado compartilhado. A ausência do banco de dados é informada como skipped e o comando é encerrado com sucesso.
2. Valida a versão atual compatível do esquema e schema_meta.role = "global" antes de executar o checkpoint ou alterar o arquivo.
3. Exige um wal_checkpoint(TRUNCATE) não ocupado. Pare qualquer processo restante do OpenClaw e tente novamente se o checkpoint estiver ocupado.
4. Define auto_vacuum como INCREMENTAL, executa um VACUUM completo e realiza outro checkpoint.
5. Executa quick_check, integrity_check e foreign_key_check, depois reaplica permissões exclusivas do proprietário ao banco de dados e aos arquivos auxiliares do SQLite.

A saída JSON informa os tamanhos do banco de dados e do WAL, as páginas da lista livre, o tamanho da página e o valor de auto_vacuum antes e depois da Compaction, além dos bytes recuperados e dos resultados de quick_check e integrity_check. foreign_key_check é aplicado com falha segura e não possui um campo de sucesso separado. O SQLite informa auto_vacuum como 0 para nenhum, 1 para completo e 2 para incremental.

A Compaction falha sem realizar alterações quando o esquema é antigo, mais recente que a compilação do OpenClaw em execução ou pertence a um banco de dados de agente. Execute openclaw doctor --fix primeiro para um esquema antigo de estado compartilhado. Restaure um backup compatível ou atualize o OpenClaw para um esquema mais recente.

Migração do SQLite de sessões

O OpenClaw importa automaticamente linhas de sessões legadas e o histórico de transcrições para o banco de dados SQLite de cada agente durante a inicialização do Gateway e durante openclaw doctor --fix. openclaw doctor --session-sqlite <mode> é a ferramenta direcionada de inspeção e validação dessa migração. As linhas de sessões atuais em tempo de execução ficam em ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite. Os arquivos sessions.json legados são fontes de migração. Arquivos JSONL de transcrições ativas são importados e arquivados fora do diretório de sessões ativas após a importação bem-sucedida; arquivos JSONL da camada de arquivamento permanecem como artefatos de suporte, não como alternativas de tempo de execução.

Modos:

Seletores:

• Padrão: o armazenamento configurado do agente padrão, quando esse arquivo de armazenamento legado existe.
• --session-sqlite-agent <id>: um agente configurado.
• --session-sqlite-all-agents: armazenamentos de agentes configurados mais armazenamentos de agentes descobertos.
• --session-sqlite-store <path>: um caminho explícito para um sessions.json legado.

Sequência de inspeção manual:

openclaw doctor --session-sqlite inspect --session-sqlite-all-agentsopenclaw doctor --session-sqlite dry-run --session-sqlite-all-agents --jsonopenclaw doctor --session-sqlite import --session-sqlite-all-agentsopenclaw doctor --session-sqlite validate --session-sqlite-all-agents --jsonopenclaw doctor --session-sqlite compact --session-sqlite-all-agentsopenclaw doctor --session-sqlite recover --github-issue

Faça backup do diretório de estado do OpenClaw antes de executar import em uma instalação com histórico importante. validate termina com código diferente de zero quando uma entrada legada selecionada está ausente do SQLite, um ID de sessão é diferente ou a contagem de eventos de uma transcrição é diferente. Ao usar --session-sqlite-store <path>, verifique se o relatório contém a contagem esperada de destinos; um caminho explícito inexistente de armazenamento não seleciona nenhum destino.

As exclusões no SQLite recuperam primeiro as páginas dentro do banco de dados; elas não necessariamente reduzem o arquivo do banco de dados imediatamente. Após excluir ou arquivar grandes transcrições, execute openclaw doctor --session-sqlite compact --session-sqlite-all-agents para executar checkpoints dos arquivos WAL, executar VACUUM e informar os tamanhos do banco de dados e do WAL antes/depois. A Compaction exige um arquivo regular com o esquema atual do agente, os metadados persistentes do proprietário do agente selecionado e nenhum identificador aberto no processo do doctor. Esta é uma manutenção offline explícita: pare primeiro o Gateway para que as gravações normais não possam disputar com o checkpoint ou o VACUUM.

Cada importação grava um manifesto em ~/.openclaw/session-sqlite-migration-runs/ antes de mover os artefatos de transcrições para o arquivo. Se a inicialização informar uma falha na migração do SQLite de sessões depois que os artefatos forem movidos, execute a recuperação:

openclaw doctor --session-sqlite recover --github-issue

A recuperação seleciona o manifesto de migração com falha mais recente, restaura somente os artefatos arquivados do manifesto, valida os destinos afetados, atualiza os relatórios sanitizados .failure.md e .failure.json e prepara o corpo de uma issue do GitHub que evita conteúdos de transcrições, ambiente bruto, segredos e configuração ilimitada. Quando não existe nenhum manifesto de migração com falha, mas um banco de dados SQLite de agente selecionado está corrompido, não é um banco de dados ou possui arquivos auxiliares de diário sem um banco de dados principal, a recuperação copia o conjunto completo de arquivos para um diretório temporário de inspeção. O SQLite pode reverter um diário ativo válido nessa cópia descartável antes da execução de quick_check, integrity_check e foreign_key_check, enquanto os arquivos forenses originais permanecem intactos. Falhas nas verificações de integridade ou arquivos auxiliares órfãos preservam os arquivos DB, WAL, SHM e de diário de reversão renomeando todo o conjunto descoberto com um único sufixo .corrupt-<timestamp>. Uma falha de renomeação capturada reverte os arquivos já movidos antes de informar a falha, para que um conjunto recuperável de arquivos não seja dividido silenciosamente. Pare o Gateway antes da recuperação; copiar ou renomear um conjunto de arquivos SQLite em alteração ativa não é seguro e se comporta de maneira diferente entre sistemas operacionais. Com --github-issue --yes, o doctor usa a CLI do GitHub para criar a issue em openclaw/openclaw; sem confirmação, ele grava o relatório de suporte local e exibe uma URL de issue pré-preenchida.

restore continua sendo a operação de reversão de nível mais baixo. Ela usa os registros sourcePath -> archivePath do manifesto, move os artefatos arquivados de volta somente quando o caminho original está ausente, informa conflitos quando ambos os caminhos existem e mantém o banco de dados SQLite no lugar.

Downgrade após a migração do SQLite de sessões

Antes de iniciar uma versão antiga do OpenClaw baseada em arquivos, restaure os artefatos legados de transcrições arquivados:

openclaw doctor --session-sqlite restore --session-sqlite-all-agents

Versões antigas leem entradas de sessions.json e os caminhos sessionFile registrados nessas entradas. Após a migração do SQLite, as importações bem-sucedidas movem as transcrições JSONL ativas para session-sqlite-import-archive/, portanto o runtime antigo não consegue ver esse histórico até que a restauração mova esses artefatos registrados no manifesto de volta para seus caminhos originais.

A restauração não exclui dados do SQLite. As sessões criadas após a mudança para o SQLite existem somente no SQLite e não aparecerão no runtime antigo. Se você atualizar novamente mais tarde, execute a sequência normal de validação da migração acima para que o OpenClaw possa comparar os artefatos legados restaurados com as linhas do SQLite antes da importação.

Observações

• No modo Nix (OPENCLAW_NIX_MODE=1), as verificações somente leitura do doctor continuam funcionando, mas doctor --fix, doctor --repair, doctor --yes e doctor --generate-gateway-token ficam desabilitados porque openclaw.json é imutável. Em vez disso, edite a fonte Nix desta instalação; para nix-openclaw, use o Início rápido com foco no agente.
• Os prompts interativos (correções de chaveiro/OAuth etc.) são executados somente quando stdin é um TTY e --non-interactive não está definido. Execuções sem interface (cron, Telegram, sem terminal) ignoram os prompts.
• As execuções não interativas de doctor ignoram o carregamento antecipado de plugins para manter rápidas as verificações de integridade sem interface. As sessões interativas ainda carregam as superfícies de plugin necessárias para o fluxo legado de integridade/reparo.
• --lint é mais rigoroso que --non-interactive: é sempre somente leitura, nunca exibe prompts e nunca aplica migrações seguras. Use doctor --fix ou doctor --repair quando quiser que o doctor faça alterações.
• Por padrão, o doctor não executa SecretRefs de exec ao verificar segredos. Use --allow-exec (com ou sem --lint) somente quando quiser intencionalmente que o doctor execute esses resolvedores de segredos configurados.
• Qualquer gravação de configuração (incluindo um reparo com --fix) rotaciona um backup para ~/.openclaw/openclaw.json.bak (com um conjunto numerado de .bak.1...bak.4). --fix também remove chaves de configuração desconhecidas relatadas pela validação do esquema, listando cada remoção; isso é ignorado enquanto uma atualização está em andamento, para que o estado de atualização parcialmente gravado não seja removido antes do término da migração.
• Defina OPENCLAW_SERVICE_REPAIR_POLICY=external quando outro supervisor controlar o ciclo de vida do Gateway. O doctor ainda relata a integridade do Gateway/serviço e aplica reparos não relacionados ao serviço, mas ignora a instalação/inicialização/reinicialização/preparação do serviço e a limpeza do serviço legado.
• No Linux, o doctor ignora unidades systemd adicionais inativas semelhantes ao Gateway e não regrava os metadados de comando/ponto de entrada de um serviço Gateway systemd em execução durante o reparo. Primeiro interrompa o serviço ou use openclaw gateway install --force para substituir o inicializador ativo.
• doctor --fix --non-interactive relata definições de serviço Gateway ausentes ou obsoletas, mas não as instala nem regrava fora do modo de reparo de atualização. Execute openclaw gateway install para um serviço ausente ou openclaw gateway install --force para substituir o inicializador.
• As verificações de integridade do estado detectam arquivos de transcrição órfãos no diretório de sessões. Arquivá-los como .deleted.<timestamp> exige confirmação interativa; --fix, --yes e execuções sem interface os mantêm no lugar.
• O doctor verifica ~/.openclaw/cron/jobs.json (ou cron.store) em busca de formatos legados de tarefas cron e os regrava antes de importar linhas canônicas para o SQLite.
• O doctor relata tarefas cron com uma substituição explícita de payload.model, incluindo contagens por namespace de provedor e divergências em relação a agents.defaults.model, para que tarefas agendadas que não herdam o modelo padrão fiquem visíveis durante investigações de autenticação ou cobrança.
• O doctor relata tarefas cron ainda marcadas como em execução (state.runningAtMs), o que pode fazer openclaw cron list exibi-las como running. Essa verificação é somente leitura: se nenhum Gateway estiver executando uma tarefa marcada no momento, a próxima inicialização do serviço cron registrará a execução interrompida e removerá o marcador.
• No Linux, o doctor avisa quando o crontab do usuário ainda executa o script legado sem manutenção ~/.openclaw/bin/ensure-whatsapp.sh, que pode relatar incorretamente Gateway inactive quando o cron não tem o ambiente do barramento de usuário do systemd.
• Quando o WhatsApp está habilitado, o doctor verifica se há um loop de eventos degradado do Gateway com clientes openclaw-tui locais ainda em execução. doctor --fix interrompe somente clientes TUI locais verificados, para que as respostas do WhatsApp não fiquem na fila atrás de loops obsoletos de atualização da TUI.
• O doctor regrava referências de modelo legadas openai-codex/* como referências canônicas openai/* nos modelos principais, fallbacks, modelos de geração de imagem/vídeo, substituições de heartbeat/subagente/compaction, hooks, substituições de modelo de canal e pins obsoletos de rota de sessão. --fix também migra perfis de autenticação legados openai-codex:* e entradas auth.order.openai-codex para openai:*, move a intenção do Codex para entradas agentRuntime.id: "codex" no escopo de provedor/modelo, remove pins obsoletos de runtime do agente inteiro/sessão e mantém as referências reparadas de agentes OpenAI no roteamento de autenticação do Codex, em vez da autenticação direta por chave de API da OpenAI.
• O doctor relata listas não vazias de auth.order.<provider> cujos perfis referenciados desapareceram por completo, enquanto existem credenciais armazenadas compatíveis. doctor --fix exclui somente essas substituições obsoletas, restaurando a seleção automática de credenciais por agente; ordens explicitamente vazias, listas parcialmente válidas e ordens sem uma credencial armazenada compatível permanecem inalteradas. Se um armazenamento de autenticação SQLite ativo estiver ilegível ou malformado, o doctor explica por que ignorou esse reparo. Reinicie um Gateway em execução antes de verificar novamente o status da autenticação caso seu modo de recarga de configuração não aplique a gravação automaticamente.
• O doctor limpa o estado legado de preparação de dependências de plugins de versões anteriores do OpenClaw e vincula novamente o pacote openclaw do host para plugins npm gerenciados que o declaram como dependência peer. Ele também repara plugins baixáveis ausentes referenciados pela configuração (plugins.entries, canais configurados, configurações de provedor/pesquisa e runtimes de agente configurados). Durante atualizações de pacote, o doctor ignora o reparo de plugins pelo gerenciador de pacotes até que a troca do pacote seja concluída; depois, execute novamente openclaw doctor --fix se um plugin configurado ainda precisar de recuperação. Se um download falhar, o doctor relata o erro de instalação e preserva a entrada do plugin configurado para a próxima tentativa de reparo.
• O doctor repara configurações obsoletas de plugins removendo IDs de plugins ausentes de plugins.allow/plugins.deny/plugins.entries, além das configurações de canal pendentes correspondentes, destinos de heartbeat e substituições de modelo de canal, quando a descoberta de plugins está íntegra.
• O doctor coloca em quarentena configurações inválidas de plugins desabilitando a entrada plugins.entries.<id> afetada e removendo sua carga config inválida. A inicialização do Gateway já ignora somente esse plugin com problema, para que os outros plugins e canais continuem funcionando.
• O doctor remove o plugins.entries.codex.config.codexDynamicToolsProfile descontinuado; o servidor de aplicativo do Codex sempre mantém nativas as ferramentas de espaço de trabalho nativas do Codex.
• O doctor migra automaticamente a configuração plana legada do Talk (talk.voiceId, talk.modelId e similares) para talk.provider + talk.providers.<provider>. Execuções repetidas de doctor --fix deixam de relatar/aplicar a normalização do Talk quando a única diferença é a ordem das chaves do objeto.
• O doctor inclui uma verificação de prontidão da pesquisa de memória e pode recomendar openclaw configure --section model quando faltam credenciais de embedding.
• O doctor avisa quando nenhum proprietário de comandos está configurado. O proprietário de comandos é a conta do operador humano autorizada a executar comandos exclusivos do proprietário e aprovar ações perigosas. O pareamento por DM apenas permite que alguém converse com o bot; se você aprovou um remetente antes de existir a preparação do primeiro proprietário, defina commands.ownerAllowFrom explicitamente.
• O doctor relata uma nota informativa quando há agentes no modo Codex configurados e existem recursos pessoais da CLI do Codex no diretório inicial do Codex do operador. As inicializações locais do servidor de aplicativo do Codex usam diretórios iniciais isolados por agente; primeiro instale o plugin do Codex, se necessário, e depois use openclaw migrate plan codex para inventariar os recursos que devem ser promovidos deliberadamente.
• O doctor avisa quando Skills permitidas para o agente padrão estão indisponíveis no ambiente de runtime atual (binários, variáveis de ambiente ou configuração ausentes, ou requisitos de sistema operacional não atendidos). doctor --fix pode desabilitar essas Skills indisponíveis com skills.entries.<skill>.enabled=false; se quiser manter a Skill ativa, instale/configure o requisito ausente.
• Se o modo sandbox estiver habilitado, mas o Docker não estiver disponível, o doctor relatará um aviso de alta relevância com a correção (install Docker ou openclaw config set agents.defaults.sandbox.mode off).
• Se houver arquivos legados de registro de sandbox ou diretórios de shards (~/.openclaw/sandbox/containers.json, ~/.openclaw/sandbox/browsers.json, ~/.openclaw/sandbox/containers/ ou ~/.openclaw/sandbox/browsers/), o doctor os relatará; --fix migra entradas válidas para o SQLite e coloca em quarentena arquivos legados inválidos.
• Se gateway.auth.token/gateway.auth.password forem gerenciados por SecretRef e estiverem indisponíveis no caminho de comando atual, o doctor relatará um aviso somente leitura e não gravará credenciais alternativas em texto simples. Para SecretRefs baseados em exec, o doctor ignora a execução, a menos que --allow-exec esteja presente.
• Se a inspeção de SecretRef do canal falhar em um caminho de correção, o doctor continuará e relatará um aviso em vez de encerrar antecipadamente.
• Após migrações do diretório de estado, o doctor avisa quando contas padrão habilitadas do Telegram ou Discord dependem de fallback por variável de ambiente e TELEGRAM_BOT_TOKEN ou DISCORD_BOT_TOKEN não está disponível para o processo do doctor.
• A resolução automática de nomes de usuário de allowFrom do Telegram (doctor --fix) exige um token do Telegram resolvível no caminho de comando atual. Se a inspeção do token estiver indisponível, o doctor relatará um aviso e ignorará a resolução automática nessa execução.

macOS: substituições de ambiente do launchctl

Se você executou anteriormente launchctl setenv OPENCLAW_GATEWAY_TOKEN ... (ou ...PASSWORD), esse valor substitui o arquivo de configuração e pode causar erros persistentes de "não autorizado".

launchctl getenv OPENCLAW_GATEWAY_TOKENlaunchctl getenv OPENCLAW_GATEWAY_PASSWORD launchctl unsetenv OPENCLAW_GATEWAY_TOKENlaunchctl unsetenv OPENCLAW_GATEWAY_PASSWORD

Relacionado

• Referência da CLI
• Doctor do Gateway