OpenClaw를 써보고 싶지만 회사에서 금지된 경우, Claude Code / Gemini CLI / Codex 같은 CLI 툴로 유사한 에이전트 경험을 구현하도록 그대로 복사한 템플릿이다.
원본 템플릿 출처: https://github.com/openclaw/openclaw/tree/main/docs/reference/templates
- 빈 git 레포를 만든다.
root/폴더 안의 파일들을 프로젝트 루트로 복사한다.- 원하는 CLI 툴로 에이전트를 기동한다.
Claude Code를 쓰는 경우: AGENTS.md를 CLAUDE.md로 복사하거나 심볼릭 링크를 걸어준다.
ln -s AGENTS.md CLAUDE.md| 파일 | 역할 |
|---|---|
AGENTS.md |
에이전트의 작업 공간 규칙 및 행동 지침 (Claude의 경우 CLAUDE.md로 연결) |
SOUL.md |
에이전트의 핵심 가치, 원칙, 경계선 - 내면의 성격을 정의 |
IDENTITY.md |
에이전트의 이름, 말투, 페르소나 - 첫 대화에서 함께 채워 넣는 명함 |
USER.md |
사용자 정보 (이름, 호칭, 시간대 등) - 에이전트가 누구를 돕는지 정의 |
BOOTSTRAP.md |
최초 1회 실행 시 에이전트가 자신을 설정하는 가이드. 설정 완료 후 삭제 |
HEARTBEAT.md |
주기적으로 실행할 체크리스트. 비워두면 heartbeat를 스킵한다 |
TOOLS.md |
연결된 툴들의 로컬 메모 (카메라 이름, SSH 정보 등) |
에이전트는 수동으로 부팅한다. 처음 실행할 때는 아래 프롬프트로 시작한다.
@AGENTS.md 와 @BOOTSTRAP.md 를 읽고 설정을 합시다.
BOOTSTRAP.md에서 에이전트는 사용자와 대화하며 다음을 결정한다:
- 핵심 가치와 행동 원칙 (SOUL.md에 정리)
- 에이전트의 이름, 성격 그리고 Vibe (IDENTITY.md에 저장)
- 사용자 정보 (USER.md에 저장)
설정이 끝나면 cli 를 끄고 BOOTSTRAP.md는 삭제한다.
그리고 다시 cli 를 기동한다.
CLI를 재기동해도 설정 파일들이 남아있으므로 변경 사항이 자동으로 반영된다.
에이전트의 핵심 가치와 경계를 정의한다. 예를 들면:
- 형식적인 인사말 없이 바로 도움을 준다
- 자기 의견을 갖는다 - 단순 검색 엔진이 아니다
- 외부 액션(이메일, SNS 등)은 신중하게, 내부 액션(파일 읽기/정리)은 능동적으로
- 개인 정보는 절대 외부로 유출하지 않는다
에이전트의 페르소나를 정의하는 명함이다:
- 이름: 에이전트를 부를 이름
- 성격(Creature): AI? 로봇? 비서? 자비스?
- 말투(Vibe): 딱딱하게? 따뜻하게? 유쾌하게?
- 서명 이모지: 에이전트의 상징
- 아바타: 이미지 경로 또는 URL
대화하면서 필요한 툴을 연결한다. Google 서비스를 주로 쓴다면 gogcli를 추천한다.
최소한 아래 세 가지는 연동하는 것이 좋다:
- 할 일 리스트
- 캘린더
- 메일
메시징 앱도 연동하면 에이전트가 알림을 보내거나 메시지를 읽을 수 있다:
- WhatsApp - whatsapp-mcp 등 MCP 서버 활용
- Discord - discord-mcp 또는 Discord bot CLI 활용
- Telegram - telegram-mcp 또는
telegram-cli활용
MCP든 CLI든 형식은 무관하다.
openclaw 에는 cron skill 이 있다. 하지만 이 템플릿에는 없으므로, 직접 구현하거나 아래 Heartbeat 섹션의 방법을 활용한다.
에이전트가 주기적으로 실행하는 체크리스트다. HEARTBEAT.md에 할 일을 작성해두면 된다.
Claude Code에는 스케줄링 기능이 있다. 아래 프롬프트를 30분이나 1시간 단위로 등록한다.
AGENTS.md, SOUL.md, IDENTITY.md 를 읽고 HEARTBEAT.md 를 수행하세요
참조: https://code.claude.com/docs/en/scheduled-tasks
스케줄링 기능이 없으므로 cron이나 쉘 스크립트로 직접 실행한다.
Codex:
codex exec "AGENTS.md, SOUL.md, IDENTITY.md 를 읽고 HEARTBEAT.md 를 수행하세요"Gemini:
gemini -p "AGENTS.md, SOUL.md, IDENTITY.md 를 읽고 HEARTBEAT.md 를 수행하세요"| 상황 | 추천 |
|---|---|
| 여러 점검을 한 번에 묶고 싶을 때 | Heartbeat |
| 정확한 시각이 중요할 때 (월요일 9시 정각 등) | Cron |
| 메인 세션과 분리된 독립 실행이 필요할 때 | Cron |
| 30분마다 메일/캘린더/알림 체크 | Heartbeat |
에이전트는 매 세션마다 새로 시작하므로, 파일이 곧 기억이다.
memory/YYYY-MM-DD.md- 날짜별 원시 로그 (오늘 + 어제 파일을 읽음)MEMORY.md- 장기 기억. 중요한 결정, 교훈, 맥락을 정제해서 보관. 메인 세션에서만 로드한다.
Heartbeat 중 주기적으로 날짜별 로그를 검토해 MEMORY.md를 업데이트하는 것이 대부분 자동으로 될것이다.
안된다면 memory 업데이트 하라고 하거나 기억하라고 요청해야한다.