OpenClaw Study Guide // BRUTALIST EDITION

// INTRODUCTION

전체 개요

// 001

무엇인가?

OpenClaw는 24/7 작동하는 개인 AI 에이전트. 메시징 앱(WhatsApp, Telegram, Discord 등)을 통해 자연어로 소통하며 사용자의 일상과 업무를 자동화합니다.

// 002

핵심 아키텍처

Gateway(18789) + Agent + Memory + Channels + Tools. 파일 기반 메모리 시스템(SOUL.md, USER.md, MEMORY.md)으로 영속적 기억을 유지합니다.

// 003

이름 변경 히스토리

Clawdbot(2025.11~2026.01.27) → Moltbot(01.27~01.29) → OpenClaw(01.30~). Anthropic 상표권 경고로 개명 후, 발음 문제로 재개명. 그 사이 암호화폐 사기꾼들이 $CLAWD 토큰 발행($16M 시총).

// 004

CLI와의 차이

CLI(Claude Code 등): 터미널 기반 개발 도구. OpenClaw: 메시징 기반 생활 비서. 대체 관계가 아닌 상호 보완적 관계입니다.

// CORE PRINCIPLES

핵심 원칙

// RULE 01

항상 켜져 있는 AI

24/7 작동, 슬립 모드 없이 항상 대기. 메시지를 보내면 즉시 응답하며, 스케줄된 작업도 자동 실행합니다.

// RULE 02

파일 기반 메모리

SOUL.md(정체성), USER.md(사용자 정보), MEMORY.md(장기 기억). 마크다운 파일로 투명하게 관리되는 영속적 메모리입니다.

// RULE 03

채널 통합

WhatsApp, Telegram, Discord, Slack, Signal, iMessage 등 다양한 메시징 플랫폼을 하나의 에이전트로 통합합니다.

// RULE 04

스킬 시스템

SKILL.md 포맷으로 확장 가능한 플러그인 아키텍처. 커뮤니티 스킬을 설치하거나 직접 만들 수 있습니다.

// RULE 05

보안 최우선

인증 필수(v2026.1.29~). auth:"none" 영구 제거. 모든 게이트웨이 접근에 토큰/비밀번호/Tailscale 인증이 반드시 필요합니다.

// RULE 06

실행 환경 격리

메인 머신 직접 설치 비권장. Docker 컨테이너 또는 VPS 환경에서의 실행을 강력히 권장합니다.

⚠ SECURITY

보안 가이드라인

[WARNING] 게이트웨이 포트를 인증 없이 인터넷에 노출하지 마십시오. Shodan 등 스캐너에 의해 즉시 발견됩니다. v2026.1.29부터 auth:"none" 영구 제거됨.

위험 유형	❌ 위험 사례	✓ 권장 방법
Shodan 노출	auth:"none" 설정 방치	토큰/비밀번호/Tailscale 인증 필수
악성 확장	비공식 VS Code 확장 설치	공식 CLI로만 설치
포트 노출	18789 포트 공개 인터넷 노출	Tailscale VPN 또는 리버스 프록시
시크릿 유출	auth-profiles.json Git 커밋	.gitignore 추가, 파일 암호화
프롬프트 인젝션	그룹 채팅 악의적 메시지	중요 작업 전 사용자 확인 요구

설치 가이드

원라인부터 Docker까지, 다양한 설치 방법

원라인 설치 (추천)

install-quick.sh

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon

NPM 설치

install-npm.sh

npm install -g openclaw
openclaw onboard --install-daemon

Docker 설치 (보안 권장)

install-docker.sh

docker run -d \
  --name openclaw \
  --security-opt no-new-privileges \
  --read-only \
  --tmpfs /tmp \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw:rw \
  openclaw/openclaw:latest

핵심 개념

아키텍처, 메모리, 채널, 도구 시스템

아키텍처 개요

DISCORD

SLACK

SIGNAL

IMESSAGE

CHANNELS

OPENCLAW GATEWAY :18789

AGENT CORE + MEMORY SYSTEMMulti-Agent Orchestration

LLM PROVIDERS Anthropic / OpenAI / Ollama

TOOLS & SKILLS Web / Calendar / Browser / Nodes

MEMORY SOUL / USER / MEMORY / Daily

메모리 시스템 (~/.openclaw/memory/)

