Moviendo la lógica del agente de IA a YAML: Ejecuta desde Telegram, VS Code y CLI

Un desarrollador se cansó de escribir herramientas TypeScript para cada conector en OpenClaw (Postgres, SSH, Slack, etc.). Su solución: mover la lógica de negocio del agente a un archivo agent.yaml y ejecutarlo mediante OE Runtime como servidor HTTP. El SKILL.md de OpenClaw apunta a ese servidor, y el mismo YAML ahora funciona desde Telegram, VS Code y la CLI, sin duplicación de código.

Arquitectura

El flujo se ve así:

Mensaje de usuario en Telegram → OpenClaw llama a POST /run-file → OE Runtime ejecuta agent.yaml → resultado de vuelta a Telegram

Definición del agente en YAML

En lugar de escribir TypeScript para cada herramienta, el agente se define declarativamente:

name: Analista de Base de Datos
instructions: |
  Eres un analista de base de datos...
steps:
  - name: Consulta
    content: Listar todas las tablas y recuentos de filas
connectors:
  - connection_name: Mi Base de Datos
    connection_type: postgresql

Por qué funciona

El efecto secundario clave: el mismo agent.yaml se ejecuta desde VS Code, CLI y HTTP. Sin duplicación. Esto separa la lógica del agente de la capa de interfaz de usuario y lo hace portable entre superficies.

A quién va dirigido

Si estás construyendo con OpenClaw y quieres reducir el código repetitivo de TypeScript, o necesitas que tu agente se ejecute en múltiples entornos (chat, IDE, terminal), este patrón vale la pena.