AI 에이전트 로직을 YAML로 옮기기: Telegram, VS Code, CLI에서 실행하기

한 개발자는 OpenClaw의 모든 커넥터(Postgres, SSH, Slack 등)에 대해 TypeScript 도구를 작성하는 것에 지쳤습니다. 그의 해결책: 에이전트 비즈니스 로직을 agent.yaml 파일로 옮기고 OE Runtime을 HTTP 서버로 실행하는 것입니다. OpenClaw의 SKILL.md는 해당 서버를 가리키며, 동일한 YAML이 이제 Telegram, VS Code, CLI에서 작동합니다 — 코드 중복 없이요.

아키텍처

흐름은 다음과 같습니다:

Telegram의 사용자 메시지 → OpenClaw가 POST /run-file 호출 → OE Runtime이 agent.yaml 실행 → 결과가 Telegram으로 반환

YAML의 에이전트 정의

각 도구에 대해 TypeScript를 작성하는 대신, 에이전트는 선언적으로 정의됩니다:

name: 데이터베이스 분석가
instructions: |
  당신은 데이터베이스 분석가입니다...
steps:
  - name: 쿼리
    content: 모든 테이블과 행 수를 나열하세요
connectors:
  - connection_name: 내 데이터베이스
    connection_type: postgresql

효과적인 이유

핵심 부수 효과: 동일한 agent.yaml이 VS Code, CLI, HTTP에서 실행됩니다. 중복이 없습니다. 이는 에이전트 로직을 UI 계층과 분리하고 여러 환경에서 이식 가능하게 만듭니다.

대상

OpenClaw로 빌드하면서 TypeScript 보일러플레이트를 줄이고 싶거나, 에이전트가 여러 환경(채팅, IDE, 터미널)에서 실행되어야 한다면 이 패턴을 살펴볼 가치가 있습니다.