openclaw daemon

Alias legado para o gerenciamento do serviço Gateway. openclaw daemon ... corresponde aos mesmos comandos de controle de serviço que openclaw gateway .... Prefira openclaw gateway para obter a documentação e os exemplos atuais.

Uso

openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

Subcomandos e opções

• status: mostra o estado de instalação do serviço (launchd/systemd/schtasks) e verifica a integridade do Gateway.
• install: instala o serviço; --force reinstala/sobrescreve uma instalação existente.
• restart --safe: solicita que o Gateway em execução faça uma verificação preliminar do trabalho ativo e agende uma única reinicialização consolidada após a conclusão do trabalho, limitada por gateway.reload.deferralTimeoutMs (padrão de 300000ms/5 minutos; defina como 0 para aguardar indefinidamente). Quando esse limite expira, a reinicialização é forçada mesmo assim. restart simples usa diretamente o gerenciador de serviços; --force é a substituição imediata.
• restart --safe --skip-deferral: ignora a barreira de adiamento por trabalho ativo para que o Gateway seja reiniciado imediatamente, mesmo quando bloqueadores são relatados. Requer --safe.

Observações

• status resolve SecretRefs de autenticação configuradas para autenticar a verificação quando possível. Se uma SecretRef obrigatória não for resolvida, status --json relatará rpc.authWarning; forneça --token/--password explicitamente ou resolva primeiro a origem do segredo. Os avisos de autenticação não resolvida são suprimidos quando a verificação é bem-sucedida nos demais aspectos.
• status --deep adiciona uma varredura de melhor esforço no nível do sistema em busca de outros serviços semelhantes ao Gateway (exibe dicas de limpeza; a recomendação continua sendo um Gateway por máquina) e executa a validação da configuração no modo compatível com plugins, exibindo avisos do manifesto de plugins ignorados pelo caminho rápido padrão.
• Em instalações do systemd no Linux, as verificações de divergência de token inspecionam as fontes de unidade Environment= e EnvironmentFile=.
• As verificações de divergência de token resolvem as SecretRefs de gateway.auth.token usando o ambiente de execução combinado (primeiro o ambiente do comando do serviço e depois o ambiente do processo). Se a autenticação por token não estiver efetivamente ativa (gateway.auth.mode com valor password/none/trusted-proxy, ou não definido quando a senha puder prevalecer), a resolução do token da configuração será ignorada.
• install valida se uma SecretRef gerenciada de gateway.auth.token pode ser resolvida, mas nunca persiste o valor resolvido nos metadados do ambiente do serviço; se não puder resolvê-la, a instalação falhará de forma segura.
• Se gateway.auth.token e gateway.auth.password estiverem configurados e gateway.auth.mode não estiver definido, install ficará bloqueado até que o modo seja definido explicitamente.
• No macOS, install mantém os plists do LaunchAgent e o arquivo de ambiente/wrapper gerado acessíveis somente pelo proprietário (modo 0600/0700), em vez de incorporar segredos em EnvironmentVariables.
• Ao executar vários Gateways em um único host: isole portas, configuração/estado e espaços de trabalho. Consulte Vários gateways.

Relacionado

• Referência da CLI
• Guia operacional do Gateway