오픈클로 에이전트 구현

Outcome (완료 조건)

Lesson 01~20 학습 내용을 바탕으로 OpenClaw 프레임워크 스타일의 Claude 에이전트 로컬 구동 완성.

워크스페이스 7종 파일 (SOUL / AGENTS / MEMORY / TOOLS / HEARTBEAT / USER / IDENTITY) 작성 완료

하트비트 크론잡 동작 확인 (매 시간 또는 테스트 주기)

Slack 또는 텔레그램 채널 자동 응답 1건 이상 실증

Why This Project

뽀짝이 서재 20개 레슨 시리즈(bbojjak-openclaw-agentic-architecture-lesson01 ~ Lesson 20) 학습을 실제 구현으로 검증. AX 전임교수 준비를 위한 Agentic AI 실습 포트폴리오 구축 — “가르칠 수 있는 형태”로 만들기 위해 직접 손으로 구현해본다. (출처: OpenClaw, agent-runtime-architecture)

Context

OpenClaw 프레임워크는 LLM(두뇌) + OpenClaw(몸) 구조로 실제 동작하는 에이전트를 구현한다. Claude 모델이 생각을 담당하고, OpenClaw는 메시지 전달·도구 연결·스케줄링·채널 관리·세션 관리를 담당. 워크스페이스 파일 7종이 에이전트의 정체성·규칙·기억·도구·루틴을 완전 정의한다.

Knowledge Pulls

이 프로젝트가 소환하는 위키 지식

Project → Zettel 단방향. 아래 페이지는 이 프로젝트를 모름 (역링크 추가 금지).

Concepts

agent-runtime-architecture

소환 이유: OpenClaw 런타임 전체 레이어 구조도 — 구현의 골격
활용 지점: Phase 2 런타임 연동 시 아키텍처 기준 참조

heartbeat-mechanism

소환 이유: 매 시간 크론잡으로 에이전트를 능동화하는 핵심 패턴
활용 지점: Phase 2 하트비트 크론잡 구현 시 설계 기준

harness-engineering

소환 이유: CLAUDE.md 하네스 = OpenClaw 워크스페이스 파일의 동등 개념
활용 지점: 워크스페이스 7종 파일 작성 시 하네스 레이어 매핑 참조

agent-workspace-structure

소환 이유: 워크스페이스 7종 파일(SOUL/AGENTS/MEMORY/TOOLS/HEARTBEAT/USER/IDENTITY) 구조 상세
활용 지점: Phase 1 워크스페이스 파일 초안 작성 시 직접 참조

agentic-webhook-integration

소환 이유: hooks/transform 웹훅 파이프라인 패턴 일반화
활용 지점: Phase 3 채널 연결 시 웹훅 설정 기준

agent-session-architecture

소환 이유: 세션(.jsonl) 관리 · 채널 라우팅 · 컴팩션 구조
활용 지점: 세션 설계 및 채널 바인딩 구현 시 참조

multi-agent-team-design

소환 이유: 뽀야-뽀짝이 멀티에이전트 팀 설계 패턴
활용 지점: 에이전트 확장(2개 이상) 시 워크스페이스 분리 설계 참조

agent-error-learning-loop

소환 이유: AGENTS.md 절대 규칙 작성 · 에러에서 규칙 추출하는 학습 루프
활용 지점: AGENTS.md 초안 작성 및 운영 중 규칙 업데이트 기준

agent-memory-architecture

소환 이유: MEMORY.md 장기 기억 설계 · Full-context · Prompt Caching 3단계
활용 지점: MEMORY.md 구조 설계 및 세션 간 기억 복원 구현

agentic-scheduling-design

소환 이유: 하트비트 vs 크론잡 선택 기준 · 스케줄링 3가지 사고
활용 지점: HEARTBEAT.md 시간표 작성 및 크론잡 스케줄 설정

agent-skill-design

소환 이유: SKILL.md 작성 기준 · n8n→스킬 전환 패턴
활용 지점: TOOLS.md 및 스킬 파일 작성 시 설계 참조

automation-layer-framework

소환 이유: exec · 자동화 3계층 · exec-approvals · Trust but verify 원칙
활용 지점: 에이전트 자동 실행 허용 범위 결정 시 기준

subagent-orchestration

소환 이유: sessions_spawn · 맥락의 격차 · 판단 최소화 원칙
활용 지점: 서브에이전트 분기 구현 시 참조

gateway-architecture

소환 이유: Gateway 설정(openclaw.json) · 멀티채널 라우팅 · Tailscale Funnel
활용 지점: Phase 2 OpenClaw Gateway 설정 시 직접 참조

multichannel-session-management

소환 이유: Slack 스레드 · 텔레그램 토픽 세션 분리 · DM 함정 · bindings
활용 지점: Phase 3 Slack/텔레그램 채널 연결 시 세션 바인딩 설정

agent-token-optimization

소환 이유: 토큰 소비처 5순위 · RTK · Sonnet 전환 기준 · 34% 절감 실증
활용 지점: 운영 비용 최적화 설정 시 참조

