Objetivo

Um objetivo é um objetivo durável anexado à sessão atual do OpenClaw. Ele dá ao agente e ao operador um alvo compartilhado para trabalho de longa duração, sem transformar esse alvo em uma tarefa em segundo plano, lembrete, tarefa cron ou ordem permanente.

Objetivos são estado da sessão. Eles acompanham a chave da sessão, sobrevivem a reinicializações do processo, aparecem em /goal, ficam disponíveis para o modelo por meio das ferramentas de objetivo e aparecem no rodapé da TUI quando a sessão ativa tem um.

Início rápido

Defina um objetivo:

/goal start get CI green for PR 87469 and push the fix

Verifique-o:

/goal

Pause-o quando o trabalho estiver intencionalmente aguardando:

/goal pause waiting for CI

Retome-o:

/goal resume

Marque-o como concluído:

/goal complete pushed and verified

Limpe-o:

/goal clear

Para que servem os objetivos

Use um objetivo quando uma sessão tiver um resultado concreto que deve permanecer visível ao longo de muitos turnos:

• Um fechamento de PR: corrigir, verificar, fazer autoreview, enviar e abrir ou atualizar o PR.
• Uma execução de depuração: reproduzir o bug, identificar a superfície responsável, corrigir e comprovar a correção.
• Uma revisão de docs: ler os docs relevantes, escrever a nova página, adicionar links cruzados e verificar o build dos docs.
• Uma tarefa de manutenção: inspecionar o estado atual, fazer alterações delimitadas, executar as verificações certas e relatar o que mudou.

Um objetivo não é uma fila de tarefas. Use TaskFlow, tarefas, tarefas cron ou ordens permanentes quando o trabalho deve ser executado de forma desacoplada, repetir em uma programação, se desdobrar em subtrabalhos gerenciados ou persistir como uma política.

Referência de comandos

/goal sem argumentos imprime o resumo do objetivo atual:

GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal pause, /goal complete, /goal clear

Comandos:

• /goal ou /goal status mostra o objetivo atual.
• /goal start <objective> cria um novo objetivo para a sessão atual.
• /goal set <objective> e /goal create <objective> são aliases para start.
• /goal pause [note] pausa um objetivo ativo.
• /goal resume [note] retoma um objetivo pausado, bloqueado, limitado por uso ou limitado por orçamento.
• /goal complete [note] marca o objetivo como alcançado.
• /goal done [note] é um alias para complete.
• /goal block [note] marca o objetivo como bloqueado.
• /goal blocked [note] é um alias para block.
• /goal clear remove o objetivo da sessão.

Apenas um objetivo pode existir em uma sessão por vez. Iniciar um segundo objetivo falha até que o atual seja limpo.

Status

Objetivos usam um pequeno conjunto de status:

• active: a sessão está buscando o objetivo.
• paused: o operador pausou o objetivo; /goal resume o torna ativo novamente.
• blocked: o agente ou operador relatou um bloqueio real; /goal resume o torna ativo novamente quando novas informações ou estado estiverem disponíveis.
• budget_limited: o orçamento de tokens configurado foi atingido; /goal resume reinicia a busca a partir do mesmo objetivo.
• usage_limited: reservado para estados de parada por limite de uso; /goal resume reinicia a busca quando permitido.
• complete: o objetivo foi alcançado. Objetivos concluídos são terminais; use /goal clear antes de iniciar outro objetivo.

/new e /reset limpam o objetivo da sessão atual porque iniciam intencionalmente um contexto de sessão novo.

Orçamentos de tokens

Objetivos podem ter um orçamento de tokens positivo opcional. O orçamento é armazenado com o objetivo e medido a partir da contagem de tokens nova da sessão no momento da criação. Se a sessão atual tiver apenas uso de tokens obsoleto ou desconhecido quando o objetivo começa, o OpenClaw aguarda o próximo instantâneo novo de tokens da sessão e usa isso como a linha de base, para que tokens gastos antes de o objetivo existir não sejam cobrados do objetivo.

Quando o uso de tokens atinge o orçamento, o objetivo muda para budget_limited. Isso não exclui o objetivo nem apaga o objetivo. Ele informa ao operador e ao agente que o objetivo não está mais sendo buscado ativamente até ser retomado ou limpo.

Orçamentos de tokens são uma proteção de objetivo de sessão, não um limite de cobrança. Cota do provedor, relatórios de custo e comportamento da janela de contexto ainda usam os controles normais de uso e modelo do OpenClaw.

Ferramentas do modelo

O OpenClaw expõe três ferramentas centrais de objetivo para harnesses de agente:

• get_goal: lê o objetivo da sessão atual, incluindo status, objetivo, uso de tokens e orçamento de tokens.
• create_goal: cria um objetivo apenas quando as instruções do usuário, sistema ou desenvolvedor solicitam explicitamente um. Ele falha se a sessão já tiver um objetivo.
• update_goal: marca o objetivo como complete ou blocked.

O modelo não pode pausar, retomar, limpar ou substituir um objetivo silenciosamente. Esses são controles de operador/sessão por meio de /goal e comandos de redefinição. Isso impede que o agente mova o alvo discretamente, preservando um caminho limpo para o agente relatar a conclusão ou um bloqueio genuíno.

A ferramenta update_goal deve marcar um objetivo como complete apenas quando o objetivo for realmente alcançado. Ela deve marcar um objetivo como blocked apenas quando a mesma condição de bloqueio se repetiu e o agente não consegue fazer progresso significativo sem nova entrada do usuário ou uma mudança de estado externa.

TUI

A TUI mantém o objetivo da sessão ativa visível no rodapé ao lado do agente, sessão, modelo, controles de execução e contagens de tokens.

Exemplos de rodapé:

• Pursuing goal (12k/50k) para um objetivo ativo com orçamento de tokens.
• Goal paused (/goal resume) para um objetivo pausado.
• Goal blocked (/goal resume) para um objetivo bloqueado.
• Goal hit usage limits (/goal resume) para um objetivo limitado por uso.
• Goal unmet (50k/50k) para um objetivo limitado por orçamento.
• Goal achieved (42k) para um objetivo concluído.

O rodapé é intencionalmente compacto. Use /goal para ver o objetivo completo, nota, orçamento de tokens e comandos disponíveis.

Comportamento de canal

O comando /goal funciona em sessões do OpenClaw com suporte a comandos, incluindo a TUI e superfícies de chat que permitem comandos de texto. O estado do objetivo é anexado à chave da sessão, não ao transporte. Se duas superfícies usarem a mesma sessão, elas verão o mesmo objetivo.

O estado do objetivo não é uma diretiva de entrega. Ele não força respostas por meio de um canal, altera o comportamento da fila, aprova ferramentas nem agenda trabalho.

Solução de problemas

Goal error: goal already exists significa que a sessão já tem um objetivo. Use /goal para inspecioná-lo, /goal complete se ele estiver concluído ou /goal clear antes de iniciar um objetivo diferente.

Goal error: goal not found significa que a sessão ainda não tem objetivo. Inicie um com /goal start <objective>.

Goal error: goal is already complete significa que o objetivo é terminal. Limpe-o antes de iniciar ou retomar outro objetivo.

Se o uso de tokens parecer 0 ou obsoleto, a sessão ativa talvez ainda não tenha um instantâneo novo de tokens. O uso é atualizado à medida que o OpenClaw registra o uso da sessão e totais derivados da transcrição.

Relacionados

• Comandos slash
• TUI
• Ferramenta de sessão
• Compaction
• TaskFlow
• Ordens permanentes