Ordini permanenti
Gli ordini permanenti concedono al tuo agente autorità operativa permanente per programmi definiti. Invece di fornire ogni volta istruzioni per singole attività, definisci programmi con ambito, trigger e regole di escalation chiari — e l’agente esegue autonomamente entro tali limiti.
Questa è la differenza tra dire al tuo assistente “invia il report settimanale” ogni venerdì e concedere un’autorità permanente: “Sei responsabile del report settimanale. Compilalo ogni venerdì, invialo e fai escalation solo se qualcosa sembra non andare.”
Perché gli ordini permanenti?
Senza ordini permanenti:
- Devi inviare richieste all’agente per ogni attività
- L’agente resta inattivo tra una richiesta e l’altra
- Il lavoro di routine viene dimenticato o ritardato
- Diventi il collo di bottiglia
Con ordini permanenti:
- L’agente esegue autonomamente entro limiti definiti
- Il lavoro di routine avviene nei tempi previsti senza richieste
- Vieni coinvolto solo per eccezioni e approvazioni
- L’agente impiega produttivamente il tempo inattivo
Come funzionano
Gli ordini permanenti sono definiti nei file del tuo spazio di lavoro dell’agente. L’approccio consigliato è includerli direttamente in AGENTS.md (che viene inserito automaticamente in ogni sessione) in modo che l’agente li abbia sempre nel contesto. Per configurazioni più grandi, puoi anche inserirli in un file dedicato come standing-orders.md e farvi riferimento da AGENTS.md.
Ogni programma specifica:
- Ambito — cosa l’agente è autorizzato a fare
- Trigger — quando eseguire (pianificazione, evento o condizione)
- Punti di approvazione — cosa richiede l’approvazione umana prima di agire
- Regole di escalation — quando fermarsi e chiedere aiuto
L’agente carica queste istruzioni a ogni sessione tramite i file bootstrap dello spazio di lavoro (vedi Spazio di lavoro dell’agente per l’elenco completo dei file inseriti automaticamente) ed esegue in base a esse, insieme ai cron jobs per l’applicazione basata sul tempo.
Inserisci gli ordini permanenti in AGENTS.md per garantire che vengano caricati a ogni sessione. Il bootstrap dello spazio di lavoro inserisce automaticamente AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md e MEMORY.md — ma non file arbitrari nelle sottodirectory.
Anatomia di un ordine 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
Ordini permanenti + Cron jobs
Gli ordini permanenti definiscono cosa l’agente è autorizzato a fare. I cron jobs definiscono quando avviene. Lavorano insieme:
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
Il prompt del cron job dovrebbe fare riferimento all’ordine permanente invece di duplicarlo:
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."
Esempi
## 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
Esempio 2: operazioni finanziarie (attivato da eventi)
## 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
Esempio 3: monitoraggio e avvisi (continuo)
## 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 |
Il modello Esegui-Verifica-Report
Gli ordini permanenti funzionano meglio quando sono combinati con una rigorosa disciplina di esecuzione. Ogni attività in un ordine permanente dovrebbe seguire questo ciclo:
- Esegui — Svolgi il lavoro effettivo (non limitarti a confermare l’istruzione)
- Verifica — Conferma che il risultato sia corretto (il file esiste, il messaggio è stato consegnato, i dati sono stati analizzati)
- Report — Comunica al proprietario cosa è stato fatto e cosa è stato verificato
### 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.
Questo modello previene la modalità di errore più comune degli agenti: riconoscere un’attività senza completarla.
Architettura multi-programma
Per gli agenti che gestiscono più aree, organizza gli ordini permanenti come programmi separati con confini chiari:
# 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]
Ogni programma dovrebbe avere:
- La propria cadenza di attivazione (settimanale, mensile, guidata da eventi, continua)
- I propri punti di approvazione (alcuni programmi richiedono più supervisione di altri)
- Confini chiari (l’agente dovrebbe sapere dove finisce un programma e ne inizia un altro)
Best practice
Da fare
- Inizia con un’autorità limitata ed espandila man mano che cresce la fiducia
- Definisci punti di approvazione espliciti per azioni ad alto rischio
- Includi sezioni “Cosa NON fare” — i limiti contano quanto i permessi
- Combina con i cron jobs per un’esecuzione affidabile basata sul tempo
- Controlla settimanalmente i log dell’agente per verificare che gli ordini permanenti vengano seguiti
- Aggiorna gli ordini permanenti man mano che le tue esigenze evolvono — sono documenti vivi
Da evitare
- Concedere ampia autorità dal primo giorno (“fai quello che ritieni meglio”)
- Saltare le regole di escalation — ogni programma ha bisogno di una clausola “quando fermarsi e chiedere”
- Presumere che l’agente ricorderà istruzioni verbali — metti tutto nel file
- Mescolare più aree in un singolo programma — programmi separati per aree separate
- Dimenticare di applicare con i cron jobs — gli ordini permanenti senza trigger diventano suggerimenti
Correlati
- Automazione e attività — una panoramica di tutti i meccanismi di automazione
- Cron Jobs — applicazione della pianificazione per gli ordini permanenti
- Hook — script guidati da eventi per gli eventi del ciclo di vita dell’agente
- Webhook — trigger di eventi HTTP in ingresso
- Spazio di lavoro dell’agente — dove risiedono gli ordini permanenti, incluso l’elenco completo dei file bootstrap inseriti automaticamente (AGENTS.md, SOUL.md, ecc.)