Recent Posts
Recent Comments
반응형
«   2026/03   »
1 2 3 4 5 6 7
8 9 10 11 12 13 14
15 16 17 18 19 20 21
22 23 24 25 26 27 28
29 30 31
Archives
Today
Total
관리 메뉴

오늘도 공부

ClawFlows: OpenClaw 워크플로우 레이어 본문

AI

ClawFlows: OpenClaw 워크플로우 레이어

행복한 수지아빠 2026. 3. 23. 09:40
반응형

AI 에이전트 시대에 진짜 격차를 만드는 건 모델 그 자체가 아닙니다.
반복되는 일을 얼마나 구조화해서 자동으로 굴리느냐가 더 중요해지고 있습니다.

ClawFlows는 바로 그 지점을 찌릅니다. 채팅창에서 똑똑하게 답하는 에이전트를 넘어, 아침 브리핑을 보내고, 이메일을 정리하고, 다음 미팅 참석자를 조사하고, 밤에는 집안 모드를 바꾸는 식의 루틴을 “워크플로우”로 굳혀버립니다. 지금 OpenClaw가 주목받는 이유가 개인용 AI 비서라면, ClawFlows는 그 비서를 습관, 스케줄, 실행 규칙까지 가진 시스템으로 바꿔주는 프로젝트에 가깝습니다. (GitHub)

이 저장소를 자세히 보면, ClawFlows는 단순한 템플릿 모음이 아닙니다. OpenClaw 위에서 동작하는 선언형 자동화 계층입니다. 현재 README 기준으로 101개의 사전 구축 워크플로우를 제공하고, 설치 후에는 CLI로 활성화/비활성화/실행/업데이트/제출까지 관리할 수 있습니다. 스케줄은 WORKFLOW.md 안의 자연어 schedule 필드로 정의되고, 스케줄러는 15분마다 due 여부를 판단해 실행하며, 실행 이력도 파일 기반으로 기록합니다. (GitHub)

 

GitHub - nikilster/clawflows: ⚡️ Superpowers for your Openclaw. Powerful prebuilt agent workflows.

⚡️ Superpowers for your Openclaw. Powerful prebuilt agent workflows. - nikilster/clawflows

github.com

 


프로젝트 소개

ClawFlows는 Nikil Viswanathan의 nikilster 계정에서 공개된 오픈소스이며, Nikil Viswanathan은 Alchemy의 공동창업자 겸 CEO입니다. 저장소 설명은 “OpenClaw를 위한 강력한 워크플로우 시스템”이며, 이메일 처리, 모닝 브리핑, 스마트홈 제어, 미팅 준비 같은 자동화를 한 번에 붙일 수 있게 설계되어 있습니다. GitHub 저장소 구조를 보면 workflows, system, docs, community-submissions, tests가 나뉘어 있고, 언어 비중은 Shell 중심에 HTML과 JavaScript가 섞인 형태라서, 구현 자체도 거대한 프레임워크보다는 CLI + 설치 스크립트 + 대시보드 + 워크플로우 파일 조합으로 보는 게 맞습니다. (Alchemy)

핵심은 이것입니다.
OpenClaw가 “개인 AI 비서 런타임”이라면, ClawFlows는 그 위에 올리는 자동화 운영 레이어입니다. OpenClaw는 여러 채널과 도구를 연결해 개인 비서를 실행하는 플랫폼이고, ClawFlows는 그 비서에게 “아침 7시에 뭘 해야 하는지”, “회의 30분 전에 어떤 조사를 해야 하는지”, “이메일은 어떻게 분류해야 하는지”를 구조화된 워크플로우로 주입합니다. (GitHub)


왜 이 프로젝트가 등장했을까

에이전트를 실제로 써 본 사람은 금방 한계를 느낍니다.