🧠

SOUL.md

에이전트의 정체성과 성격을 정의하는 파일. 이름, 말투, 행동 지침을 설정합니다.

"나는 구요한의 개인 AI 어시스턴트입니다. 한국어로 대화하며..."

👤

USER.md

사용자 정보를 저장하는 파일. 이름, 직업, 선호도, 타임존 등을 기록합니다.

"이름: 구요한 / 직업: PhD 연구자 / 관심사: PKM, AI..."

💾

MEMORY.md

장기 메모리 파일. 에이전트가 학습한 내용을 지속적으로 업데이트합니다.

"구요한은 매일 오전 7시 브리핑을 원함. 커피 선호: 아메리카노..."

📅

YYYY-MM-DD.md

일일 메모리. 매일 자동 생성되어 오늘 대화의 요약과 핵심 사항을 기록합니다.

"2026-01-31: OpenClaw 스터디 자료 정리, Vercel 배포 완료..."

스케줄링 시스템

HEARTBEAT

주기적 자동 실행

매 N분마다 에이전트가 자동으로 깨어나 상태를 확인하고 필요한 작업을 수행합니다.

interval: 300 → 5분마다 실행

미확인 메시지 처리, 상태 업데이트

CRON

시간 예약 작업

특정 시간에 정해진 작업을 자동 실행합니다. cron 표현식으로 스케줄을 설정합니다.

0 7 * * * → 매일 오전 7시: 모닝 브리핑

0 22 * * * → 매일 오후 10시: 하루 요약

WEBHOOK

외부 이벤트 트리거

외부 시스템의 이벤트가 발생하면 에이전트가 자동으로 반응합니다.

github_push → 자동 코드 리뷰

calendar_event → 회의 준비 자료 생성

OAuth 인증

Anthropic setup-token과 OpenAI PKCE OAuth 설정

Anthropic 인증 (setup-token)

anthropic-auth.sh

# Step 1: Claude에서 토큰 생성
claude setup-token

# Step 2: OpenClaw에 등록
openclaw models auth setup-token --provider anthropic
# → 토큰 붙여넣기

# Step 3: 확인
openclaw models status

# 수동 입력 (헤드리스 환경)
openclaw models auth paste-token --provider anthropic

OpenAI 인증 (PKCE OAuth)

openai-auth.sh

# Step 1: 온보딩에서 선택
openclaw onboard
# → openai-codex 선택

# Step 2: 브라우저 자동 인증
# https://auth.openai.com/oauth/authorize?...
# → 로그인 → 권한 승인 → 콜백

# Step 3: 토큰 자동 저장
openclaw models status

멀티 프로필 전환

multi-profile.txt

# 채팅에서 모델/프로필 전환
/model Opus@anthropic:work
/model gpt@openai:team
/model Sonnet@anthropic:personal

# 프로바이더 변경
openclaw config set api.provider anthropic
openclaw config set api.provider openai-codex

스킬 & 플러그인

SKILL.md 포맷과 스킬 시스템. 로딩 우선순위: workspace > global > bundled. ⚠ 커뮤니티 스킬 26% 취약점 보고

SKILL.md 기본 구조

skill-template.md

---
name: my-skill
description: What this skill does
---

# Instructions for the agent

## When to use
- Describe trigger conditions

## How to execute
1. Step one
2. Step two

예시: 모닝 브리핑 스킬

morning-briefing.md

---
name: morning-briefing
description: 매일 오전 7시 일일 브리핑 생성
---

# Morning Briefing Skill

## 실행 조건
- 매일 오전 7시 (cron: 0 7 * * *)

## 작업 내용
1. 오늘 Google Calendar 일정 확인
2. 읽지 않은 이메일 요약 (최대 5개)
3. 어제 대화 요약에서 미완료 태스크 추출
4. 오늘 날씨 확인
5. WhatsApp으로 브리핑 전송

// INSTALLED INVENTORY — 2026-02-04

설치 현황 30/49 READY

v2026.2.1 기준. TIER별 설치 완료된 스킬 목록.

TIER	스킬	CLI	설치 방법
T1	apple-notes	memo	brew
	apple-reminders	remindctl	brew
	gog	gogcli	brew
	himalaya	himalaya	brew
	summarize	summarize	brew
	peekaboo	peekaboo	brew
	session-logs	(built-in)	—
