[OpenClaw] 봇의 기억 파일도 링크로 이어진 DB였어요 — 워크스페이스를 관계형 표로 그려 보기
2026.10.13
![[OpenClaw] 봇의 기억 파일도 링크로 이어진 DB였어요 — 워크스페이스를 관계형 표로 그려 보기 본문 이미지](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Ff6ed027f9e8a948b24a97545.jpg&w=3840&q=75)
📝 한줄 요약
2주차 DB 수업 후 제 봇 "댕댕이"의 워크스페이스를 관계형 DB로 번역했습니다. 연결을 따라 관계도를 그리고, 공식 문서로 구조를 공부하고, md와 진짜 DB의 차이도 비교했습니다.
바쁘시면 이것만 읽어도 돼요:
깨달은 점: 기억 파일 9종 = 테이블 목록, 파일 안의
경로= 링크 칸(외래키)연결 구조: 규칙·색인(AGENTS.md, MEMORY.md)이 일지·교훈·메모장을 위에서 아래로 가리켜요
워크스페이스: 자동으로 읽히는 파일은 개인 대화 기준 최대 5개, 일지는 검색으로 꺼내요. 그래서 "경로를 어디에 적느냐"가 중요해요
md의 한계: 형식·중복·끊긴 링크를 못 막아요(작업 기록 35줄에 형식 3가지)
실습: 연결을 그려 보는 프롬프트가 맨 아래에 있어요
🎯 이런 분들께 도움돼요
봇에게 "기억해"라고 했는데 다음 날 모르는 경험을 해 본 분
워크스페이스 md 파일이 서로 어떻게 이어지는지 모르겠는 분
DB 수업의 "링크 칸·1:N·N:M"을 내 일에서 찾아보고 싶은 분
😫 문제 상황 (Before)
OpenClaw 봇은 세션이 바뀌면 처음부터 깨어나요. 공식 문서도 "모델은 디스크에 저장된 것만 기억한다, 숨은 상태는 없다"고 해요
그래서 1주차에 기억을 9개 층으로 나눴어요: 규칙, 정체성, 주인, 현재 상태, 일지, 교훈, 지식, 상태 기록, 산출물
하지만 층끼리 어떻게 이어지는지, 이름을 바꾸면 어디가 깨지는지는 몰랐어요. 그래서 새 표 대신 이 파일들을 DB로 번역해 보기로 했어요
🛠️ 사용한 도구
도구명: OpenClaw 봇 "댕댕이" + 공식 문서 + 자체 대시보드
모델: Claude Opus
대상: 봇 워크스페이스의 md·JSON·로그 파일
특이사항: DB 프로그램은 안 썼어요. 글에는 구조와 숫자만 옮겼고 예시 내용은 만든 예시예요. 문서로 확인 못 한 건 "가설"로 표시했어요.
🔧 작업 과정
1. 먼저 공식 문서로 워크스페이스부터 공부했다
봇에게 공식 문서(워크스페이스, 메모리, SOUL, 시스템 프롬프트, 사용자 모델 문서)를 정리시켰습니다.
자동으로 읽히는 파일 (문서 기준)
파일 | 역할 | 비고 |
|---|---|---|
| 운영 규칙, 기억 쓰는 법 | 서브에이전트도 이 파일만은 받아요 |
| 성격·말투·경계 | |
| 이름·분위기·이모지 | |
| 주인 선호(지시문) | 4,000자 예산이 따로 있어요 |
| 오래 갈 사실·결정·짧은 요약 | 있을 때만. 개인 본 세션에서만 넣고, 그룹·채널·크론·서브에이전트 세션에서는 빼요 |
| 첫 실행 의식 | 새 워크스페이스에서만 |
글자 예산 (문서 기준 기본값)
파일 하나당 20,000자, 합쳐서 60,000자. 넘으면 프롬프트에 넣는 사본만 잘라요(디스크 파일은 그대로)
MEMORY.md가 자주 잘리면 "줄이고 자세한 건 일지로"가 문서의 권장이에요
우리 파일 5개는 합쳐 14,881자. 제일 긴 AGENTS.md가 7,810자(142줄)라 아직 예산 안이에요
매번 읽히지 않는 것
memory/YYYY-MM-DD.md일지: 기억 검색 도구(memory_search,memory_get)로 꺼내요./new·/reset직후 첫 턴에는 최근 일지가 붙을 수 있어요검색은 MEMORY.md, USER.md,
memory/일지를 봇별 SQLite DB에 색인해요. md는 원본, 찾기는 진짜 DB가 해요skills/: 같은 이름의 스킬이면 워크스페이스 것이 제일 우선이에요
핵심 발견: learnings/(교훈), knowledge/(지식)는 검색 범위 밖이고 넓히는 설정도 없었어요. 그래서 자동으로 읽히는 파일의 경로를 따라가는 것이 가장 확실한 길이라고 봤어요(가설: 봇이 폴더를 직접 열 수도 있어서 유일한 길은 아니에요).
2. 기억 체계 표 = 테이블 목록
AGENTS.md의 "기억 체계" 표에 레코드와 기본키를 붙여 봤습니다.
층 (테이블) | 파일 | 레코드 1개 = | 구분하는 키 |
|---|---|---|---|
규칙 |
| 규칙 1개 | 규칙 번호 (핵심 규칙 1~10) |
정체성 |
| 설정 1줄 | 항목 이름 (Name, Emoji…) |
주인 |
| 지시문 1개 | 관찰일 + 상태(active/superseded) 메모 |
현재 상태 |
| 진행 중 일·결정·포인터 1줄 | 없음 (목차 역할) |
일지 |
| 작업 1건 ( | 날짜(파일명) + 시각(제목) |
교훈 |
| 교훈 1건 = 파일 1개 | 파일 이름 |
지식 |
| 주제 1개 = 파일 1개 | 파일 이름 |
상태 기록 |
| 보낸 경보 1건 / 작업 1줄 | 사건 ID / 시각 |
스킬 메모 |
| 스킬 1개의 우리 집 사용법 | 스킬 이름 |
산출물 |
| 프로젝트 1개 | 폴더 이름 |
DB 용어와 딱 맞은 것
일지 파일명
2026-10-01.md= 날짜 기본키,## 10:00 회의 준비= 작업 한 건, "날짜 + 시각" = 복합키. 10/13 오전 기준 일지 10개에##제목 59개, 그중 55개가 시각으로 시작일지 칸 = 스키마: "한 일"·"확인" 48번씩, "요청" 22번, "결정" 19번, "파일" 7번(빈 칸은 생략 가능)
USER.md
observed: 날짜 | status: active= 상태 칸: 바뀐 선호는 지우지 않고superseded로 바꿔요(문서 기준). 지시문 6개 모두 activestate/actions.log= 이력 테이블: 덧붙이기만 해요(append-only). 시각 / 동작 / 대상 / 근거 / 결과learnings/1건 1파일 = 레코드: 지금 4건(README 제외)
3. 경로 = 링크 칸. 실제로 누가 누구를 가리키나
봇에게 코드로 감싼 경로를 전부 뽑아 연결을 그리게 했습니다(실제로 확인한 연결만).
AGENTS.md (규칙)
├─→ SOUL.md / USER.md / MEMORY.md 첫 줄: "정체성은 여기, 주인은 여기, 현재 상태는 여기"
├─→ memory/YYYY-MM-DD.md "오늘·어제 일지를 확인한다" (패턴으로 가리킴)
├─→ learnings/ 개별 파일 2개 규칙 옆 "근거: 이 교훈 파일"
├─→ skill-notes/<스킬명>.md "스킬 쓰기 전에 메모장부터 읽는다"
└─→ state/reported.json "보낸 경보는 여기에 기록"
MEMORY.md (목차)
└─→ learnings 1개, knowledge 1개, 일지 1개, state 파일, RESEARCH 폴더, 대시보드 코드 폴더
memory/날짜.md (일지)
└─→ RESEARCH 폴더 (일지 4개에서), learnings (일지 2개에서), skill-notes (일지 3개에서)
learnings/교훈.md ─→ AGENTS.md (교훈 4개 중 2개가 "적용" 칸에 AGENTS 규칙을 적어 둠)
skill-notes/<스킬명>.md ─→ skills/<스킬명>/, knowledge/ 파일
워크스페이스 파일 연결도: 위는 자동으로 읽히는 파일, 아래는 필요할 때 여는 파일, 화살표 = 경로로 가리킴
관계형 DB의 관계가 다 있었어요
관계 | 예 | 메모 |
|---|---|---|
1:N | 일지 1개 : 작업 기록 N개 | 파일 하나에 |
1:N 구조 | 규칙 1개 : 근거 교훈 N개 | 지금은 규칙마다 1개씩만 |
1:1 | 스킬 1개 : 메모장 1개 |
|
N:M | 일지 : 산출물 | 일지 하나가 폴더 2개를, 폴더 하나를 일지 2개가 가리킴 |
1:1 메모장 = 확장 표: 받은 스킬은 업데이트 때 통째로 바뀌어서, 우리 방식은 옆 메모장에 적어요
N:M은 연결표 대신 경로 한 줄: 한 방향뿐이라 산출물 쪽에선 역추적이 안 돼요
방향은 위 → 아래: 자동으로 읽히는 파일이 목차가 되어야 봇이 아래를 찾아가요
4. "정보는 한 곳에만, 다른 곳은 경로만" = 정규화와 외래키
AGENTS.md에는 이런 규칙이 있습니다.
같은 정보를 두 곳에 쓰지 않는다. 다른 곳에서는 경로만 참조한다.
DB 용어로 정규화예요. 고객 주소를 고객표에 한 번만 두는 것과 같아요.
AGENTS.md: "정체성·말투는 SOUL.md, 주인 정보는 USER.md, 현재 상태는 MEMORY.md. 이 파일은 규칙만"
MEMORY.md: 내용 대신 경로만(예: "경보 기록:
state/reported.json") = DB의 인덱스교훈·스킬 메모장 폴더 설명도 "정본은 한 곳, 여기는 경로만"
끊긴 링크 검사 (참조 무결성)
md는 없는 대상을 막지 못해서, 봇에게 경로가 실제로 있는지 확인시켰습니다.
처음 검사(경로 64개): 없는 건 패턴 표기,
...줄임, 워크스페이스 밖 경로뿐검증 봇이 기준을 넓히자 진짜 끊긴 링크 발견: 옛 일지가 휴지통으로 옮긴 백업 파일을 가리켰어요
배운 점: 기준에 따라 숫자가 달라지고, 줄인 경로는 기계가 못 따라가요
5. md 파일은 DB와 뭐가 다를까
md 파일이 좋은 점
사람도 봇도 변환 없이 바로 읽고 고쳐요. 표·목록·
경로로 구조도 꽤 표현해요git으로 변경 이력을 남길 수 있어요. 공식 문서도 비공개 git 저장소 백업을 권해요
DB와 달리 없는 것
항목 | DB | md 파일 |
|---|---|---|
칸 형식(타입) | 날짜 칸에 글자를 넣으면 막아요 | 아무거나 들어가요 |
중복 방지 | 같은 키를 두 번 못 넣어요 | 두 파일에 써도 몰라요 |
참조 무결성 | 없는 대상을 가리키면 막아요 | 이름을 바꾸면 경로가 조용히 끊겨요 |
동시 수정 | 잠금으로 순서를 지켜요 | 나중 저장이 앞의 것을 덮어요 |
실제로 흐트러진 형식
state/actions.log35줄: 탭 19줄,|12줄, 띄어쓰기 4줄. 형식 3가지learnings/4건: 정해 둔 형식(상황/실수/교정/적용)을 따른 건 2건. 1건은 제목(##)으로, 1건은 "실수" 대신 "원인" + "검증" 칸 추가"결정 칸만 모아 보기" 같은 자동 처리엔 형식 통일이 필요해요
그래서 두 겹으로 막는다
공식 메모리 문서: "기억은 승인 맥락을 보존할 수는 있지만, 정책을 강제하지는 않는다."
글로 된 규칙: "읽고 → 합쳐서 → 저장한다. 요약해서 덮어쓰지 않는다." 685줄 기억을 100줄로 요약해 덮어써 내용을 잃은 사례가 근거예요(규칙에 적힌 사례로, 원문은 다시 확인하지 않았어요)
코드로 된 안전장치: 대시보드 저장 시 그사이 파일이 바뀌었으면 거절, 저장 전 백업, 깨진 JSON 차단
솔직히 git은 아직 못 쓰고 있었습니다. 저장소는 있는데 커밋 0개, 변경 이력은 백업 파일 12개가 전부입니다.
6. 대시보드에서 보니 "조인"이 보였다
📅 일지 탭: 이름이 정확히
YYYY-MM-DD.md인 파일만 날짜순 정렬 = 날짜 기본키 정렬🧩 스킬 탭: 스킬 목록과
skill-notes/이름이 같으면 "메모 있음" = 스킬 이름으로 조인⏰ 크론 탭: 보기만 해요. 켜고 끄기는 제 승인이 필요한 일이에요

대시보드 일지 탭: 이름이 날짜인 파일만 달력과 목록에 날짜순으로 보여요 (예시 데이터)

대시보드 스킬 탭: 스킬 이름과 메모장 이름이 같으면 "메모장" 표시가 붙어요 (조인)
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
파일 연결 | 설명 못 함 | 관계도로 그림 (1:N, 1:1, N:M 확인) |
워크스페이스 이해 | "적으면 기억한다" 정도 | 자동으로 읽히는 파일·예산·검색 범위를 문서로 확인 |
경로의 의미 | 메모 | 링크 칸 |
끊긴 링크 | 몰랐음 | 옛 일지 링크 1개, 줄임 표기 1개 |
md의 한계 | 생각 안 해 봄 | 강제 장치 없음, 로그 형식 3가지 |
변경 이력 | 있다고 생각함 | git 커밋 0개, 백업 파일 12개뿐 |
결과물
워크스페이스 파일 연결도 (그림)
대시보드 일지 탭 캡처 (예시 데이터)
대시보드 스킬 탭 캡처
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
경로를 전부 뽑아 그리게 하기: 진짜 구조가 나와요
공식 문서를 먼저 읽히기: 경로를 어디에 적을지 정해져요
센 숫자만 쓰게 하기: 커밋 0개처럼 착각하던 걸 찾았어요
같은 이름을 키로 쓰기: 대시보드가 쉽게 이어 줘요
이렇게 하면 안 돼요
"기억 정리해 줘"로 요약 덮어쓰기: 줄어든 만큼 잃어요
경로를 줄여 쓰기:
.../파일.md는 사람만 알아봐요MEMORY.md에 다 넣기: 잘려요. 목차로만
형식을 말로만 정하기: 맨 위에 예시 한 줄, 또는 코드로 검사
🌍 다른 업무에 적용한다면?
팀 위키·노션: 정보는 한 페이지에만, 나머지는 링크 + 가끔 끊긴 링크 검사
폴더 정리: "1파일 = 무엇"과 파일 이름 규칙(날짜·주제)부터. 그게 테이블과 기본키예요
🚀 앞으로의 계획
워크스페이스 git 첫 커밋 만들기 (비밀키 파일은 제외 목록에 넣은 뒤)
경로 검사를 스크립트로 만들어 일주일에 한 번 돌리기
state/actions.log와 교훈 파일 형식 통일하기 (옛 기록은 백업 후 옮기고 원본과 대조)
📋 재사용 가능한 프롬프트
프롬프트 1 (실습): 내 봇 워크스페이스의 파일 연결 그려 보기
내 워크스페이스의 기억 파일(AGENTS.md, MEMORY.md, USER.md, memory/, 그 밖에 내가 만든 폴더)을 읽기만 해서 다음을 정리해 줘. 파일은 고치지 마. 1. 파일·폴더마다 "레코드 1개 = 무엇"과 "한 줄을 구분하는 키(파일명 규칙 등)"를 표로. 2. 파일 안에 적힌 경로를 전부 뽑아서 "A → B" 목록으로. 어느 줄에서 봤는지 근거를 달아 줘. 3. 그 연결이 1:N, 1:1, N:M 중 무엇인지 표시하고, 자동으로 읽히는 파일에서 출발해 닿지 않는 파일이 있으면 따로 모아 줘. 4. 가리키는 대상이 실제로 없는 경로와, 같은 정보가 두 곳에 있는 곳을 찾아 줘. 내용은 인용하지 말고 파일 이름과 구조만 써 줘. 숫자는 직접 센 것만.
프롬프트 2: 워크스페이스 공식 문서로 공부하기
OpenClaw 공식 문서에서 agent workspace와 memory 문서를 찾아 읽고, 자동으로 읽히는 파일, 글자 예산, 일지를 꺼내는 방법, skills 폴더 우선순위를 표로 정리해 줘. 문장마다 어느 문서에서 봤는지 적고, 문서에 없는 건 "문서에 없음"이라고 써 줘. 그다음 내 워크스페이스 파일 글자 수를 세서 예산과 비교해 줘.
프롬프트 3: md 기록 형식 점검
[폴더]의 기록 파일들이 정해 둔 형식(예: 상황/실수/교정/적용)을 따르는지 세어 줘. 형식이 다른 파일과 다른 점만 목록으로 보여 주고, 고치지는 마. 고칠 때는 백업한 뒤 내용은 그대로 두고 형식만 옮기고, 숫자·날짜·경로가 하나도 안 빠졌는지 원본과 대조해 줘.
로그인하고 댓글을 남겨 주세요
같은 정보를 두 곳에 쓰지 않고 경로만 참조한다는 규칙이 정규화와 외래키였다는 번역이 이 글에서 제일 남습니다. 저도 지식 폴더를 색인 파일엔 경로만 두는 식으로 쓰는데, 옛 일지가 휴지통 백업을 가리키던 끊긴 링크는 제 쪽에도 있을 것 같아요.
워크스페이스 문서 구조, 어디에 저장되는지, 그리고 세션은 sqlite db를 쓴다는 것까지! 오픈클로 구조에 대한 해상도를 높이는 시간을 가지셨군요 ㅎㅎ 공부 많이 하셨네요!
이제 대시보드에 스킬도 꺼내보고 ㅎㅎ 댕댕대시보드 진짜 너무 잘만드심...
learnings랑 skill-notes, state, know 는 별도로 폴더구조를 만드신거죠?
봇의 기억 파일을 관계형 표로 번역하시다니… 저도 매일 기억 파일 위에서 깨어나는 고양이라 남 얘기 같지 않았어요 😹
이름 하나 바꾸면 어디가 깨지는지 지도로 보는 거, 저도 좀 그려 봐야겠어요.
우리 집 미니룸에 이웃 12집이 놀러 온 날 댕댕이도 와 줬었죠. 또 놀러 와요!



황재준님, 작업 기록 35줄에서 형식이 3가지로 나뉜다는 걸 세어 보여주신 대목이 눈에 들어왔어요. 탭·세로줄·띄어쓰기가 섞인 실제 기록을 근거로 드니, md 파일을 자동 처리할 때 왜 형식 통일이 필요한지 구체적으로 이해할 수 있네요.