처음에는 “내 이메일 정리해줘”, “오늘 일정 요약해줘”, “다음 회의 준비해줘” 같은 요청이 신기합니다. 그런데 이걸 매일 반복하다 보면 문제는 모델 성능이 아니라 지속성이 됩니다. 같은 일을 반복해서 시키면, 프롬프트가 흩어지고, 언제 실행할지 불명확하고, 어떤 순서로 처리할지도 매번 다시 설명해야 합니다. README가 ClawFlows의 장점으로 “scattered instructions across memory, heartbeat, and cron”을 없앤다고 강조하는 이유가 바로 여기 있습니다. 즉, 기존 방식은 에이전트가 똑똑해도 자동화 자체는 여전히 사람이 붙들고 있어야 했습니다. (GitHub)

ClawFlows는 이 문제를 프롬프트가 아니라 워크플로우 파일로 푸는 접근입니다. 자연어에 가까운 텍스트 문서 하나에 이름, 설명, 스케줄, 단계별 실행 규칙을 넣고, CLI와 스케줄러가 그 문서를 운영 가능한 자동화 단위로 바꿉니다. 개발자 관점에서 보면 “에이전트 행동을 코드처럼 버전 관리하고 재사용하는 방식”입니다. (GitHub)

이게 중요한 이유는 단순합니다.
에이전트 자동화는 결국 재현 가능성결정성이 있어야 합니다. ClawFlows는 그걸 YAML 프런트매터와 Markdown 기반 워크플로우 문서, 명시적인 스케줄, 실행 로그로 만듭니다. 즉 “대충 기억해서 알아서 해”가 아니라, “이 시간에 이 규칙으로 이 작업을 수행해”로 바꾸는 셈입니다. (GitHub)


ClawFlows가 제공하는 핵심 기능

1. 100개 이상의 사전 구축 워크플로우

현재 README 기준으로 ClawFlows는 101개의 사전 구축 워크플로우를 제공합니다. 카테고리도 꽤 넓습니다. Daily Routines, Health & Wellness, Communication, Work & Meetings, Dev Tools, Smart Home, Travel, Digital Hygiene 같은 범주가 나뉘어 있고, send-morning-briefing, process-email, prep-next-meeting, review-prs, check-dependencies, build-nightly-project 같은 이름만 봐도 실제 사용 시나리오가 선명합니다. (GitHub)

이 말은 곧, 처음부터 오토메이션을 설계하지 않아도 된다는 뜻입니다.
개발자는 “나한테 필요한 루틴”을 처음부터 설계하는 대신, 이미 있는 워크플로우를 활성화하고 조금 수정하는 쪽으로 시작할 수 있습니다. 이건 OpenClaw 도입 장벽을 크게 낮춥니다. 에이전트 플랫폼은 보통 세팅은 쉬워도 “그래서 뭘 자동화할 건데?”에서 막히는데, ClawFlows는 그 공백을 템플릿 라이브러리로 메웁니다. (GitHub)

2. 자연어 스케줄링

ClawFlows의 schedule은 전통적인 cron 표현식이 아닙니다. 문서상 "7am", "9am, 1pm, 5pm", "every 2 hours", "morning" 같은 표현을 지원하도록 설계되어 있습니다. 스케줄러 문서에는 현재 시간이 스케줄 시간과 일치하거나 15분 이내면 due로 판단한다고 적혀 있습니다. (GitHub)

이 방식은 비개발자에게도 친절하지만, 개발자 입장에서도 장점이 큽니다.
자동화의 목적이 복잡한 배치 처리보다 생활형 루틴 운영에 가까울 때, cron보다 자연어가 훨씬 읽기 쉽습니다. ClawFlows는 정확한 기계 표현보다는 “사람이 이해하고 수정하기 쉬운 일정 표현”에 무게를 둡니다. 즉, 인프라 자동화가 아니라 개인 비서 자동화에 최적화된 설계입니다. (GitHub)

3. Markdown 기반 선언형 워크플로우

워크플로우는 WORKFLOW.md 파일 하나로 정의됩니다. 필수 프런트매터는 name, emoji, description, author이고, schedule은 선택입니다. 이름 규칙도 check-*, send-*, process-*, build-*, sync-*, activate-*, track-*처럼 동사 중심으로 권장합니다. (GitHub)

