Instrucciones permanentes

Las órdenes permanentes otorgan a tu agente autoridad operativa permanente para programas definidos. En lugar de dar instrucciones de tareas individuales cada vez, defines programas con alcance, activadores y reglas de escalamiento claros, y el agente ejecuta de forma autónoma dentro de esos límites.

Esta es la diferencia entre decirle a tu asistente "envía el informe semanal" cada viernes y concederle autoridad permanente: "Tú eres responsable del informe semanal. Compílalo cada viernes, envíalo y escala solo si algo parece estar mal."

# Por qué usar órdenes permanentes

Sin órdenes permanentes:

• Debes pedirle al agente cada tarea
• El agente permanece inactivo entre solicitudes
• El trabajo rutinario se olvida o se retrasa
• Tú te conviertes en el cuello de botella

Con órdenes permanentes:

• El agente ejecuta de forma autónoma dentro de límites definidos
• El trabajo rutinario ocurre según el calendario sin necesidad de pedirlo
• Solo participas ante excepciones y aprobaciones
• El agente aprovecha el tiempo inactivo de forma productiva

# Cómo funcionan

Las órdenes permanentes se definen en los archivos de tu espacio de trabajo del agente. El enfoque recomendado es incluirlas directamente en AGENTS.md (que se inyecta automáticamente en cada sesión) para que el agente siempre las tenga en contexto. Para configuraciones más grandes, también puedes colocarlas en un archivo dedicado como standing-orders.md y referenciarlo desde AGENTS.md.

Cada programa especifica:

1. Alcance - lo que el agente está autorizado a hacer
2. Activadores - cuándo ejecutar (calendario, evento o condición)
3. Controles de aprobación - qué requiere aprobación humana antes de actuar
4. Reglas de escalamiento - cuándo detenerse y pedir ayuda

El agente carga estas instrucciones en cada sesión mediante los archivos de arranque del espacio de trabajo (consulta Espacio de trabajo del agente para ver la lista completa de archivos inyectados automáticamente) y ejecuta según ellas, combinadas con trabajos Cron para la aplicación basada en tiempo.

# Anatomía de una orden 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

# Órdenes permanentes más trabajos Cron

Las órdenes permanentes definen qué está autorizado a hacer el agente. Los trabajos Cron definen cuándo ocurre. Funcionan juntos:

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

El mensaje del trabajo Cron debe hacer referencia a la orden permanente en lugar de duplicarla:

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."

# Ejemplos

# Ejemplo 1: contenido y redes sociales (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

# Ejemplo 2: operaciones financieras (activadas 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

# Ejemplo 3: monitoreo y alertas (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     |

# Patrón ejecutar-verificar-informar

Las órdenes permanentes funcionan mejor cuando se combinan con una disciplina estricta de ejecución. Cada tarea en una orden permanente debe seguir este ciclo:

1. Ejecutar - Hacer el trabajo real (no solo confirmar la instrucción)
2. Verificar - Confirmar que el resultado es correcto (el archivo existe, el mensaje se entregó, los datos se analizaron)
3. Informar - Decirle al propietario qué se hizo y qué se verificó

### 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.

Este patrón evita el modo de falla más común del agente: confirmar una tarea sin completarla.

# Arquitectura multiprograma

Para agentes que gestionan varios ámbitos, organiza las órdenes permanentes como programas separados con límites claros:

## 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 debe tener:

• Su propia cadencia de activación (semanal, mensual, basada en eventos, continua)
• Sus propios controles de aprobación (algunos programas necesitan más supervisión que otros)
• Límites claros (el agente debe saber dónde termina un programa y empieza otro)

# Buenas prácticas

# Haz

• Comienza con autoridad limitada y amplíala a medida que crece la confianza
• Define controles de aprobación explícitos para acciones de alto riesgo
• Incluye secciones de "Qué NO hacer"; los límites importan tanto como los permisos
• Combina con trabajos Cron para una ejecución fiable basada en tiempo
• Revisa los registros del agente semanalmente para verificar que se estén siguiendo las órdenes permanentes
• Actualiza las órdenes permanentes a medida que evolucionen tus necesidades; son documentos vivos

# Evita

• Conceder autoridad amplia desde el primer día ("haz lo que creas mejor")
• Omitir reglas de escalamiento; cada programa necesita una cláusula de "cuándo detenerse y preguntar"
• Suponer que el agente recordará instrucciones verbales; pon todo en el archivo
• Mezclar ámbitos en un solo programa; usa programas separados para dominios separados
• Olvidar aplicar con trabajos Cron; las órdenes permanentes sin activadores se convierten en sugerencias

# Relacionado

• Automatización y tareas: todos los mecanismos de automatización de un vistazo.
• Trabajos Cron: aplicación de calendarios para órdenes permanentes.
• Hooks: scripts basados en eventos para eventos del ciclo de vida del agente.
• Webhooks: activadores de eventos HTTP entrantes.
• Espacio de trabajo del agente: donde viven las órdenes permanentes, incluida la lista completa de archivos de arranque inyectados automáticamente (AGENTS.md, SOUL.md, etc.).