OpenProse로 AI 워크플로우 자동화하기

복잡한 AI 세션을 관리하다 보면 금방 한계에 부딪히곤 해요. 여러 에이전트에게 일일이 명령을 내리고, 결과를 복사해서 다른 곳에 붙여넣고, 전체 흐름을 제어하는 과정은 생각보다 번거롭고 실수하기 쉽죠.

OpenProse는 이런 반복적인 작업을 줄이기 위해 만들어졌어요. Markdown 중심의 워크플로우 형식을 사용하여 AI 세션을 구조화하고, 여러 서브 에이전트를 명확한 흐름에 따라 실행할 수 있게 도와줍니다.

필요한 것

OpenClaw 설치
활성화된 Gateway

빠른 시작

5분 안에 OpenProse를 설정하고 실행하는 방법이에요.

Plugin 활성화: 터미널에서 아래 명령어를 입력하세요.
Terminal window
```
openclaw plugins enable open-prose
```
Gateway 재시작: 설정을 적용하려면 Gateway를 다시 시작해야 해요.
명령어 확인: /prose help를 입력해 사용 가능한 기능을 확인하세요.
예제 실행: /prose examples로 기본 예제를 살펴볼 수 있어요.

`.prose` 파일 작성하기

OpenProse 프로그램은 .prose 확장자를 가진 파일에 작성해요. 아래는 두 에이전트를 병렬로 실행하는 간단한 예시 코드예요.

# Research + synthesis with two agents running in parallel.

input topic: "What should we research?"

agent researcher:
  model: sonnet
  prompt: "You research thoroughly and cite sources."

agent writer:
  model: opus
  prompt: "You write a concise summary."

parallel:
  findings = session: researcher
    prompt: "Research {topic}."
  draft = session: writer
    prompt: "Summarize {topic}."

session "Merge the findings + draft into a final answer."
context: { findings, draft }

주요 기능 및 설정

Slash command 활용

OpenProse는 /prose라는 Slash command를 제공해요. 자주 사용하는 명령어는 다음과 같아요.

/prose run <file.prose>: 로컬 파일 실행
/prose run <handle/slug>: 원격 프로그램 실행
/prose compile <file.prose>: 프로그램 컴파일
/prose update: 최신 상태로 업데이트

State 관리 모드

OpenProse는 작업 상태를 저장하기 위해 네 가지 백엔드를 지원해요.

filesystem (기본값): .prose/runs/ 경로에 저장
in-context: 휘발성 저장, 작은 프로그램용
sqlite (실험적): sqlite3 바이너리 필요
postgres (실험적): psql 및 접속 문자열 필요

OpenClaw Runtime 매핑

OpenProse의 개념은 OpenClaw의 기본 도구들과 다음과 같이 연결돼요.

OpenProse 개념	OpenClaw 도구
Spawn session / Task tool	`sessions_spawn`
File read/write & Web fetch	`read`, `write`, `web_fetch`

문제 해결

프로그램 실행 실패: OpenClaw의 도구 허용 목록(allowlist)에서 sessions_spawn, read, write, web_fetch가 차단되어 있는지 확인하세요. 이 도구들이 막혀 있으면 OpenProse가 작동하지 않아요.
보안 주의: Postgres를 사용할 경우 인증 정보가 서브 에이전트 로그에 노출될 수 있어요. 반드시 권한이 최소화된 전용 데이터베이스를 사용하세요.

궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요!

다음 단계

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.