차은별 워크스페이스 전체 구조
에이전트가 실제로 일하는 공간은 서버의 ~/.openclaw/workspace-chaeunbyul/ 폴더입니다. 이 폴더 안에 에이전트의 두뇌, 작업 공간, 출력물, 기억이 모두 들어있습니다.
구조는 다음과 같습니다.
~/.openclaw/workspace-chaeunbyul/
├── SOUL.md
├── AGENTS.md
├── USER.md
├── TOOLS.md
├── SKILLS.md
├── HEARTBEAT.md
├── IDENTITY.md
├── MEMORY.md
├── chaeunbyul-engine/
│ ├── templates/
│ ├── scripts/
│ │ ├── render.js
│ │ └── generate-samples.js
│ ├── workspace/
│ ├── output/
│ ├── config.json
│ └── CLAUDE.md
├── memory/
│ └── MEMORY.md
├── context/
│ └── style-guide.md
├── artifacts/
│ ├── drafts/
│ └── final/
├── outbox/
└── logs/
이 구조가 왜 이렇게 나뉘어 있는지, 각각 무슨 역할을 하는지 하나씩 설명합니다.
루트 MD 파일 — 에이전트의 두뇌
워크스페이스 최상위에 있는 .md 파일들은 에이전트가 매 대화마다 참조하는 시스템 컨텍스트입니다. 에이전트는 세션 컨텍스트와 규칙에 따라 일부 파일을 참조합니다. 파일 로딩 범위는 환경/세션/보안 정책에 따라 달라질 수 있습니다.
SOUL.md — 에이전트의 핵심 정체성과 규칙 파일입니다. 차은별이 무엇을 하는 존재인지, 어떤 순서로 작업하는지, 어떤 것은 절대 하지 않는지가 여기에 들어있습니다. 모든 파일 중 가장 중요하고, 100줄 이내로 유지해야 합니다. 이 파일이 에이전트의 행동 방식 전체를 결정합니다.
USER.md — 운영자인 리도에 대한 정보가 담겨있습니다. 호칭, 콘텐츠 선호 방향, 보고 스타일, 주제별 가이드라인이 들어있습니다. 에이전트가 카피 방향을 잡거나 피드백을 해석할 때 이 파일을 참조합니다.
IDENTITY.md — 차은별의 말투, 분위기, 이모지 사용 기준, 상황별 응답 패턴을 정의합니다. 이 파일이 없으면 에이전트는 차은별이 아닌 그냥 AI로 말합니다.
AGENTS.md — 이 워크스페이스의 운영 규칙/작업 원칙 문서입니다. 윤서아, 김도윤 등 다른 에이전트와의 협업 정보(역할 분담, 요청 방법)는 별도 섹션으로 분리해 관리합니다.
TOOLS.md — 이 프로젝트의 로컬 운영 메모(별칭, 사용 팁, 환경 노트)입니다. 실제 도구 권한은 런타임 정책에서 결정됩니다. 렌더링 스크립트, 웹 검색, 파일 읽기/쓰기 등 허용된 도구와 사용 방법이 명시되어 있습니다.
SKILLS.md — 스킬은 런타임/설치 환경에서 관리되며, 이 문서에서는 프로젝트에서 주로 쓰는 스킬만 운영 관점으로 정리합니다. chaeunbyul-engine 렌더링 스킬이 어떤 인풋을 받고 어떤 아웃풋을 내는지 기술되어 있습니다.
HEARTBEAT.md — OpenClaw가 주기적으로 실행하는 자율 작업을 정의합니다. 에이전트가 사람의 요청 없이도 스스로 해야 할 일(예: 매일 아침 오늘 주제 후보 3개 제안)이 여기에 들어있습니다.
MEMORY.md — 이 프로젝트에서는 루트 MEMORY.md를 장기 기억 요약으로 사용하고, 상세 기록은 memory/ 하위 파일에 분리해 관리합니다. 어떤 날짜에 어떤 내용이 기록됐는지 목차 역할을 합니다.
chaeunbyul-engine/ — 카드뉴스 렌더링 엔진
instagram-card-news 오픈소스를 클론한 폴더입니다. 텍스트 데이터를 받아서 실제 PNG 이미지를 만들어내는 역할을 합니다.
templates/ — 8종의 HTML 카드뉴스 템플릿이 들어있습니다. 프리미엄, 미니멀, 다크, 그라디언트 등 스타일별로 나뉩니다. slides.json에서 어떤 템플릿을 쓸지 지정할 수 있습니다.
scripts/render.js — Puppeteer를 사용해 HTML 템플릿을 PNG로 변환하는 핵심 렌더러입니다. 이 스크립트가 실행되면 헤드리스 Chromium이 HTML을 화면에 그리고 스크린샷으로 저장합니다.
scripts/generate-samples.js — 설치 후 렌더링이 정상 동작하는지 확인할 때 쓰는 테스트 스크립트입니다.
workspace/ — 차은별이 작성한 slides.json 파일이 저장되는 작업 공간입니다. 에이전트가 주제를 받아 슬라이드 데이터를 완성하면 이 폴더에 저장하고 렌더러를 호출합니다.
output/ — 렌더링이 완료된 PNG 파일이 저장되는 폴더입니다. slide_01.png부터 순서대로 출력됩니다.
config.json — 렌더링 기본 설정값이 들어있습니다. 이미지 크기, 기본 템플릿, 폰트 경로 등이 여기서 지정됩니다.
CLAUDE.md — 이 엔진 폴더 안에서 AI가 작업할 때 참고하는 규칙 파일입니다. 스크립트 수정이나 템플릿 편집 시 따라야 할 방식이 적혀있습니다.
나머지 폴더 — 기억, 스타일, 출력, 로그
memory/ — 에이전트의 장기 기억 공간입니다. 성공한 카피, 잘 먹힌 후킹 문구, 리도의 피드백이 날짜별 .md 파일로 쌓입니다. 작업이 반복될수록 이 폴더가 차은별의 경험치가 됩니다.
context/style-guide.md — 리도 인사이트 계정의 콘텐츠 스타일 가이드입니다. 색상, 폰트, 카피 톤, 계정 정체성 등 일관성을 유지하기 위한 기준이 담겨있습니다. 에이전트가 새 카드뉴스를 만들 때 이 파일을 참고해서 기존 피드와 통일감을 맞춥니다.
artifacts/drafts/ — 초안 단계의 slides.json과 중간 결과물이 저장됩니다. 검토 전 상태의 파일들이 여기에 임시 보관됩니다.
artifacts/final/ — 시각 검토를 통과한 최종 카드뉴스 세트가 저장됩니다. 발행 전 확인용 공간입니다.
outbox/ — Windows 서버의 윤서아(이미지 생성 에이전트)에게 전달할 파일을 여기 놓습니다. 실사 이미지나 일러스트가 필요한 경우 이 폴더를 통해 요청과 결과물이 오갑니다.
logs/ — OpenClaw 게이트웨이와 에이전트 실행 로그가 쌓이는 폴더입니다. 에이전트가 응답하지 않거나 렌더링이 실패했을 때 여기서 원인을 찾습니다.
