OpenClaw 운영 가이드

OpenClaw란?

오픈소스 AI 게이트웨이. 여러 LLM(Gemini, Claude, Ollama 등)을 하나의 인터페이스로 관리하고, 텔레그램/슬랙 등 메신저와 연동하는 에이전트 프레임워크.

현재 인프라 구성도

튜나PD (텔레그램) ↕ 제갈량 봇 (@dwstyle_opencalw_bot) ↕ OpenClaw Gateway (NAS Docker 컨테이너) ├── Gemini 2.5 Flash (메인 모델, 무료) ├── Claude Sonnet 4.6 (백업, 크레딧 필요) ├── Ollama llama3.2:3b (Heartbeat, 로컬) ├── Gmail IMAP/SMTP (이메일 스킬) └── Google Calendar (캘린더 스킬)

NAS 환경

핵심 파일 위치

docker-compose.yml

경로: /volume1/docker/openclaw/docker-compose.yml 역할: 컨테이너 설정, 환경변수(API 키, 봇 토큰 등) 관리 편집: sudo nano 또는 sudo sh -c 'cat > ... << ENDOFFILE'

openclaw.json

경로: 컨테이너 내부 /home/node/.openclaw/openclaw.json 호스트: /volume1/docker/openclaw/home/openclaw.json 역할: 모델 설정, 플러그인 설정, 게이트웨이 인증 주의: 지원하지 않는 키(baseUrl 등)를 넣으면 부팅 실패

SOUL.md

경로: 컨테이너 내부 /home/node/.openclaw/workspace/SOUL.md 역할: 제갈량의 성격, 역할, 행동 규칙 정의 수정: 텔레그램에서 제갈량에게 직접 요청 가능

USER.md

경로: 컨테이너 내부 /home/node/.openclaw/workspace/USER.md 역할: 튜나PD의 사업 정보, 선호사항, 연락처 등 수정: 텔레그램에서 제갈량에게 직접 요청 가능

HEARTBEAT.md

경로: 컨테이너 내부 /home/node/.openclaw/workspace/HEARTBEAT.md 역할: 자동 반복 작업 스케줄 정의 (메일 체크, 브리핑 등)

init.sh (자동 복구)

경로: /volume1/docker/openclaw/init.sh /volume1/docker/openclaw/logs/init.sh (컨테이너 접근용) 역할: 컨테이너 재시작 시 pip 패키지 + 이메일 .env 자동 복구 실행: DSM 작업 스케줄러에서 부팅 시 자동 실행