Pular para o conteúdo principal

Ordens permanentes

As ordens permanentes concedem ao seu agente autoridade operacional permanente para programas definidos. Em vez de fornecer instruções de tarefas individuais todas as vezes, você define programas com escopo, gatilhos e regras de escalonamento claros — e o agente executa de forma autônoma dentro desses limites. Esta é a diferença entre dizer ao seu assistente “envie o relatório semanal” toda sexta-feira versus conceder autoridade permanente: “Você é responsável pelo relatório semanal. Compile-o toda sexta-feira, envie-o e só escale se algo parecer errado.”

Por que ordens permanentes?

Sem ordens permanentes:
  • Você precisa dar um prompt ao agente para cada tarefa
  • O agente fica ocioso entre solicitações
  • O trabalho rotineiro é esquecido ou atrasado
  • Você se torna o gargalo
Com ordens permanentes:
  • O agente executa de forma autônoma dentro de limites definidos
  • O trabalho rotineiro acontece no cronograma sem prompts
  • Você só se envolve em exceções e aprovações
  • O agente preenche o tempo ocioso de forma produtiva

Como funcionam

As ordens permanentes são definidas nos arquivos do seu workspace do agente. A abordagem recomendada é incluí-las diretamente em AGENTS.md (que é injetado automaticamente em todas as sessões) para que o agente sempre as tenha em contexto. Para configurações maiores, você também pode colocá-las em um arquivo dedicado como standing-orders.md e referenciá-lo a partir de AGENTS.md. Cada programa especifica:
  1. Escopo — o que o agente está autorizado a fazer
  2. Gatilhos — quando executar (cronograma, evento ou condição)
  3. Portões de aprovação — o que exige aprovação humana antes de agir
  4. Regras de escalonamento — quando parar e pedir ajuda
O agente carrega essas instruções em todas as sessões por meio dos arquivos de bootstrap do workspace (consulte Agent Workspace para ver a lista completa de arquivos injetados automaticamente) e executa com base nelas, em conjunto com tarefas cron para aplicação baseada em tempo.
Coloque as ordens permanentes em AGENTS.md para garantir que sejam carregadas em todas as sessões. O bootstrap do workspace injeta automaticamente AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md e MEMORY.md — mas não arquivos arbitrários em subdiretórios.

Anatomia de uma ordem permanente

## Program: Weekly Status Report

**Authority:** Compile data, generate report, deliver to stakeholders
**Trigger:** Every Friday at 4 PM (enforced via cron job)
**Approval gate:** None for standard reports. Flag anomalies for human review.
**Escalation:** If data source is unavailable or metrics look unusual (>2σ from norm)

### Execution Steps

1. Pull metrics from configured sources
2. Compare to prior week and targets
3. Generate report in Reports/weekly/YYYY-MM-DD.md
4. Deliver summary via configured channel
5. Log completion to Agent/Logs/

### What NOT to Do

- Do not send reports to external parties
- Do not modify source data
- Do not skip delivery if metrics look bad — report accurately

Ordens permanentes + tarefas cron

As ordens permanentes definem o que o agente está autorizado a fazer. As tarefas cron definem quando isso acontece. Elas funcionam juntas:
Standing Order: "You own the daily inbox triage"

Cron Job (8 AM daily): "Execute inbox triage per standing orders"

Agent: Reads standing orders → executes steps → reports results
O prompt da tarefa cron deve fazer referência à ordem permanente em vez de duplicá-la:
openclaw cron add \
  --name daily-inbox-triage \
  --cron "0 8 * * 1-5" \
  --tz America/New_York \
  --timeout-seconds 300 \
  --announce \
  --channel bluebubbles \
  --to "+1XXXXXXXXXX" \
  --message "Execute daily inbox triage per standing orders. Check mail for new alerts. Parse, categorize, and persist each item. Report summary to owner. Escalate unknowns."

Exemplos

Exemplo 1: Conteúdo e redes sociais (ciclo semanal)

## Program: Content & Social Media

**Authority:** Draft content, schedule posts, compile engagement reports
**Approval gate:** All posts require owner review for first 30 days, then standing approval
**Trigger:** Weekly cycle (Monday review → mid-week drafts → Friday brief)

### Weekly Cycle

- **Monday:** Review platform metrics and audience engagement
- **Tuesday–Thursday:** Draft social posts, create blog content
- **Friday:** Compile weekly marketing brief → deliver to owner

### Content Rules

- Voice must match the brand (see SOUL.md or brand voice guide)
- Never identify as AI in public-facing content
- Include metrics when available
- Focus on value to audience, not self-promotion