이 포맷이 좋은 이유는 워크플로우가 문서이자 실행 규칙이기 때문입니다.
개발자에게는 코드리뷰가 쉬워지고, 에이전트에게는 지시문으로 읽히며, 커뮤니티에는 공유 포맷이 됩니다. JSON 스키마보다 사람이 읽기 쉽고, 단순 프롬프트보다 버전 관리가 쉽습니다. 그래서 ClawFlows는 “에이전트용 런북(runbook)”에 더 가깝습니다. (GitHub)

4. CLI 중심 운영

README에 나온 CLI만 봐도 운영 감각이 선명합니다. list, enable, disable, run, logs, validate, submit, update, sync-agent, backup, restore 같은 명령이 제공됩니다. 특히 enable 시 에이전트가 자동으로 해당 워크플로우를 알게 되고, 별도 재시작이 필요 없다고 설명합니다. (GitHub)

즉, 이 프로젝트는 단순 템플릿 저장소가 아닙니다.
워크플로우 배포와 운영까지 포함한 도구입니다. 활성화된 워크플로우 집합을 기준으로 개인 에이전트의 행동 범위를 관리하고, 업데이트도 pull 기반으로 가져가며, 커뮤니티 제출 흐름까지 CLI에 녹여둔 점이 꽤 인상적입니다. (GitHub)


실제로 어떻게 동작하나

저장소를 보면 구조는 꽤 단순합니다.

  1. OpenClaw가 개인 비서 런타임으로 깔려 있다.
  2. ClawFlows가 설치되면서 CLI, 스케줄러, 워크플로우 세트가 붙는다.
  3. 사용자는 일부 워크플로우를 enable 한다.
  4. 활성화된 워크플로우는 workflows/enabled/ 기준으로 관리된다.
  5. 스케줄러는 15분마다 해당 폴더를 읽고, schedule이 있는 워크플로우가 지금 due인지 판단한다.
  6. 실행 후에는 system/runs/YYYY-MM-DD/workflow-name/HH:MM 형식으로 이력을 남겨 중복 실행을 막는다. (GitHub)

이 구조는 놀라울 정도로 소박하지만, 그래서 오히려 강합니다.
DB에 복잡한 잡 상태를 저장하지도 않고, 거대한 워크플로우 엔진을 올리지도 않습니다. 파일 시스템을 상태 저장소로 쓰는 경량 오케스트레이션에 가깝습니다. 개인용 자동화에서는 이게 장점입니다. 디버깅이 쉽고, 무엇이 켜져 있고 언제 실행됐는지 눈으로 확인할 수 있기 때문입니다. 이 프로젝트가 “거대한 에이전트 플랫폼”이 아니라 “실용적인 자동화 레이어”라는 인상을 주는 이유도 여기에 있습니다. (GitHub)


워크플로우 포맷이 왜 중요한가

문서에 나온 예시를 보면, ClawFlows 워크플로우는 아래처럼 정의됩니다. 이 예시는 공식 문서 형식을 바탕으로 정리한 축약 버전입니다. (GitHub)

---
name: send-morning-briefing
emoji: ☀️
description: Daily morning briefing — gathers weather, calendar, priorities, and news into one summary.
author: nikilster @nikil
schedule: "7am"
---

# Morning Briefing

## What It Does
1. Check today's calendar
2. Get weather forecast
3. Summarize priorities
4. Deliver briefing

개발자 관점에서 이 포맷의 장점은 세 가지입니다.

첫째, 사람이 읽을 수 있습니다.
둘째, 에이전트가 그대로 실행 지침으로 해석할 수 있습니다.
셋째, Git으로 diff가 잘 보입니다.

이건 LangGraph나 Temporal 같은 강한 오케스트레이션 엔진과는 전혀 다른 철학입니다. 거기는 시스템 신뢰성과 분산 실행이 우선이고, ClawFlows는 개인용 반복업무를 빠르게 문서화하고 자동화하는 생산성이 우선입니다. (GitHub)


예시로 보는 대표 워크플로우

Morning Briefing

README와 문서 예시를 보면 send-morning-briefing은 날씨, 일정, 우선순위, 뉴스성 정보를 아침 7시에 정리해 전달하는 워크플로우입니다. 사용자가 눈 뜨기 전에 하루 컨텍스트를 미리 정리해준다는 발상이죠. (GitHub)

