Skip to main content
Fluxo de trabalho de desenvolvimento para o runtime do agente (src/agents/) no repositório do OpenClaw.

Verificação de tipos e lint

  • Verificação local padrão: pnpm check (verificação de tipos, lint e verificações de políticas)
  • Verificação de build: pnpm build quando a alteração puder afetar a saída do build, o empacotamento ou os limites de carregamento tardio/módulos
  • Verificação completa antes do push: pnpm build && pnpm check && pnpm check:test-types && pnpm test

Execução dos testes do runtime do agente

Execute as suítes de testes unitários do runtime do agente:
O primeiro glob também abrange as suítes agent-tools*, agent-settings e agent-tool-definition-adapter*. Os testes em ambiente real são excluídos da configuração de testes unitários; execute-os por meio do wrapper de testes em ambiente real (define OPENCLAW_LIVE_TEST=1 e requer credenciais do provedor):

Testes manuais

  • Execute o Gateway no modo de desenvolvimento (ignora as conexões de canais por meio de OPENCLAW_SKIP_CHANNELS=1): pnpm gateway:dev
  • Acione um turno do agente por meio do Gateway: pnpm openclaw agent --message "Hello" --thinking low
  • Use a TUI para depuração interativa: pnpm tui
Para o comportamento de chamadas de ferramentas, solicite uma ação read ou exec para poder observar o streaming da ferramenta e o tratamento do payload.

Redefinição completa

O estado fica no diretório de estado do OpenClaw: ~/.openclaw por padrão, ou $OPENCLAW_STATE_DIR quando definido. Caminhos relativos a esse diretório: Exclua esses caminhos para uma redefinição completa. Redefinições mais específicas:
  • Somente sessões: não exclua agents/<agentId>/agent/openclaw-agent.sqlite; as linhas de sessão ficam nele junto com outros estados por agente. Use /new ou /reset para iniciar uma nova sessão em um chat e openclaw sessions cleanup para a manutenção de sessões.
  • Manter autenticação: preserve agents/<agentId>/agent/openclaw-agent.sqlite e credentials/.
Os arquivos legados auth-profiles.json não são mais lidos durante o runtime; openclaw doctor --fix os importa para o armazenamento SQLite.

Referências

Relacionado