--- read_when: - Você está com problemas de conectividade/autenticação e quer correções guiadas - Você atualizou e quer uma verificação rápida summary: Referência da CLI para `openclaw doctor` (verificações de integridade + reparos guiados) title: Diagnóstico x-i18n: generated_at: "2026-07-12T15:00:44Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 15 provider: openai source_hash: 4e616fd0843183167662292acf501297f44520050b664796fbb15a117cb68905 source_path: cli/doctor.md workflow: 16 --- # `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](/pt-BR/gateway/troubleshooting) - Auditoria de segurança: [Segurança](/pt-BR/gateway/security) ## Modos de operação O Doctor tem cinco modos de operação: | Modo de operação | Comando | Comportamento | | ------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------- | | Inspeção | `openclaw doctor` | Verificações voltadas para pessoas e prompts guiados. | | Reparo | `openclaw doctor --fix` | Aplica reparos compatíveis, usando prompts, a menos que o reparo não interativo seja seguro. | | Lint | `openclaw doctor --lint` | Resultados estruturados somente leitura para CI, verificações preliminares e critérios de revisão. | | Manutenção do SQLite compartilhado | `openclaw doctor --state-sqlite compact` | Executa explicitamente checkpoint, compacta e verifica o banco de dados canônico de estado compartilhado. | | Migração do SQLite de sessões | `openclaw doctor --session-sqlite ` | Inspeciona, importa, valida, compacta, recupera ou restaura o estado das sessões. | 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 ```bash openclaw doctor openclaw doctor --lint openclaw doctor --lint --json openclaw doctor --lint --severity-min warning openclaw doctor --lint --all openclaw doctor --lint --allow-exec openclaw doctor --deep openclaw doctor --fix openclaw doctor --fix --non-interactive openclaw doctor --generate-gateway-token openclaw doctor --post-upgrade openclaw doctor --post-upgrade --json openclaw doctor --state-sqlite compact openclaw doctor --state-sqlite compact --json openclaw doctor --session-sqlite inspect --session-sqlite-all-agents openclaw doctor --session-sqlite dry-run --session-sqlite-agent main --json openclaw doctor --session-sqlite import --session-sqlite-all-agents openclaw doctor --session-sqlite validate --session-sqlite-all-agents --json openclaw doctor --session-sqlite compact --session-sqlite-all-agents openclaw doctor --session-sqlite recover --github-issue openclaw doctor --session-sqlite restore --session-sqlite-all-agents ``` Para permissões específicas de canais, use as sondagens de canal em vez de `doctor`: ```bash openclaw channels capabilities --channel discord --target channel: 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 | Opção | Efeito | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--no-workspace-suggestions` | Desativa sugestões de memória/pesquisa do espaço de trabalho. | | `--yes` | Aceita os padrões sem solicitar confirmação. | | `--repair` / `--fix` | Aplica os reparos recomendados que não envolvem serviços sem solicitar confirmação (`--fix` é um alias). Instalações/regravações do serviço do Gateway ainda exigem confirmação interativa ou comandos `gateway` explícitos. | | `--force` | Aplica reparos agressivos, incluindo a substituição de configurações personalizadas de serviços. | | `--non-interactive` | Executa sem prompts; apenas migrações seguras e reparos que não envolvem serviços. | | `--generate-gateway-token` | Gera e configura um token do Gateway. | | `--allow-exec` | Permite que o Doctor execute SecretRefs `exec` configuradas ao verificar segredos. | | `--deep` | Examina os serviços do sistema em busca de instalações adicionais do Gateway; informa transferências recentes de reinicialização do supervisor do Gateway. | | `--lint` | Executa verificações de integridade modernizadas em modo somente leitura e emite resultados de diagnóstico. | | `--post-upgrade` | Executa sondagens de compatibilidade de plugins após a atualização; os resultados são enviados para stdout; código de saída 1 se houver algum resultado de nível de erro. | | `--state-sqlite ` | Executa a manutenção explícita do SQLite de estado compartilhado. O único modo é `compact`. | | `--session-sqlite ` | Executa o modo de migração direcionada do SQLite de sessões: `inspect`, `dry-run`, `import`, `validate`, `compact`, `recover` ou `restore`. | | `--session-sqlite-store ` | Com `--session-sqlite`: seleciona o caminho de um armazenamento legado `sessions.json`. | | `--session-sqlite-agent ` | Com `--session-sqlite`: seleciona um agente configurado. | | `--session-sqlite-all-agents` | Com `--session-sqlite`: seleciona armazenamentos de agentes configurados e descobertos. | | `--github-issue` | Com `--session-sqlite recover`: prepara um relatório sanitizado de issue do openclaw/openclaw; o Doctor o cria com `gh` após `--yes` ou confirmação interativa. | | `--json` | Com `--lint`: resultados em JSON. Com `--post-upgrade`: `{ probesRun, findings }`. Com `--state-sqlite` ou `--session-sqlite`: o relatório de manutenção como JSON. | | `--severity-min ` | Com `--lint`: descarta resultados abaixo de `info`, `warning` ou `error`. | | `--all` | Com `--lint`: executa todas as verificações registradas, incluindo verificações opcionais excluídas do conjunto padrão. | | `--skip ` | Com `--lint`: ignora um ID de verificação. Pode ser repetido. | | `--only ` | Com `--lint`: executa apenas os IDs de verificação especificados. Pode ser repetido. | `--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. ```bash openclaw doctor --lint openclaw doctor --lint --severity-min warning openclaw doctor --lint --json openclaw doctor --lint --all openclaw doctor --lint --allow-exec openclaw doctor --lint --only core/doctor/gateway-config --json openclaw doctor --lint --only core/doctor/local-audio-acceleration --severity-min info ``` A saída para pessoas é compacta: ```text 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: ```json { "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: | Código | Significado | | ------ | ---------------------------------------------------------------------------- | | `0` | Nenhum resultado no limiar de gravidade selecionado ou acima dele. | | `1` | Pelo menos um resultado atende ao limiar selecionado. | | `2` | Falha de comando/execução antes que os resultados do lint possam ser gerados. | `--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 ` é 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: ```ts 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: | Campo | Finalidade | | ----------------- | ----------------------------------------------------------------- | | `checkId` | ID estável para filtros skip/only e listas de permissões da CI. | | `severity` | `info`, `warning` ou `error`. | | `message` | Descrição do problema legível por humanos. | | `path` | Caminho de configuração, arquivo ou lógico, quando disponível. | | `line` / `column` | Localização no código-fonte, quando disponível. | | `ocPath` | Endereço `oc://` preciso quando uma verificação puder apontar para um. | | `fixHint` | Ação sugerida ao operador ou resumo do reparo. | 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 ```bash openclaw doctor --lint --only core/doctor/gateway-config --json openclaw doctor --lint --skip core/doctor/skills-readiness openclaw 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/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: ```bash openclaw gateway stop openclaw backup create --verify openclaw doctor --state-sqlite compact --json openclaw 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 ` é 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//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: | Modo | Comportamento | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `inspect` | Lê as contagens legadas e do SQLite, além dos arquivos JSONL não referenciados, sem importar. | | `dry-run` | Analisa entradas legadas e arquivos JSONL de transcrições, conta linhas importáveis e informa problemas sem gravar linhas no SQLite. | | `import` | Importa entradas legadas e eventos de transcrições para o SQLite nos destinos selecionados. | | `validate` | Compara as fontes legadas selecionadas com as linhas do SQLite e as contagens de eventos de transcrições. | | `compact` | Executa checkpoint e VACUUM nos bancos de dados SQLite dos agentes selecionados para recuperar páginas livres após grandes exclusões ou limpeza de arquivos. | | `recover` | Restaura a execução de migração com falha mais recente, valida seus destinos e prepara um relatório sanitizado de issue no GitHub. | | `restore` | Restaura artefatos de transcrições arquivados a partir dos manifestos de migração registrados sem excluir dados do SQLite. | Seletores: - Padrão: o armazenamento configurado do agente padrão, quando esse arquivo de armazenamento legado existe. - `--session-sqlite-agent `: um agente configurado. - `--session-sqlite-all-agents`: armazenamentos de agentes configurados mais armazenamentos de agentes descobertos. - `--session-sqlite-store `: um caminho explícito para um `sessions.json` legado. Sequência de inspeção manual: ```bash openclaw doctor --session-sqlite inspect --session-sqlite-all-agents openclaw doctor --session-sqlite dry-run --session-sqlite-all-agents --json openclaw doctor --session-sqlite import --session-sqlite-all-agents openclaw doctor --session-sqlite validate --session-sqlite-all-agents --json openclaw doctor --session-sqlite compact --session-sqlite-all-agents openclaw 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 `, 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: ```bash 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-`. 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: ```bash 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](https://github.com/openclaw/nix-openclaw#quick-start) 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.` 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.` 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.` 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.`. 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..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". ```bash launchctl getenv OPENCLAW_GATEWAY_TOKEN launchctl getenv OPENCLAW_GATEWAY_PASSWORD launchctl unsetenv OPENCLAW_GATEWAY_TOKEN launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD ``` ## Relacionado - [Referência da CLI](/pt-BR/cli) - [Doctor do Gateway](/pt-BR/gateway/doctor)