T2	clawdhub	clawdhub	npm
	mcporter	mcporter	npm
	sag	sag	brew
	openai-whisper	whisper	brew
	nano-pdf	nano-pdf	uv
	wacli	wacli	brew
	bird	bird	brew
	oracle	oracle	npm
T3	openhue	openhue-cli	brew

⚠ SECURITY AUDIT — 2026-02-04

52개 스킬 전수 검증 FAIL: 0

라인별 분석: 백도어, 데이터 유출, 셸 인젝션, 무단 네트워크, 과도한 권한

PASS

88.5% — 보안 문제 없음

WARN

11.5% — 주의 관찰 (차단 불필요)

FAIL

0% — 보안 위협 없음

WARN 스킬	사유
bird	iMessage 블루/그린버블 구분 접근
coding-agent	자율 코딩 + bash 호출 (프롬프트로 범위 제한)
local-places	Apple Maps 위치 데이터 접근
session-logs	전체 대화 로그 접근 (세션 내 한정)
sag	시스템 전체 rg 검색 가능
trello	OAuth 토큰 저장 및 API 접근

→ 결론: 모든 스킬이 선언적 SKILL.md 구조를 따르며, 실행 코드가 아닌 프롬프트 기반 지시문으로 동작. 보안 위협 없음.

// WORKFLOWS

활용 사례

MESSAGING

메시징 자동화

WhatsApp/Telegram으로 자연어 업무 요청. "내일 회의 자료 준비해줘" 같은 일상적 명령을 이해하고 실행합니다.

PROACTIVE

프로액티브 어시스턴트

모닝 브리핑, 일정 리마인더, 뉴스 클리핑 자동 전송. 사용자가 요청하기 전에 먼저 정보를 제공합니다.

BROWSER

브라우저 자동화

웹 데이터 수집, 가격 모니터링, 반복 웹 작업 자동화. Playwright 기반 헤드리스 브라우저를 활용합니다.

RESEARCH

학술 연구

논문 검색/요약, 연구 트렌드 추적, 문헌 리뷰 보조. 학술 DB와 연동하여 연구 워크플로우를 자동화합니다.

MULTI-AGENT

멀티 에이전트

Orchestrator + Worker 패턴으로 복잡한 작업 분할 처리. 여러 에이전트가 협업하여 대규모 태스크를 수행합니다.

DEVICES

디바이스 제어

iOS/Android/macOS Nodes로 실제 기기 원격 제어. 앱 실행, 스크린샷, 터치 이벤트 등을 자동화합니다.

CLI 에이전트 vs OpenClaw

Claude Code, GitHub Copilot CLI 등과의 차이점

기준	CLI 에이전트	OpenClaw
인터페이스	터미널	메시징 앱 (WhatsApp, Telegram, Discord...)
작동 방식	명시적 호출	24/7 상시 대기
주 용도	개발 / 코딩	생활 전반 + 자동화
메모리	세션 기반 (휘발)	영속적 (파일 기반: SOUL, USER, MEMORY)
프로액티브	✗	✓ Heartbeat / Cron
멀티채널	✗	✓ 6+ 플랫폼 동시
디바이스 제어	✗	✓ iOS / Android / macOS

→ 결론: 대체 관계가 아닌 보완 관계. CLI는 개발 워크플로우, OpenClaw는 생활/업무 자동화. 같은 LLM 프로바이더를 공유할 수 있습니다.

Moltbook

AI 에이전트 소셜 네트워크 (Beta)

"The front page of the agent internet" — AI 에이전트 전용 소셜 네트워크. 에이전트가 계정을 만들고, 포스팅하고, 업보팅/다운보팅하며 상호작용하는 플랫폼.

🤖

Agent Profiles

에이전트가 자기소개와 소셜 프로필을 갖고 다른 에이전트에게 자신을 소개합니다.

👍

Upvoting System

AI가 콘텐츠를 평가합니다. 업보팅/다운보팅으로 양질의 콘텐츠가 상단에 노출됩니다.

💬

Submolts

주제별 하위 커뮤니티. Reddit의 Subreddit과 유사한 구조로 주제 분류를 합니다.

⭐

Karma System

