고정 헤더 영역
상세 컨텐츠
본문
반응형
OpenClaw는 사람이 웹브라우저에서 하는 행동(클릭, 검색, 데이터 입력 등)을 AI가 대신 수행해 주는 오픈소스 AI 에이전트입니다. 쉽게 말해 "웹 서핑을 대신 해주는 AI 비서"라고 보시면 됩니다.
1. OpenClaw란 무엇인가?
OpenClaw는 사용자가 자연어(평소 쓰는 말)로 명령을 내리면, AI(주로 GPT-4o나 Claude 3.5 Sonnet 등)가 브라우저 화면을 직접 보고 판단하여 작업을 완수하는 도구입니다.
- 주요 역할: 정보 수집, 복잡한 웹사이트 예약, 폼 입력, 쇼핑몰 가격 비교 등.
- 작동 방식: 브라우저의 스크린샷과 HTML 구조를 분석해 "어떤 버튼을 눌러야 할지" 스스로 결정합니다.
2. 주요 기능 및 활용 예시
이 'AI 비서'에게 내릴 수 있는 명령(Task)의 예시는 다음과 같습니다.
- 정보 검색 및 요약: "최신 AI 뉴스 5개를 찾아서 엑셀 형식으로 정리해줘."
- 구매 및 예약: "제주도행 가장 저렴한 비행기 표를 찾아서 예약 페이지까지 띄워줘."
- 반복 업무: "특정 사이트에 로그인해서 매일 올라오는 공지사항을 확인해줘."
- 데이터 추출: "이 쇼핑몰에 있는 모든 상품 이름과 가격을 리스트로 만들어줘."
3. OpenClaw 사용을 위한 구성 요소
단순한 프로그램 설치보다는 개발자 도구에 가깝기 때문에 몇 가지 준비물이 필요합니다.
- Python 환경: 컴퓨터에 파이썬이 설치되어 있어야 합니다.
- Playwright: 브라우저를 원격 제어하기 위한 라이브러리입니다.
- LLM API Key: AI의 '두뇌' 역할을 할 OpenAI(GPT)나 Anthropic(Claude)의 API 키가 필요합니다.
- GitHub 저장소: 보통 OpenClaw 공식 GitHub에서 코드를 내려받아 실행합니다.
4. 게임 명령어와 다른 점
이 비서 서비스에서의 '명령어'는 정해진 단어(예: /help)라기보다 "사용자의 요청 사항(Prompt)" 그 자체입니다.
- 게임: god, give all 등 고정된 코드 입력.
- 비서: "내 네이버 메일 들어가서 읽지 않은 메일 제목만 다 알려줘" 같은 자연어 명령.
OpenClaw 대표 사이트
OpenClaw — Personal AI Assistant
OpenClaw — The AI that actually does things. Your personal assistant on any platform.
openclaw.ai
OpenClaw 공식 GitHub
GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞 - GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
github.com
윈도우에서 설치시 (cmd.exe) - 비추천 (WSL2 에서 설치하는 것을 추천)
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WSL2 설치시
# nvm 다운로드 및 설치: node 설치 버전 관리 툴
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# Node.js 다운로드 및 설치: 22 이상 node 버전을 설치해야 함
nvm install 24
# openclaw 설치
npm install -g openclaw@latest
# openclaw 실행
openclaw onboard --install-daemon
onboard 를 실행 하면 아래와 같이 화면이 뜨면 정상 설치 완료
초반 질문에 Yes를 선택해야 한다. 리스크가 있으니 감수하고 설치하겠냐 라고 물어보는 것이다.
🦞 OpenClaw 2026.2.19-2 (45d9b20) — curl for conversations.
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
🦞 OPENCLAW 🦞
┌ OpenClaw onboarding
│
◇ Security ──────────────────────────────────────────────────────────────────────────────╮
│ │
│ Security warning — please read. │
│ │
│ OpenClaw is a hobby project and still in beta. Expect sharp edges. │
│ This bot can read files and run actions if tools are enabled. │
│ A bad prompt can trick it into doing unsafe things. │
│ │
│ If you’re not comfortable with basic security and access control, don’t run OpenClaw. │
│ Ask someone experienced to help before enabling tools or exposing it to the internet. │
│ │
│ Recommended baseline: │
│ - Pairing/allowlists + mention gating. │
│ - Sandbox + least-privilege tools. │
│ - Keep secrets out of the agent’s reachable filesystem. │
│ - Use the strongest available model for any bot with tools or untrusted inboxes. │
│ │
│ Run regularly: │
│ openclaw security audit --deep │
│ openclaw security audit --fix │
│ │
│ Must read: https://docs.openclaw.ai/gateway/security │
│ │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ I understand this is powerful and inherently risky. Continue?
│ Yes
브라우저 화면 열기 위해 세션 토큰 발급을 받아야 한다
# 토큰 발급 명령어
openclaw dashboard
# 결과 Dashboard URL 복사해 브라우저에 붙여넣으면 openclaw과 대화 할 수 있다
Dashboard URL: http://127.0.0.1:18789/#token=6bc75d98e4e41611aa3a59abbac1e0e4d13dd2dd91bedd96
Copied to clipboard.
No GUI detected. Open from your computer:
ssh -N -L 18789:127.0.0.1:18789 root@<host>
Then open:
http://localhost:18789/
http://localhost:18789/#token=6bc75d98e4e41611aa3a59abbac1e0e4d13dd2dd91bedd96
Docs:
https://docs.openclaw.ai/gateway/remote
https://docs.openclaw.ai/web/control-ui
openclaw 문제 발생시
openclaw doctor --fix대부분의 문제는 위 명령어로 해소가 가능하다
스킬기능 요약
🔐 1password
1Password CLI 연동
- 1Password CLI를 통해 비밀키 읽기·쓰기, 볼트 관리, 멀티 계정 지원을 제공.
[openclaw.com.au]
📝 blogwatcher
※ 검색 결과에서 “blogwatcher”라는 공식 스킬을 찾을 수 없었습니다.
→ ClawHub에 없거나 다른 이름일 수 있습니다.
원하시면 해당 스킬의 폴더/SKILL.md 내용을 알려주시면 해석해 드릴게요.
🔊 blucli
BluOS 멀티룸 오디오 제어 CLI
- BluOS 기기(예: Bluesound) 검색, 재생, 그룹 관리, 볼륨 조절을 수행.
[openclaw.com.au]
📸 camsnap
RTSP/ONVIF 보안 카메라 캡처
- 보안 카메라에서 프레임·클립 캡처.
[openclaw.com.au]
📦 clawhub
ClawHub 연동 도구 (스킬 설치·업데이트·동기화 관리)
- OpenClaw 공식 스킬 레지스트리 ClawHub에서 설치, 업데이트, 백업, 동기화 기능 제공.
[docs.openclaw.ai]
🛏️ eightctl
Eight Sleep 스마트 침대 제어
- Eight Sleep Pod의 온도·알람·스케줄·상태 조회를 제어.
[openclaw.com.au]
🤖 gemini
※ 검색 결과에서 “gemini”라는 독립 스킬은 확인되지 않음.
대신 nano-banana-pro가 Gemini 3 Pro Image 모델 기반 이미지 생성 스킬임.
(아래 nano-banana-pro 참조)
🎞️ gifgrep
GIF 검색·다운로드·추출 도구
- GIF 제공처에서 GIF 검색 및 다운로드, 스틸컷·스프라이트시트 추출
[openclaw.com.au]
🐙 github
GitHub CLI(gh) 연동 스킬
- GitHub 이슈, PR, CI run 조회/생성
- 고급 gh api 기능까지 사용
[clawhub-skills.com]
📧 gog
Google Workspace CLI 통합 스킬
- Gmail, Calendar, Drive, Contacts, Sheets, Docs를 하나의 CLI로 제어
[clawhub-skills.com]
📍 goplaces
Google Places API 검색
- 장소 검색, 세부 정보, 리뷰 조회
[openclaw.com.au]
📬 himalaya
IMAP/SMTP 이메일 관리
- 이메일 리스트/읽기/답장/전달/검색 등 지원하는 이메일 CLI
[openclaw.com.au]
🧰 mcporter
MCP(Multi-Client Protocol) 서버 제어 및 설정 도구
- MCP 서버 리스트, 인증, 호출
- HTTP/STDIO 기반 MCP와의 연동, 타입/CLI 생성 기능
[clawhub-skills.com]
🎨 nano-banana-pro
Gemini 3 Pro 기반 이미지 생성/편집
- 텍스트→이미지, 이미지→이미지
- 1K/2K/4K 생성, 이미지 편집 지원
[clawhub-skills.com]
📄 nano-pdf
PDF 편집 스킬
- PDF를 자연어로 편집, 구조 변경, 추출 등 수행
[clawhub-skills.com]
🗒️ obsidian
Obsidian Vault 자동화
- Obsidian CLI를 통해 마크다운 노트 조회·추가·편집
[openclaw.com.au]
🎤 openai-whisper
로컬 Whisper 음성 인식
- Whisper CLI 기반 오디오 → 텍스트 변환
- API 키 불필요
[clawhub-skills.com]
💡 openhue
Philips Hue 조명 제어
- 필립스 Hue 조명 및 씬 제어
[openclaw.com.au]
🗄️ oracle
※ “oracle”이라는 스킬은 검색 결과에서 확인되지 않음.
→ SKILL.md 또는 설치 경로 제공 시 기능 분석 가능.
📦 ordercli
※ 공식 스킬 목록에 존재하는 이름으로 확인되지 않음.
→ SKILL.md 제공 시 해석 가능.
📊 sag
※ 검색 결과에서 “sag” 스킬 설명이 없음.
→ SKILL.md 제공 시 해석 가능.
🎼 songsee
오디오 시각화 도구
- 스펙트로그램 및 오디오 피처 패널 생성
[openclaw.com.au]
🔊 sonoscli
Sonos 스피커 제어
- Sonos 기기 검색, 상태, 재생, 볼륨, 그룹 관리
[clawhub-skills.com]
📝 summarize
웹/파일 요약 스킬
- 웹 URL, PDF, 이미지, 오디오, YouTube를 요약 [clawhub-skills.com]
🎞️ video-frames
동영상 -> 프레임/클립 추출
- ffmpeg 기반으로 단일 프레임 또는 짧은 클립 추출
모든 정보는 OpenClaw 공식 Hooks 문서와 Learn OpenClaw 문서에 근거하여 작성했습니다.
✅ 1. boot-md
✔ 기능 설명
- Gateway(게이트웨이)가 시작될 때 BOOT.md 파일을 자동 실행하는 Hook입니다.
- 즉, OpenClaw가 부팅될 때마다 에이전트에게 제공할 초기 문맥·규칙·상태 초기화 지침을 자동으로 로드합니다.
- 이 Hook을 사용하면 매번 수동으로 boot 문서를 다시 읽힐 필요 없이 자동 초기화 시나리오를 설정할 수 있습니다.
📌 출처: boot-md는 “Run BOOT.md on gateway startup”으로 명시됨
또한 Learn OpenClaw 문서에서도 boot-md가 번들 Hook 중 하나로 등록됨 [docs.openclaw.ai] [learnclawdbot.org]
✅ 2. bootstrap-extra-files
✔ 기능 설명
- 에이전트 **부트스트랩 과정에서 추가 workspace 파일을 시스템 프롬프트에 자동 삽입(inject)**하도록 하는 Hook입니다.
- 기본적으로 OpenClaw는 다음과 같은 정해진 bootstrap 파일 세트만 자동 로드합니다:
- AGENTS.md
- SOUL.md
- TOOLS.md
- IDENTITY.md
- USER.md
- HEARTBEAT.md
- BOOTSTRAP.md
→ 하지만 **사용자가 넣고 싶은 .md 파일(예: memory/LESSONS.md, project-state.md)**은 기본 기능만으로는 자동 로드되지 않습니다.
bootstrap-extra-files Hook은 이 한계를 해결하여,
사용자가 지정한 파일을 에이전트의 “Project Context”에 자동 삽입해 초기 문맥 품질을 크게 높일 수 있습니다.
📌 출처: “Inject extra workspace bootstrap files during agent bootstrap”으로 명시됨
또한 “추가 bootstrap 파일을 로드하고 싶다”는 기능 요청 문서에서 동일 기능이 설명됨 [docs.openclaw.ai] [github.com]
✅ 3. command-logger
✔ 기능 설명
- OpenClaw에서 발생하는 모든 slash command 이벤트(/new, /reset 등)를 로그로 기록하는 Hook입니다.
- 로깅 파일 위치 예:
~/.openclaw/logs/commands.log - 이 Hook은 감사(audit)·트러블슈팅·컴플라이언스와 같은 환경에서 필수적입니다.
📌 출처: command-logger는 “Log all command events to a centralized audit file”로 명시됨
또한 Learn OpenClaw 문서에 동일 Hook이 번들 Hook으로 포함됨 [docs.openclaw.ai] [learnclawdbot.org]
✅ 4. session-memory
✔ 기능 설명
- /new 명령이 실행될 때 현재 세션의 중요한 문맥을 메모리 파일에 자동 저장하는 Hook입니다.
- 예:
- 세션 초기화 전에 중요한 정보가 사라지지 않도록
- memory/YYYY-MM-DD.md 또는 MEMORY.md 등에 자동 저장
- "세션 초기화로 기존 맥락 없어지는 문제"를 해결하는 핵심 Hook입니다.
배경 기능 (관련 메모리 시스템)
OpenClaw의 메모리는 Markdown 파일 기반이며,
- memory/YYYY-MM-DD.md = 일일 기록
- MEMORY.md = 장기 기억
으로 구성됩니다.
session-memory Hook은 이 구조에 맞추어 세션이 초기화되기 전에 자동 백업 기능을 수행합니다.
📌 출처:
- session-memory는 “Save session context to memory when /new command is issued”로 명시됨 [docs.openclaw.ai]
- Learn OpenClaw 문서에서 session-memory가 번들 Hook으로 설명됨 [learnclawdbot.org]
- OpenClaw 메모리 구조 설명 문서 참조 [docs.openclaw.ai]
반응형
'개발자를위한다양한이야기' 카테고리의 다른 글
| docker 명령어 모음 (0) | 2026.02.20 |
|---|---|
| 웹 패킷 분석 Fiddler 사용법 (1) | 2026.01.23 |
| Polling (Short Polling), Long Polling, Stream API (Server-Sent Events, SSE) (0) | 2026.01.22 |
| Git 긴급(충돌)할때 사용하는 명령어 (0) | 2025.08.20 |
| 웹소켓 통신 시 1::, h, a와 같은 문자열 (3) | 2025.01.08 |
