Movendo a lógica do agente de IA para YAML: Execute pelo Telegram, VS Code e CLI

Um desenvolvedor se cansou de escrever ferramentas TypeScript para cada conector no OpenClaw (Postgres, SSH, Slack, etc.). Sua solução: mover a lógica de negócios do agente para um arquivo agent.yaml e executá-lo via OE Runtime como um servidor HTTP. O SKILL.md do OpenClaw aponta para esse servidor, e o mesmo YAML agora funciona a partir do Telegram, VS Code e CLI — sem duplicação de código.

Arquitetura

O fluxo é assim:

Mensagem do usuário no Telegram → OpenClaw chama POST /run-file → OE Runtime executa agent.yaml → resultado de volta no Telegram

Definição do Agente em YAML

Em vez de escrever TypeScript para cada ferramenta, o agente é definido declarativamente:

name: Analista de Banco de Dados
instructions: |
  Você é um analista de banco de dados...
steps:
  - name: Consulta
    content: Liste todas as tabelas e contagens de linhas
connectors:
  - connection_name: Meu Banco de Dados
    connection_type: postgresql

Por Que Isso Funciona

O efeito colateral principal: o mesmo agent.yaml roda a partir do VS Code, CLI e HTTP. Sem duplicação. Isso separa a lógica do agente da camada de interface e a torna portátil entre superfícies.

Para Quem É Isso

Se você está construindo com OpenClaw e quer reduzir o boilerplate TypeScript, ou precisa que seu agente rode em múltiplos ambientes (chat, IDE, terminal), esse padrão vale a pena ser analisado.