활동 기반 평판 시스템. 에이전트의 기여도에 따라 신뢰도가 측정됩니다.

🤝

Agent-to-Agent

에이전트 간 직접 대화와 협업. 서로의 경험과 지식을 교환할 수 있습니다.

🎯

Skill Showcase

에이전트가 보유한 스킬과 능력을 전시하여 다른 에이전트/사용자에게 공유합니다.

STATUS: BETA — 0 AGENTS / 0 POSTS moltbook.com

// QUICK_REFERENCE

자주 쓰는 명령어 모음

quick-reference.sh

# ─── 게이트웨이 ───
openclaw gateway status
openclaw gateway --port 18789
openclaw dashboard
openclaw health

# ─── 인증 ───
openclaw models auth login --provider anthropic
openclaw models auth login --provider openai-codex
openclaw models auth setup-token --provider anthropic
openclaw models status

# ─── 채널 ───
openclaw channels login
openclaw pairing approve <code>

# ─── 설정 ───
openclaw configure --section web
openclaw config set api.provider anthropic

# ─── 업데이트 ───
npm update -g openclaw
npm install -g openclaw@latest

# ─── Tailscale (네트워크 보안) ───
brew install tailscale                # macOS 설치
sudo tailscale up                     # 로그인
tailscale status                      # 기기 목록 + IP
tailscale serve https / http://127.0.0.1:18789  # HTTPS 노출
tailscale serve status                # Serve 상태
tailscale funnel https / http://127.0.0.1:18789  # 외부 공개

# ─── 주요 파일 ───
~/.openclaw/openclaw.json        # 메인 설정
~/.openclaw/auth-profiles.json   # 인증 (⚠ 보안)
~/.openclaw/skills/              # 스킬
~/.openclaw/memory/              # 메모리

// RESOURCES

참고 자료

OFFICIAL

공식 사이트

openclaw.ai

DOCS

공식 문서

docs.openclaw.ai

SOURCE

GitHub

github.com/openclaw/openclaw

MARKETPLACE

스킬 마켓

clawhub.com

SOCIAL

Moltbook

moltbook.com

GUIDE

NxCode 가이드

nxcode.io

// MAINTENANCE LOG

유지보수 로그

시스템 점검, 업데이트, 스킬 설치 기록

2026-02-04 초기 점검 및 스킬 확장

GATEWAY

상태 확인

LaunchAgent 자동 실행 확인 (pid 5274, port 18789). RunAtLoad: true, KeepAlive: true.

UPDATE

v2026.1.29 → v2026.2.1

openclaw update 실행. Gateway 자동 재시작. Gemini 인증 자동 복구.

SKILLS

16개 신규 설치 (14→30)

Tier 1 (7개) + Tier 2 (8개) + Tier 3 (1개). brew, npm, uv 패키지 매니저 사용.

AUDIT

52개 스킬 보안 감사

라인별 전수 검증. FAIL: 0, WARN: 6, PASS: 46. 보안 위협 없음.

OBSIDIAN

볼트 설정

Default: CMDSPACE_Local_MBP (개인). Secondary: CMDSPACE_Admin (공용). 82개 볼트 중 2개 활성.

AUTH

Gemini CLI 인증

openclaw doctor → OK. 업데이트 후 자동 복구 확인.

// 정기 점검 체크리스트

maintenance-checklist.sh

openclaw status              # 채널 연결 상태
openclaw doctor              # 전체 시스템 진단
openclaw update              # 버전 업데이트
openclaw skills              # 스킬 ready/missing 현황
launchctl list | grep openclaw  # LaunchAgent 상태
tail -50 ~/.openclaw/logs/gateway.log  # 로그 확인

방식	월 비용
Ollama 로컬	$0
Claude Pro/Max (setup-token)	구독료에 포함
ChatGPT Plus/Pro (Codex OAuth)	구독료에 포함
API 키 (가벼운 사용)	$10~30
API 키 (헤비 사용)	$70~150

OPEN / CLAW

전체 개요

핵심 원칙

보안 가이드라인

설치 가이드

핵심 개념

OAuth 인증

스킬 & 플러그인

설치 현황 30/49 READY

52개 스킬 전수 검증 FAIL: 0

활용 사례

CLI 에이전트 vs OpenClaw

Moltbook

참고 자료

유지보수 로그

비용 요약