agent-security-design

소환 이유: 프롬프트 인젝션 방어 · 보안 3원칙 · 에이전트 분리 · 심층 방어
활용 지점: 워크스페이스 보안 설정 4종 구현 시 참조

agent-skill-ecosystem-trust

소환 이유: 외부 스킬 도입 3단계 신뢰 평가 · 구조>스킬 원칙
활용 지점: 외부 스킬/MCP 도입 의사결정 기준

agent-resilience-design

소환 이유: Model Failover · 세션 스티킨스 · Agent Loop · 작업별 모델 분리
활용 지점: 운영 중 장애 대응 설계 참조

agent-information-boundary

소환 이유: 멀티 워크스페이스 분리 이후 운영 · 일방향 동기화 · 오탐 관리
활용 지점: 2개 이상 에이전트 운영 시 정보 경계 설계

playwright-html-to-image

소환 이유: browser 도구(openclaw/chrome 프로필) · HTML→PNG 파이프라인
활용 지점: 이미지 카드 생성 등 시각 출력 기능 구현 시 참조

agent-identity-design

소환 이유: SOUL.md 5가지 구성요소 (성격·말투·행동·금지·목적)
활용 지점: SOUL.md 초안 작성 시 직접 참조

Sources

bbojjak-openclaw-agentic-architecture-lesson01

소환 이유: 아키텍처 전체 개요 · 워크스페이스 7종 첫 소개 · 하트비트 메커니즘 원리
활용 지점: 프로젝트 전체 설계 기준 — 가장 먼저 읽는 소스

bbojjak-openclaw-soul-md-lesson02

소환 이유: SOUL.md 5가지 구성요소 심화 — 성격·말투·행동방식·금지사항·목적
활용 지점: Phase 1 SOUL.md 초안 작성 시 직접 참조

bbojjak-openclaw-webhook-pipeline-lesson03

소환 이유: hooks/transform 웹훅 자동답변 파이프라인 상세 구현
활용 지점: Phase 3 웹훅 이벤트 수신 설정 시 참조

bbojjak-openclaw-multi-agent-team-lesson04

소환 이유: 멀티에이전트 팀 역할 분리 · 워크스페이스 독립 실행 패턴
활용 지점: 에이전트 2개 이상 운영 시 팀 설계 참조

bbojjak-openclaw-agents-error-learning-lesson05

소환 이유: AGENTS.md 절대 규칙 작성법 · 오류에서 규칙을 추출하는 학습 루프
활용 지점: Phase 1 AGENTS.md 초안 작성 및 운영 중 규칙 업데이트

bbojjak-openclaw-session-architecture-lesson06

소환 이유: 세션(.jsonl) 구조 · 채널별 세션 바인딩 · 컴팩션 트리거
활용 지점: 세션 설계 및 채널 라우팅 구현 시 참조

bbojjak-openclaw-runtime-architecture-lesson07

소환 이유: 터미널(Claude Code) vs 런타임(OpenClaw) 아키텍처 비교 — F1 vs 자율주행 비유
활용 지점: Phase 2 런타임 연동의 핵심 설계도

bbojjak-openclaw-memory-architecture-lesson08

소환 이유: 기억 3단계(세션·MEMORY.md·memory/ 폴더) · Full-context · Prompt Caching
활용 지점: Phase 1 MEMORY.md 구조 설계 시 참조

bbojjak-openclaw-scheduling-design-lesson09

소환 이유: 하트비트 vs 크론잡 선택 기준 · 3가지 스케줄링 사고방식
활용 지점: Phase 2 HEARTBEAT.md 시간표 작성 및 크론잡 주기 설정

bbojjak-openclaw-skill-design-lesson10

소환 이유: 에이전트 스킬 시스템 · SKILL.md 작성법 · n8n→스킬 전환 패턴
활용 지점: Phase 1 TOOLS.md 및 스킬 파일 설계

bbojjak-openclaw-automation-layers-lesson11

소환 이유: exec · 자동화 3계층 · exec-approvals 설정 · Trust but verify
활용 지점: 자동 실행 허용 범위 및 승인 정책 결정

bbojjak-openclaw-subagent-orchestration-lesson12

소환 이유: sessions_spawn API · 맥락의 격차 · 판단 최소화 원칙
활용 지점: 서브에이전트 분기 기능 구현 시 참조

bbojjak-openclaw-playwright-image-pipeline-lesson13

소환 이유: browser 도구 2가지 프로필(openclaw/chrome) · HTML→PNG capture-cards.ts
활용 지점: 이미지 카드 자동 생성 기능 구현 시 참조

bbojjak-openclaw-gateway-architecture-lesson14

소환 이유: Gateway 설정(openclaw.json) · 멀티채널 라우팅 · Tailscale Funnel · 보안 4중 잠금
활용 지점: Phase 2 Gateway 설정 파일 작성 시 핵심 참조

bbojjak-openclaw-multichannel-session-lesson15

소환 이유: Slack 스레드 · 텔레그램 토픽 세션 분리 · DM 함정 · bindings 설정
활용 지점: Phase 3 Slack/텔레그램 채널 연결 및 세션 바인딩 구현