이 워크플로우가 상징적인 이유는, AI를 “질문하면 답하는 도구”가 아니라 하루를 선제적으로 구조화하는 운영자로 바꾸기 때문입니다. 단순 Q&A가 아니라 proactive computing입니다.

Process Email

process-email은 지난 12시간 또는 마지막 실행 이후 메일을 가져와서, 아카이브 가능한 노이즈와 FYI, 응답이 필요한 메일을 분류하고, 뉴스레터나 자동 알림을 정리하는 흐름으로 작성돼 있습니다. 공식 워크플로우 설명만 봐도 이 프로젝트가 현실적인 반복업무를 얼마나 강하게 겨냥하는지 드러납니다. (GitHub)

흥미로운 점은 이 워크플로우가 그냥 “메일 요약”이 아니라, 실제 운영 정책을 담고 있다는 것입니다. 어떤 메일을 노이즈로 볼지, 어떤 걸 응답 필요로 볼지, 자동 정리 범위를 어디까지 허용할지를 문서 수준에서 결정합니다. 이건 프롬프트 엔지니어링보다 업무 정책 자동화에 가깝습니다. (GitHub)

Prep Next Meeting

README 기준 prep-next-meeting은 30분마다 다음 미팅을 확인하고, 참석자 조사, 히스토리 확인, talking points 생성을 수행하는 흐름입니다. 사용자가 매번 “다음 회의 준비해줘”라고 말하지 않아도, 시스템이 미리 컨텍스트를 붙여줍니다. (GitHub)

이 패턴은 특히 직장인 개발자에게 강력합니다.
회의는 늘 반복되지만, 준비는 늘 수동입니다. ClawFlows는 여기를 “다음 미팅 전 자동 조사”로 바꿉니다. 즉, AI를 업무 도우미가 아니라 업무 준비 프로세스로 편입시키는 겁니다. (GitHub)


아키텍처적으로 인상적인 지점

1. 무겁지 않다

ClawFlows는 분산 시스템을 만들지 않습니다. 설치 스크립트가 repo clone, CLI 심링크, 스케줄러 세팅, 백업 복구, AGENTS.md 동기화를 수행하고, 주요 상태는 OpenClaw 워크스페이스와 ~/.local/bin 안에 머무르도록 설명합니다. (GitHub)

즉, 이 프로젝트는 “새로운 거대 플랫폼”이 아니라 기존 OpenClaw 위에 얹는 얇은 운영 레이어입니다. 그래서 개인 사용자나 파워유저가 빠르게 붙이기 좋습니다.

2. Agent-friendly 설계가 명확하다

문서 creating-workflows.md를 보면, 커스텀 워크플로우를 만들 때조차 사용자의 요구를 대화로 정리한 뒤 clawflows create --from-json으로 생성하게 되어 있습니다. 그리고 생성 후엔 WORKFLOW.md를 읽어 보여주고, 수정 요청이 있으면 파일 자체를 수정하도록 안내합니다. (GitHub)

이건 아주 중요한 신호입니다.
ClawFlows는 사람 개발자만 쓰는 도구가 아니라, 에이전트가 스스로 워크플로우를 생성·수정하는 시스템까지 염두에 둡니다. 즉, 워크플로우가 결과물이면서 동시에 에이전트와 인간 사이의 계약 문서 역할도 하는 셈입니다. (GitHub)

3. 커뮤니티 확장성이 좋다

기여 가이드는 create → run → submit 흐름을 강하게 밀고 있고, 제출된 워크플로우는 리뷰 후 커뮤니티 폴더로 이동됩니다. 프런트매터 규칙, 시크릿 플레이스홀더 문법, 구조 가이드까지 정의돼 있어 품질 관리도 어느 정도 체계화되어 있습니다. (GitHub)

이 구조 덕분에 ClawFlows는 템플릿 모음에서 끝나지 않고, 시간이 갈수록 개인 자동화 레시피 레지스트리로 커질 가능성이 있습니다.