Exemplo 2: Operações financeiras (acionadas por evento)

## Program: Financial Processing

**Authority:** Process transaction data, generate reports, send summaries
**Approval gate:** None for analysis. Recommendations require owner approval.
**Trigger:** New data file detected OR scheduled monthly cycle

### When New Data Arrives

1. Detect new file in designated input directory
2. Parse and categorize all transactions
3. Compare against budget targets
4. Flag: unusual items, threshold breaches, new recurring charges
5. Generate report in designated output directory
6. Deliver summary to owner via configured channel

### Escalation Rules

- Single item > $500: immediate alert
- Category > budget by 20%: flag in report
- Unrecognizable transaction: ask owner for categorization
- Failed processing after 2 retries: report failure, do not guess

Exemplo 3: Monitoramento e alertas (contínuo)

## Program: System Monitoring

**Authority:** Check system health, restart services, send alerts
**Approval gate:** Restart services automatically. Escalate if restart fails twice.
**Trigger:** Every heartbeat cycle

### Checks

- Service health endpoints responding
- Disk space above threshold
- Pending tasks not stale (>24 hours)
- Delivery channels operational

### Response Matrix

| Condition        | Action                   | Escalate?                |
| ---------------- | ------------------------ | ------------------------ |
| Service down     | Restart automatically    | Only if restart fails 2x |
| Disk space < 10% | Alert owner              | Yes                      |
| Stale task > 24h | Remind owner             | No                       |
| Channel offline  | Log and retry next cycle | If offline > 2 hours     |

O padrão Executar-Verificar-Relatar

As ordens permanentes funcionam melhor quando combinadas com disciplina rígida de execução. Toda tarefa em uma ordem permanente deve seguir este ciclo:
  1. Executar — faça o trabalho real (não apenas reconheça a instrução)
  2. Verificar — confirme que o resultado está correto (o arquivo existe, a mensagem foi entregue, os dados foram analisados)
  3. Relatar — diga ao proprietário o que foi feito e o que foi verificado
### Execution Rules

- Every task follows Execute-Verify-Report. No exceptions.
- "I'll do that" is not execution. Do it, then report.
- "Done" without verification is not acceptable. Prove it.
- If execution fails: retry once with adjusted approach.
- If still fails: report failure with diagnosis. Never silently fail.
- Never retry indefinitely — 3 attempts max, then escalate.
Esse padrão evita o modo de falha mais comum de agentes: reconhecer uma tarefa sem concluí-la.

Arquitetura com vários programas

Para agentes que gerenciam várias responsabilidades, organize as ordens permanentes como programas separados com limites claros:
# Standing Orders

## Program 1: [Domain A] (Weekly)

...

## Program 2: [Domain B] (Monthly + On-Demand)

...

## Program 3: [Domain C] (As-Needed)

...

## Escalation Rules (All Programs)

- [Common escalation criteria]
- [Approval gates that apply across programs]
Cada programa deve ter:
  • Sua própria cadência de gatilho (semanal, mensal, orientada por evento, contínua)
  • Seus próprios portões de aprovação (alguns programas precisam de mais supervisão do que outros)
  • Limites claros (o agente deve saber onde um programa termina e outro começa)

Boas práticas

Faça

  • Comece com autoridade restrita e expanda à medida que a confiança aumenta
  • Defina portões de aprovação explícitos para ações de alto risco
  • Inclua seções de “O que NÃO fazer” — os limites importam tanto quanto as permissões
  • Combine com tarefas cron para execução confiável baseada em tempo
  • Revise os logs do agente semanalmente para verificar se as ordens permanentes estão sendo seguidas
  • Atualize as ordens permanentes conforme suas necessidades evoluem — são documentos vivos

Evite

  • Conceder autoridade ampla no primeiro dia (“faça o que achar melhor”)
  • Pular regras de escalonamento — todo programa precisa de uma cláusula de “quando parar e perguntar”
  • Presumir que o agente vai se lembrar de instruções verbais — coloque tudo no arquivo
  • Misturar responsabilidades em um único programa — programas separados para domínios separados
  • Esquecer de aplicar com tarefas cron — ordens permanentes sem gatilhos se tornam sugestões

Relacionado

  • Automation & Tasks — todos os mecanismos de automação em um relance
  • Cron Jobs — aplicação de cronograma para ordens permanentes
  • Hooks — scripts orientados por eventos para eventos do ciclo de vida do agente
  • Webhooks — gatilhos de eventos HTTP de entrada
  • Agent Workspace — onde ficam as ordens permanentes, incluindo a lista completa de arquivos de bootstrap injetados automaticamente (AGENTS.md, SOUL.md etc.)