bbojjak-openclaw-token-optimization-lesson16

소환 이유: 토큰 소비처 5순위 · RTK · hook vs 지침 · 능동적 compact · Sonnet 전환
활용 지점: 운영 비용 절감 설정 — 특히 Sonnet 3.5 전환 기준

bbojjak-openclaw-agent-security-lesson17

소환 이유: 프롬프트 인젝션 공격 유형 · 보안 3원칙 · 에이전트 분리 · 심층 방어 4단계
활용 지점: 보안 설정 4종 구현 및 입력 검증 로직

bbojjak-openclaw-skill-ecosystem-lesson18

소환 이유: 보안 스킬 선택 3단계 · 구조>스킬 원칙 · 즉시 학습+SSOT · 오픈 생태계 신뢰 평가
활용 지점: 외부 스킬/MCP 도입 시 신뢰 평가 기준

bbojjak-openclaw-resilience-failover-lesson19

소환 이유: Model Failover 설정 · 세션 스티킨스 · Agent Loop · 34% 비용 절감 실증
활용 지점: 운영 안정성 설계 및 장애 대응 구현

bbojjak-openclaw-information-boundary-lesson20

소환 이유: 분리 이후 운영 · 일방향 동기화 · 민감정보 추출 방어 · 에스컬레이션 · 오탐 관리
활용 지점: 멀티 워크스페이스 운영 시 정보 경계 설계

openclaw-github-readme

소환 이유: 공식 GitHub 저장소 README — 설치 명령어(npm install -g openclaw@latest + openclaw onboard --install-daemon), 실제 스킬 경로(~/.openclaw/workspace/skills/), DM 페어링 보안 기본값, 365K stars 채택 지표
활용 지점: Phase 2 로컬 설치 시 직접 참조 — Next Action “OpenClaw 프레임워크 GitHub 레포 탐색 및 로컬 설치 방법 확인” 달성

Entities

OpenClaw

소환 이유: 프레임워크 본체 · hooks/transform · browser 도구 · Gateway 아키텍처 · Contradiction(동명이인) 정리
활용 지점: 구현 전 프레임워크 전체 기능 파악 및 동명이인 혼동 방지

Plan

gantt
    title 오픈클로 에이전트 구현 단계
    dateFormat  YYYY-MM-DD
    axisFormat  %m/%d
    section Phase 1 — 기반 구조
    워크스페이스 7종 파일 작성      :a1, 2026-04-28, 7d
    section Phase 2 — 런타임 연동
    OpenClaw 로컬 설치 및 설정      :b1, after a1, 7d
    하트비트 크론잡 동작 확인        :b2, after b1, 3d
    section Phase 3 — 채널 연결
    Slack/텔레그램 자동 응답 실증    :c1, after b2, 7d

Progress

(진행 시 /project update openclaw-agent-implementation으로 기록)

Next Actions

Actions

Lesson 01~07 복습 — 아키텍처·SOUL.md·웹훅·멀티에이전트·에러학습·세션·런타임 핵심 정리

Lesson 08~14 복습 — 메모리·스케줄링·스킬·자동화 계층·서브에이전트·Playwright·Gateway

Lesson 15~20 복습 — 멀티채널 세션·토큰 최적화·보안·스킬 생태계·Failover·정보 경계

OpenClaw 프레임워크 GitHub 레포 탐색 및 로컬 설치 방법 확인

워크스페이스 7종 파일 초안 작성 (SOUL.md 먼저)

하트비트 크론잡 설정 및 테스트 실행

Slack 또는 텔레그램 채널 연결 및 자동 응답 1건 실증

Risks

식별된 리스크

R1 (Major): OpenClaw 오픈소스 프레임워크 실제 설치·운영 문서가 불충분할 수 있음 → 대응: 뽀짝이 서재 레슨에서 언급된 설정 파일(openclaw.json) 구조를 역공학으로 파악

R2 (Minor): Lesson 시리즈가 실제 코드보다 개념 설명 위주일 수 있음 → 대응: Claude Code + Claude API로 직접 구현 대안 병행 검토

R3 (Minor): Slack/텔레그램 채널 설정에 별도 Bot Token 발급 필요 → 대응: 테스트용 개인 워크스페이스 사용

Artifacts

산출물

(구현 완료 후 기록)

Retrospective

Close 시 필수 채움 (비어있으면 close 차단)

무엇이 잘 됐나: …

무엇이 예상과 달랐나: …

다음 프로젝트에 이어갈 것: …

새로 생긴 concepts/sources/insights:

(close 시 채움)

lecture-planning-2026 — AX 전임교수 준비 — 이 구현 결과가 강의 실습 자료로 활용될 수 있음

탐색기

오픈클로 에이전트 구현

오픈클로 에이전트 구현

Context

Knowledge Pulls

Concepts

Sources

Entities

Plan

Progress

Next Actions

Risks

Artifacts

Retrospective

Related Projects

그래프 뷰

목차

백링크