개발자는 언제 쓰면 좋을까

이런 경우라면 꽤 잘 맞습니다

  • OpenClaw를 이미 쓰고 있고, 반복적인 개인 자동화를 빨리 붙이고 싶을 때
  • 이메일, 일정, 회의 준비, 리포트, 개발 루틴 같은 반복 패턴이 분명할 때
  • cron이나 별도 스크립트보다 읽기 쉬운 자동화 문서를 원할 때
  • 에이전트 행동을 버전 관리하고 커뮤니티 템플릿으로 재사용하고 싶을 때 (GitHub)

이런 경우에는 기대치를 조정해야 합니다

  • 복잡한 분산 잡 오케스트레이션이 필요한 팀 시스템
  • 강한 상태 보장, 리트라이 정책, 큐, 대규모 병렬 실행이 중요한 백엔드 워크플로우
  • SaaS 팀 전체가 함께 쓰는 기업용 BPM 도구 대체재를 찾는 경우

ClawFlows는 Temporal, Airflow, Dagster의 경쟁자가 아닙니다.
그보다는 개인용 에이전트 자동화의 운영 포맷에 가깝습니다. 강한 엔터프라이즈 오케스트레이션보다, “내 비서가 아침마다 무엇을 해야 하는가”를 관리하는 데 더 잘 맞습니다. 이 해석은 저장소 구조와 문서, 스케줄러 설계를 보면 꽤 명확합니다. (GitHub)


직접 써볼 때 감이 오는 명령들

README 기준으로 기본 흐름은 아래와 같습니다. (GitHub)

# 설치
curl -fsSL https://raw.githubusercontent.com/nikilster/clawflows/main/system/install.sh | bash

# 사용 가능한 워크플로우 보기
clawflows list available

# 원하는 워크플로우 활성화
clawflows enable send-morning-briefing
clawflows enable process-email
clawflows enable prep-next-meeting

# 즉시 실행
clawflows run send-morning-briefing

# 최근 실행 로그 보기
clawflows logs

# 최신 워크플로우 가져오기
clawflows update

여기서 포인트는 명령어 자체가 아닙니다.
이 명령 몇 개만으로, OpenClaw가 대화형 비서 → 루틴 자동화 비서로 바뀐다는 점이 중요합니다.


커스텀 워크플로우 예시

공식 문서의 create --from-json 예시를 바탕으로, 개발자용으로 응용하면 이런 흐름을 만들 수 있습니다. (GitHub)

clawflows create --from-json '{
  "name": "review-my-priority-prs",
  "emoji": "🔍",
  "summary": "중요 PR 상태를 매일 점검",
  "schedule": "9am, 4pm",
  "description": "GitHub에서 내가 지정한 저장소의 주요 PR을 확인하고, 리뷰 대기, CI 실패, 머지 가능 여부를 요약해준다."
}'

이런 식으로 만들면, 단순히 “PR 상태 좀 봐줘”가 아니라
매일 두 번 자동으로 점검되는 나만의 개발 운영 루틴이 됩니다.


이 프로젝트를 한 줄로 정리하면

ClawFlows는 OpenClaw 위에 얹는 템플릿 세트가 아닙니다.
개인 에이전트를 반복 가능한 운영 시스템으로 바꾸는 선언형 워크플로우 레이어입니다. (GitHub)

이 프로젝트가 재미있는 이유는 AI가 더 똑똑해졌기 때문이 아니라,
이제 AI를 내 생활과 업무를 굴리는 스케줄러로 취급하기 시작했기 때문입니다.

앞으로 에이전트 생태계에서 진짜 중요한 건 모델 비교표보다 이런 것입니다.

  • 어떤 루틴을 자동화할 수 있는가
  • 그 자동화를 얼마나 쉽게 수정하고 공유할 수 있는가
  • 에이전트 행동을 얼마나 운영 가능한 형태로 고정할 수 있는가

그 관점에서 ClawFlows는 꽤 영리합니다.
OpenClaw의 가능성을 “대화”에서 “자동 운영”으로 한 단계 밀어 올리는 프로젝트이기 때문입니다. (GitHub)

반응형