OpenClaw: 메신저에서 만나는 AI 비서
여러분은 WhatsApp, Telegram, Discord, Slack 같은 메신저를 하루에 얼마나 사용하시나요? 대부분이 이미 익숙하게 사용하는 이런 플랫폼에서 AI 비서를 직접 만날 수 있다면 어떨까요? 오늘 소개할 OpenClaw는 바로 그런 도구입니다. 🦞
OpenClaw란?
OpenClaw는 여러분의 기기에서 직접 실행되는 개인 AI 비서입니다. 가장 큰 특징은 우리가 매일 사용하는 메신저 플랫폼을 통해 AI와 소통할 수 있다는 점인데요. WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Microsoft Teams 등 여러 채널을 지원하며 심지어 WebChat도 제공합니다.
OpenClaw의 마스코트는 랍스터(🦞)인데요, 이는 원래 이름인 Clawdbot의 “Claw(집게)“에서 유래한 것입니다.
“Open”이라는 이름이 붙은 이유는 이 프로젝트가 오픈소스임을 강조하기 위해서입니다.
호환성을 위해 clawdbot과 moltbot 명령어는 여전히 사용할 수 있습니다.
리브랜딩 히스토리
OpenClaw는 짧은 기간 동안 두 번이나 이름이 바뀌는 파란만장한 여정을 거쳤습니다.
| 날짜 | 이름 | 사유 |
|---|---|---|
| 2025년 11월 | Clawdbot | 최초 출시 - Claude + claw(집게)의 언어유희 |
| 2026년 1월 27일 | Moltbot | Anthropic의 상표권 요청으로 변경 |
| 2026년 1월 30일 | OpenClaw | ”최종 리셋” - 오픈소스 정체성 강조 |
| 2026년 2월 14일 | OpenAI 합류 | Steinberger가 OpenAI에 합류, 재단 이관 발표 |
처음 Clawdbot이라는 이름으로 출시했을 때, 이 프로젝트는 빠르게 인기를 얻었습니다. 하지만 Anthropic이 “Claud”라는 단어가 들어간 이름에 대해 상표권 관련 요청을 보내면서 급하게 Moltbot으로 변경해야 했는데요. “Molt”는 갑각류가 껍데기를 벗는 “탈피”를 의미하는 단어로, 랍스터 마스코트와의 연관성을 유지하면서도 상표 문제를 피하려는 선택이었습니다.
그러나 불과 3일 만에 다시 OpenClaw로 이름이 바뀌었습니다. 개발자는 이를 “최종 리셋(final reset)“이라고 표현했는데요, 이번에는 프로젝트의 오픈소스 정체성을 명확히 하고 싶었다고 합니다. “Claw”라는 단어를 유지하면서도 “Open”을 붙여 누구나 기여하고 사용할 수 있는 열린 프로젝트임을 강조한 것이죠.
커뮤니티의 반응은 대체로 긍정적이었습니다. 잦은 이름 변경에 혼란스러워하는 목소리도 있었지만, 오픈소스 정신을 명시적으로 드러낸 새 이름을 환영하는 의견이 더 많았습니다.
그리고 2026년 2월 14일, 또 한 번의 큰 전환점이 찾아왔습니다. OpenClaw의 개발자 Peter Steinberger가 Sam Altman의 초대를 받아 OpenAI에 합류한다고 발표한 것인데요. Altman은 “차세대 개인 에이전트”를 함께 만들자며 Steinberger를 영입했다고 합니다. 이에 따라 OpenClaw 프로젝트는 독립적인 오픈소스 재단으로 이관될 예정이며, OpenAI가 재단의 후원을 약속했습니다. 창시자가 떠나도 프로젝트가 지속될 수 있는 거버넌스 구조를 미리 마련한 셈이죠.
왜 OpenClaw일까?
기존의 AI 코딩 도구들, 예를 들어 클로드 코드나 Cursor 같은 도구들은 주로 개발 환경에서 사용됩니다. 하지만 OpenClaw는 조금 다른 접근 방식을 취하는데요. 우리가 이미 매일 사용하는 메신저 앱을 AI의 인터페이스로 활용한다는 점이 핵심입니다.
이 방식의 장점은 명확합니다. 우선 새로운 인터페이스를 배울 필요가 없습니다. 카카오톡이나 Slack에서 친구에게 메시지를 보내듯이 AI에게 작업을 요청하면 됩니다. “내일 오후 2시에 팀 미팅 일정 잡아줘”, “이번 주 날씨 알려주고 우산 필요한 날 체크해줘”, “아까 공유한 PDF 요약해줘” 같은 메시지를 보내면 AI가 바로 처리해줍니다. 모바일에서도 자연스럽게 AI와 대화할 수 있어서 이동 중에도 복잡한 작업을 지시할 수 있고요.
여러 채널을 목적에 맞게 구분해서 사용하면 더욱 효율적인데요. 예를 들어 Slack은 업무 관련 질문과 알림용으로, WhatsApp은 개인 작업과 리마인더용으로, Telegram은 빠른 메모와 아이디어 캡처용으로 활용할 수 있습니다. 채널별로 기본 에이전트를 다르게 설정할 수도 있어서, 각 채널의 성격에 맞는 AI 응답을 받을 수 있습니다.
설치하기
OpenClaw는 명령어 한 줄로 아주 간단히 설치할 수 있습니다.
MacOS에는 터미널에서 다음 명령어를 사용합니다.
curl -fsSL https://openclaw.ai/install.sh | bashWindows라면 PowerShell에서 다음 명령어를 사용합니다.
iwr -useb https://openclaw.ai/install.ps1 | iex설치 명령어를 실행하면 다음과 같은 출력을 볼 수 있습니다. Node.js가 설치되어 있지 않다면 자동으로 설치해주는데 시간이 좀 걸릴 수 있습니다.
$ curl -fsSL https://openclaw.ai/install.sh | bash
🦞 OpenClaw Installer
The UNIX philosophy meets your DMs.
✓ Detected: macos
Install plan
OS: macos
Install method: npm
Requested version: latest
[1/3] Preparing environment
✓ Homebrew already installed
· Node.js not found, installing it now
· Installing Node.js via Homebrew
Linking /opt/homebrew/Cellar/node@22/22.22.1_1... 2308 symlinks created.
If you need to have this software first in your PATH instead consider running:
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
✓ Node.js installed
· Active Node.js: v22.22.1 (/opt/homebrew/opt/node@22/bin/node)
· Active npm: 10.9.4 (/opt/homebrew/opt/node@22/bin/npm)
[2/3] Installing OpenClaw
✓ Git already installed
· Installing OpenClaw v2026.3.2
✓ OpenClaw npm package installed
✓ OpenClaw installed
[3/3] Finalizing setup
🦞 OpenClaw installed successfully (2026.3.2)!
All done! I promise to only judge your code a little bit.
· Starting setup초기 설정
설치 후에는 바로 온보딩(onboarding) 마법사를 통해서 초기 설정이 진행됩니다.
만약에 온보딩 마법사가 자동으로 실행되지 않으면 아래 명령어를 직접 실행하세요.
$ openclaw onboard제일 먼저 ASCII 아트와 함께 환영 메시지가 나타나며, 그 다음 에이전트의 강력한 권한에 대한 보안 경고가 표시됩니다.
🦞 OpenClaw 2026.3.2 (85377a2)
I can run local, remote, or purely on vibes—results may vary with DNS.
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
🦞 OPENCLAW 🦞
┌ OpenClaw onboarding
│
◇ Security ─────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Security warning — please read. │
│ │
│ OpenClaw is a hobby project and still in beta. Expect sharp edges. │
│ By default, OpenClaw is a personal agent: one trusted operator boundary. │
│ This bot can read files and run actions if tools are enabled. │
│ A bad prompt can trick it into doing unsafe things. │
│ │
│ OpenClaw is not a hostile multi-tenant boundary by default. │
│ If multiple users can message one tool-enabled agent, they share that delegated tool │
│ authority. │
│ │
│ If you’re not comfortable with security hardening 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. │
│ - Multi-user/shared inbox: split trust boundaries (separate gateway/credentials, ideally │
│ separate OS users/hosts). │
│ - Sandbox + least-privilege tools. │
│ - Shared inboxes: isolate DM sessions (`session.dmScope: per-channel-peer`) and keep │
│ tool access minimal. │
│ - 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 personal-by-default and shared/multi-user use requires lock-down. Continue?
│ YesOpenClaw 에이전트는 명령 실행, 파일 읽기/쓰기, 도구 사용 등 시스템에 대한 상당한 접근 권한을 가질 수 있습니다. 특히 처음 사용한다면 샌드박스 모드와 최소 권한 원칙을 적용하는 것이 좋습니다.
QuickStart 모드
기본적으로 QuickStart 모드가 선택되며, 다음과 같은 설정이 자동으로 구성됩니다.
◇ Onboarding mode
│ QuickStart
│
◇ QuickStart ─────────────────────────╮
│ │
│ Gateway port: 18789 │
│ Gateway bind: Loopback (127.0.0.1) │
│ Gateway auth: Token (default) │
│ Tailscale exposure: Off │
│ Direct to chat channels. │
│ │
├──────────────────────────────────────╯Gateway 포트는 18789이고, 바인딩은 Loopback(127.0.0.1)으로 설정되어 로컬에서만 접근할 수 있습니다. 인증은 Token 기반이며, Tailscale 노출은 비활성화되어 있습니다.
AI Provider 및 모델 선택
OpenAI, Anthropic, Google, OpenRouter 등 여러 AI provider를 선택할 수 있습니다.
◇ Model/auth provider
│ OpenAI
│
◇ OpenAI auth method
│ OpenAI API key
│
◇ How do you want to provide this API key?
│ Paste API key now
│
◇ Enter OpenAI API key
│ 🔑
│
◇ Model configured ──────────────────────────╮
│ │
│ Default model set to openai/gpt-5.1-codex │
│ │
├─────────────────────────────────────────────╯
│
◇ Default model
│ Keep current (openai/gpt-5.1-codex)여기서 중요한 주의사항이 있습니다.
OpenClaw 공식 문서에서는 Anthropic Claude를 추천하지만, Claude Pro/Max 구독을 OpenClaw와 함께 사용하면 계정이 차단될 수 있습니다.
Anthropic은 Pro/Max 구독을 공식 인터페이스(Claude Web, Claude Code CLI)에서만 사용하도록 의도했기 때문에, OpenClaw 같은 서드파티 도구로 연결하는 것을 TOS 위반으로 간주합니다. 특히 Max 크레딧을 OpenClaw에서 사용하면 즉시 계정이 차단될 수 있다고 합니다.
안전하게 사용하려면 Anthropic API 키(종량제)를 발급받아 사용하는 것이 가장 좋습니다. 공식 API를 통한 사용은 문제가 없거든요. 아니면 OpenAI API 키나 OpenAI Codex를 연동하거나, Google이나 OpenRouter 같은 다른 provider를 선택하는 방법도 있습니다.
메시징 채널 선택
Telegram, WhatsApp, Discord, iMessage 등 원하는 메시징 플랫폼을 선택합니다. 처음 사용하시는 분들에게는 보통 Telegram을 추천합니다.
◇ Select channel (QuickStart)
│ Telegram (Bot API)
│
◇ Telegram bot token ───────────────────────────────────────────────────────────────────╮
│ │
│ 1) Open Telegram and chat with @BotFather │
│ 2) Run /newbot (or /mybots) │
│ 3) Copy the token (looks like 123456:ABC...) │
│ Tip: you can also set TELEGRAM_BOT_TOKEN in your env. │
│ Docs: https://docs.openclaw.ai/telegram │
│ Website: https://openclaw.ai │
│ │
├────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ How do you want to provide this Telegram bot token?
│ Enter Telegram bot token
│
◇ Enter Telegram bot token
│ 🔑
│
◇ Selected channels ────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Telegram — simplest way to get started — register a bot with @BotFather and get going. │
│ https://docs.openclaw.ai/channels/telegram │
│ https://openclaw.ai │
│ │
├────────────────────────────────────────────────────────────────────────────────────────────────────╯
Updated ~/.openclaw/openclaw.json
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions온보딩 마법사에서는 하나의 채널을 선택하며, 나중에 추가로 채널을 연동할 수 있습니다.
OpenClaw가 지원하는 메시징 채널 목록을 보면 정말 놀랍습니다.
- WhatsApp: Baileys 라이브러리 기반, 자신의 전화번호 사용, 별도 eSIM 권장
- Telegram: grammY 프레임워크 사용, 가장 간단하게 시작 가능, @BotFather로 봇 등록
- Discord: discord.js 기반, Discord Bot으로 설정, 잘 지원됨
- Slack: Bolt SDK 활용, Socket Mode 지원
- Signal: signal-cli 연동, 설정이 다소 복잡함
- iMessage: macOS에서 imsg를 통해 지원, BlueBubbles를 통한 연동도 가능
- Microsoft Teams: Bot Framework 기반, 엔터프라이즈 지원
- Google Chat: Chat API 연동, Google Workspace 앱
- Twitch: 채팅 채널 연동
- WebChat: 웹 브라우저에서 직접 대화 가능
- IRC: 전통적인 IRC 채널 지원
- 기타: Nostr, Mattermost, Nextcloud Talk, Matrix, BlueBubbles, LINE, Zalo Personal, Feishu, Synology Chat, Tlon 등 플러그인 설치로 추가 가능
이렇게 다양한 채널을 지원하기 때문에 여러분이 선호하는 플랫폼이 무엇이든 OpenClaw를 활용할 수 있습니다.
Skills 설정
에이전트에게 특정 작업 방법을 안내하는 스킬을 설치할 수 있습니다.
◇ Configure skills now? (recommended)
│ Yes
│
◆ Install missing skill dependencies
│ ◻ Skip for now
│ ◻ 🔐 1password
│ ◻ 📝 apple-notes (Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move,…)
│ ◻ ⏰ apple-reminders (Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports li…)
│ ◻ 🐻 bear-notes
│ ◻ 📰 blogwatcher (Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI. — Install blogwat…)
│ ◻ 🫐 blucli
│ ◻ 📸 camsnap (Capture frames or clips from RTSP/ONVIF cameras. — Install camsnap (brew))
│ ◻ 🧩 clawhub (Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com…)
│ ◻ 🎛️ eightctl
│ ◻ ♊️ gemini
│ ◻ 🧲 gifgrep
│ ◻ 🐙 github (GitHub operations via `gh` CLI: issues, PRs, CI runs, code review, API queries. Use when:…)
│ ◻ 🎮 gog
│ ◻ 📍 goplaces (Query Google Places API (New) via the goplaces CLI for text search, place details, resolv…)
│ ◻ 📧 himalaya (CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, …)
│ ◻ 📨 imsg (iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app. — Ins…)
│ ◻ 📦 mcporter
│ ◻ 📊 model-usage (Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, inclu…)
│ ◻ 🍌 nano-banana-pro (Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro). — Install uv (brew))
│ ◻ 📄 nano-pdf (Edit PDFs with natural-language instructions using the nano-pdf CLI. — Install nano-pdf (…)
│ ◻ 💎 obsidian (Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli. — Install…)
│ ◻ 🎙️ openai-whisper (Local speech-to-text with the Whisper CLI (no API key). — Install OpenAI Whisper (brew))
│ ◻ 💡 openhue
│ ◻ 🧿 oracle
│ ◻ 🛵 ordercli
│ ◻ 👀 peekaboo
│ ◻ 🗣️ sag (ElevenLabs text-to-speech with mac-style say UX. — Install sag (brew))
│ ◻ 🌊 songsee
│ ◻ 🔊 sonoscli
│ ◻ 🧾 summarize (Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallbac…)
│ ◻ ✅ things-mac
│ ◻ 🎞️ video-frames (Extract frames or short clips from videos using ffmpeg. — Install ffmpeg (brew))
│ ◻ 📱 wacli
│ ◻ 𝕏 xurl (A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when …)
◇ Preferred node manager for skill installs
│ bun
Hooks 설정
Hooks는 에이전트 명령 실행 시 자동화 작업을 트리거하는 기능이며, 나중에 설정할 수 있습니다.
◇ Hooks ──────────────────────────────────────────────────────────────────╮
│ │
│ Hooks let you automate actions when agent commands are issued. │
│ Example: Save session context to memory when you issue /new or /reset. │
│ │
│ Learn more: https://docs.openclaw.ai/automation/hooks │
│ │
├──────────────────────────────────────────────────────────────────────────╯
│
◆ Enable hooks?
│ ◻ Skip for now
│ ◻ 🚀 boot-md
│ ◻ 📎 bootstrap-extra-files
│ ◻ 📝 command-logger (Log all command events to a centralized audit file)
│ ◻ 💾 session-memory
└Gateway 서비스 설치 및 실행
--install-daemon 옵션을 사용했다면 Gateway가 백그라운드 서비스로 설치됩니다.
◒ Installing Gateway service…
│
◇ Gateway service installed
│
◇ Control UI ──────────────────────────────────────────────────────────╮
│ Web UI: http://127.0.0.1:18789/ │
│ Web UI (with token): │
│ http://127.0.0.1:18789/?token=... │
│ Gateway WS: ws://127.0.0.1:18789 │
│ Gateway: reachable │
├──────────────────────────────────────────────────────────────────────╯설치 후 Control UI에 접근할 수 있는 URL과 WebSocket 주소가 표시됩니다.
봇 깨우기 (TUI)
마지막 단계로 봇을 어떻게 깨울지 선택하는 프롬프트가 나타납니다.
◇ How do you want to hatch your bot?
│ Hatch in TUI (recommended)TUI(Terminal User Interface)를 선택하면 “Wake up, my friend!” 메시지와 함께 봇이 처음으로 응답하는 감동적인 순간을 경험하게 됩니다.
Hey — I'm awake. Good to see you.
Quick notes:
- I read SOUL.md and USER.md to get oriented.
- I couldn't find MEMORY.md or today's memory file (memory/2026-02-02.md) —
looks like no persistent memories recorded yet.
What would you like me to do first?
- Pick a name for me and I'll write IDENTITY.md
- Bootstrapping: go through the questions in BOOTSTRAP.md with you
- Check something (calendar, files, run a command)
- Or just chat — I'm here.
Your move.Gateway 상태 확인
온보딩이 완료되면 Gateway가 정상적으로 실행 중인지 확인할 수 있습니다.
$ openclaw gateway status
🦞 OpenClaw 2026.3.2 (85377a2) — I speak fluent bash, mild sarcasm, and aggressive tab-completion energy.
│
◇ Doctor warnings ──────────────────────────────────────────────────────────────────────────╮
│ │
│ - channels.telegram.groupPolicy is "allowlist" but groupAllowFrom (and allowFrom) is │
│ empty — all group messages will be silently dropped. Add sender IDs to │
│ channels.telegram.groupAllowFrom or channels.telegram.allowFrom, or set groupPolicy to │
│ "open". │
│ │
├────────────────────────────────────────────────────────────────────────────────────────────╯
│
◇
Service: LaunchAgent (loaded)
File logs: /tmp/openclaw/openclaw-2026-03-07.log
Command: /opt/homebrew/opt/node@22/bin/node /opt/homebrew/lib/node_modules/openclaw/dist/index.js gateway --port 18789
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Service env: OPENCLAW_GATEWAY_PORT=18789
Config (cli): ~/.openclaw/openclaw.json
Config (service): ~/.openclaw/openclaw.json
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.
Runtime: running (pid 29180, state active)
RPC probe: ok
Listening: 127.0.0.1:18789
Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting눈여겨볼 정보를 정리하면 이렇습니다.
- Service: macOS LaunchAgent로 실행 중
- Config 파일: ~/.openclaw/openclaw.json
- Gateway 주소: ws://127.0.0.1:18789
- Dashboard: http://127.0.0.1:18789/
- Runtime: Gateway가 정상 실행 중 (RPC probe: ok)
Gateway를 관리하기 위한 기본 명령어들도 알아두면 좋습니다.
우선 Gateway가 정상적으로 실행 중인지 확인하려면 openclaw gateway status 명령을 사용하면 됩니다.
이 명령은 데몬의 상태와 마지막 접속 세션 정보를 보여줍니다.
Gateway가 중지되어 있을 때는 openclaw gateway start로 백그라운드로 시작할 수 있습니다.
설정을 변경한 후나 문제를 해결하기 위해 Gateway를 재시작해야 한다면 openclaw gateway restart를 사용하면 됩니다.
마지막으로 Gateway를 안전하게 중지하려면 openclaw gateway stop을 실행하면 됩니다.
macOS, Linux, Windows(WSL2 권장) 모두에서 작동합니다.
아키텍처 이해하기
OpenClaw의 핵심은 Gateway라는 컨트롤 플레인입니다.
Gateway는 WebSocket을 통해 ws://127.0.0.1:18789에서 실행되며, 모든 채널과 도구들을 연결하는 허브 역할을 합니다.
WhatsApp / Telegram / Slack / Discord / Signal / iMessage / ...
│
▼
┌───────────────────────┐
│ Gateway │
│ (컨트롤 플레인) │
│ ws://127.0.0.1:18789 │
└───────────┬───────────┘
│
├─ Pi agent (RPC)
├─ CLI (openclaw …)
├─ WebChat UI
├─ macOS app
└─ iOS / Android nodesGateway는 단순한 메시지 라우터를 넘어서 세션 관리, 도구 실행, 이벤트 처리까지 두루 담당합니다.
디렉토리 구조
OpenClaw를 설치하면 두 개의 주요 디렉토리가 생성되는데요, 각각의 역할이 명확히 구분됩니다.
~/.openclaw/ 디렉토리는 시스템 레벨의 설정과 상태를 저장하는 곳입니다.
여기에는 openclaw.json 설정 파일이 있어서 Gateway 설정, 채널 설정, 모델 설정 등을 관리합니다.
또한 .env 파일에는 OpenAI API 키 같은 환경 변수가 저장되고, agents/ 폴더에는 에이전트 세션 데이터가, logs/ 폴더에는 Gateway 로그가 기록됩니다.
identity/, cron/, devices/ 같은 폴더들도 디바이스 식별, 자동화, 디바이스 관리 등의 용도로 사용됩니다.
반면 ~/clawd/ 디렉토리는 AI 에이전트의 워크스페이스입니다.
여기에는 에이전트의 동작을 정의하는 프롬프트 파일들이 있는데요, AGENTS.md는 에이전트의 기본 설정을, SOUL.md는 에이전트의 성격을, TOOLS.md는 사용 가능한 도구를, USER.md는 사용자 정보를 정의합니다.
BOOTSTRAP.md와 IDENTITY.md는 에이전트를 처음 깨울 때 사용되며, skills/ 폴더에 커스텀 스킬을 추가할 수 있고, memory/ 폴더에는 에이전트의 장기 기억이 저장됩니다.
간단히 말하면 ~/.openclaw는 “어떻게 실행되는가”(설정, 로그, 상태)를 담당하고, ~/clawd는 “무엇을 하는가”(AI의 성격, 스킬, 메모리)를 정의합니다.
마치 Node.js의 전역 설정 폴더와 프로젝트 폴더처럼, 시스템 설정과 작업 공간이 분리되어 있는 구조입니다.
터미널에서 채팅하기
Gateway를 설치하고 나면 터미널에서 직접 AI와 채팅할 수 있습니다.
가장 권장되는 방법은 TUI(Terminal User Interface)를 사용하는 것인데요, openclaw tui 명령으로 실행할 수 있습니다.
TUI는 대화형 인터페이스로 실시간으로 AI의 응답을 스트리밍으로 받아볼 수 있으며, 세션 및 에이전트 정보, 토큰 사용량도 함께 표시해줍니다.
키보드 단축키도 지원하기 때문에 편리하게 대화를 이어갈 수 있습니다.
일회성 질문이나 스크립트에서 사용하려면 agent 명령어가 더 적합합니다.
예를 들어 openclaw agent --message "오늘 할 일 목록 정리해줘"처럼 사용할 수 있는데요, --thinking 옵션으로 사고 수준을 조절할 수 있고, --session 옵션으로 특정 세션을 지정할 수도 있습니다.
복잡한 질문을 할 때는 --thinking high를 추가하면 AI가 더 깊이 생각하도록 유도할 수 있습니다.
# 높은 사고 수준으로 복잡한 질문하기
openclaw agent --message "React와 Vue의 차이점을 상세히 설명해줘" --thinking high
# 특정 세션에서 대화 이어가기
openclaw agent --message "방금 설명한 내용을 정리해줘" --session my-session
# 파일 첨부하여 질문하기
openclaw agent --message "이 코드 리뷰해줘" --file ./src/main.ts메시징 채널을 통해 직접 메시지를 보내야 한다면 message 명령어를 사용할 수 있습니다.
openclaw message send --to +1234567890 --message "Hello from OpenClaw"처럼 사용하면 WhatsApp, Telegram 등 연동된 채널을 통해 다른 사람이나 봇에게 메시지를 전송할 수 있습니다.
주요 기능
OpenClaw는 단순한 챗봇을 넘어서 정말 많은 기능을 제공합니다. 최신 v2026.3.2에서는 특히 주목할 만한 기능들이 추가되었는데요.
- Claude Opus 4.6 adaptive reasoning: Claude의 최신 모델에서 제공하는 적응형 추론을 지원하여 복잡한 질문에 더 정교한 답변을 생성합니다
- SecretRef 자격증명 관리: API 키나 토큰 같은 민감한 자격증명을 안전하게 관리할 수 있으며, 64개 통합 대상을 지원합니다
- OpenAI WebSocket 스트리밍: OpenAI 모델 사용 시 WebSocket 기반 스트리밍이 기본값으로 설정되어 응답 지연이 크게 줄었습니다
- Listen-only 채널 모드: 채널에서 메시지를 읽기만 하고 응답하지 않는 모니터링 전용 모드로, 안전한 관찰이 필요한 상황에 유용합니다
- 시각적 권한 대시보드: 에이전트에게 부여된 권한을 한눈에 확인하고 관리할 수 있는 대시보드가 추가되었습니다
- Agent-to-agent 조율: 여러 에이전트가 서로 협력하여 복잡한 작업을 분담하고 처리할 수 있는 조율 기능이 도입되었습니다
브라우저 제어
OpenClaw는 전용 Chrome/Chromium 인스턴스를 관리하며 CDP(Chrome DevTools Protocol)를 통해 웹 페이지와 상호작용할 수 있습니다. 웹 페이지의 스크린샷을 찍거나, 특정 요소를 클릭하거나, 폼을 채우는 등의 작업을 AI에게 지시할 수 있어서 브라우저 자동화에 유용합니다.
브라우저 제어를 사용하려면 먼저 CDP 설정이 필요합니다.
// ~/.openclaw/openclaw.json
{
browser: {
cdp: {
enabled: true,
port: 9222,
headless: false, // true면 화면 없이 실행
},
},
}설정 후 AI에게 다음과 같은 작업을 요청할 수 있습니다.
“GitHub에서 내 저장소 목록을 스크린샷으로 찍어줘”
“Hacker News 오늘 인기 기사 Top 5를 스크린샷과 함께 보내줘”
“Amazon에서 ‘무선 키보드’ 검색하고 가격 비교표 만들어줘”
Voice Wake & Talk Mode
macOS, iOS, Android에서 항상 켜져 있는 음성 인식 기능을 제공합니다. ElevenLabs와 연동되어 자연스러운 음성으로 AI와 대화할 수 있어서, 마치 음성 비서처럼 사용할 수 있습니다.
Voice Wake를 설정하려면 먼저 ElevenLabs API 키가 필요합니다.
# ElevenLabs API 키 설정
openclaw config set elevenlabs.apiKey "your-api-key"
# Voice Wake 활성화
openclaw voice enable --wake-word "hey claw"
# 음성 선택 (선택사항)
openclaw voice set-voice "Rachel" # ElevenLabs 음성 중 선택설정이 완료되면 “Hey Claw”라고 말해서 에이전트를 깨우고 음성으로 대화할 수 있습니다. Push-to-talk 모드도 지원하는데요, macOS 앱에서는 Option 키를 길게 눌러 음성 입력을 시작할 수 있습니다.
Canvas (A2UI)
Canvas는 에이전트가 직접 제어하는 시각적 워크스페이스입니다. A2UI(Agent-to-User Interface)라고도 불리는 이 기능은 AI가 생성한 UI를 실시간으로 렌더링하고 상호작용할 수 있게 해줍니다.
Canvas를 활용하면 AI가 데이터를 시각화한 차트나 그래프를 실시간으로 표시하는 대시보드를 만들 수 있습니다. 사용자 입력이 필요하면 AI가 폼을 생성하여 보여주기도 하고, 이미지나 비디오 같은 미디어를 직접 렌더링하기도 합니다. 버튼이나 슬라이더 같은 인터랙티브한 UI 요소도 지원하는데요, 예를 들어 “지난달 지출 내역을 파이 차트로 보여줘”라고 요청하면 AI가 Canvas에 인터랙티브한 차트를 바로 그려줍니다.
자동화
크론 작업, 웹훅, Gmail Pub/Sub 등을 활용해 자동화 시나리오를 구현할 수 있습니다. “다운로드 폴더에서 일주일 지난 파일 정리해줘”나 “이 폴더의 사진들을 날짜별로 분류해줘” 같은 파일 관리 작업도 자동화할 수 있습니다.
# 매일 아침 7시에 일정 알림
openclaw cron add "0 7 * * *" --message "오늘 일정을 WhatsApp으로 보내줘" --channel whatsapp
# 매주 월요일 오전 9시에 주간 리포트
openclaw cron add "0 9 * * 1" --message "지난주 GitHub 활동을 요약해줘" --channel slack
# 등록된 크론 작업 확인
openclaw cron list
# 크론 작업 삭제
openclaw cron remove <cron-id>테스트 실패 시 Slack으로 알림을 받거나, GitHub PR이 올라오면 자동으로 리뷰하는 등의 워크플로우도 구성할 수 있습니다.
웹훅을 통한 자동화도 가능합니다.
// ~/.openclaw/openclaw.json
{
webhooks: {
"github-push": {
secret: "your-webhook-secret",
action: "GitHub에 새 푸시가 있습니다: {{payload.commits[0].message}}",
},
},
}Gmail Pub/Sub과 연동하면 특정 이메일을 받았을 때 자동으로 알림을 받거나 작업을 실행할 수도 있습니다.
Skills 시스템
OpenClaw는 Skills 시스템을 통해 기능을 확장할 수 있습니다.
스킬 로드 우선순위
스킬은 다음 우선순위로 로드됩니다. 숫자가 높을수록 우선순위가 높습니다.
- 번들 스킬 (최저) - OpenClaw에 기본 포함된 스킬
- 관리/로컬 스킬 (
~/.openclaw/skills) - 사용자가 전역으로 설치한 스킬 - 워크스페이스 스킬 (
<workspace>/skills) (최고) - 프로젝트별 커스텀 스킬
같은 이름의 스킬이 여러 위치에 있으면 우선순위가 높은 것이 사용됩니다.
ClawHub 레지스트리
ClawHub는 OpenClaw 커뮤니티의 스킬 레지스트리입니다. npm이 자바스크립트 패키지를 위한 것이라면, ClawHub는 AI 에이전트 스킬을 위한 생태계입니다.
예를 들어 github-pr 스킬을 설치하면 “GitHub PR #123 리뷰해주고 코멘트 달아줘”나 “지난주 커밋 히스토리 분석해서 생산성 리포트 만들어줘” 같은 요청을 처리할 수 있게 됩니다.
# 개별 스킬 설치
clawhub install obsidian
# 여러 스킬 한 번에 설치 - github-pr 스킬로 PR 리뷰, 커밋 분석 등 가능
clawhub install github-pr slack-notify calendar
# 설치된 스킬 일괄 업데이트
clawhub update --all
# 내가 만든 스킬을 레지스트리에 게시
clawhub sync --all
# 스킬 검색
clawhub search "productivity"기존의 npx skills 명령어도 여전히 작동합니다.
# GitHub 저장소에서 직접 설치
npx skills add vercel-labs/agent-skills --all
# skills.sh에서 검색
npx skills find커스텀 스킬 작성
직접 커스텀 스킬을 만들고 싶다면 워크스페이스 루트(기본값: ~/clawd)에 skills/<skill-name>/SKILL.md 파일을 생성하면 됩니다.
---
name: my-custom-skill
description: 나만의 워크플로우를 자동화하는 스킬
version: 1.0.0
author: your-name
---
# My Custom Skill
이 스킬은 다음 작업을 수행합니다:
- 매일 아침 뉴스 요약
- 중요 이메일 필터링
- 일정 관리 도우미
## 사용 방법
"오늘 뉴스 요약해줘"라고 말하면 ...AGENTS.md, SOUL.md, TOOLS.md 같은 프롬프트 파일도 자동으로 인젝션되어 AI의 동작을 커스터마이징할 수 있습니다.
설치된 스킬을 확인하려면 openclaw skills list 명령을 사용하면 되고, 스킬의 상세 정보는 openclaw skills info로 볼 수 있습니다.
또한 openclaw skills check 명령으로 어떤 스킬이 사용 가능한지, 어떤 스킬이 의존성이 부족한지 확인할 수 있습니다.
보안 주의
서드파티 스킬은 신뢰할 수 없는 코드로 취급해야 합니다. 스킬 내의 코드는 시스템 명령을 실행하거나 파일에 접근할 수 있으므로, 항상 소스를 확인하고 샌드박스 환경에서 먼저 테스트하는 것을 권장합니다.
# 스킬 설치 전 소스 검토
clawhub inspect some-skill
# 샌드박스에서 스킬 테스트
openclaw agent --sandbox --message "새로 설치한 스킬 테스트해줘"보안 모델
OpenClaw는 실제 메시징 플랫폼과 연결되기 때문에 보안이 매우 중요합니다.
DM 정책 옵션
알 수 없는 발신자로부터의 DM(Direct Message)을 처리하는 4가지 정책을 제공합니다.
| 정책 | 설명 | 사용 사례 |
|---|---|---|
pairing (기본값) | 1시간 유효 페어링 코드 요구 | 대부분의 사용자에게 권장 |
allowlist | 승인된 번호/사용자만 허용 | 제한된 접근이 필요할 때 |
open | 모든 DM 허용 | 공개 봇 운영 시 (신중히 사용) |
disabled | 모든 DM 무시 | 그룹 채팅 전용 봇 |
// ~/.openclaw/openclaw.json
{
security: {
dm: {
policy: "pairing", // 기본값
pairingTtl: 3600, // 페어링 코드 유효 시간 (초)
},
},
}페어링 코드를 승인하려면 다음 명령을 실행합니다.
openclaw pairing approve <channel> <code>샌드박스 설정
그룹/채널 세션의 경우 Docker 샌드박스 내에서 실행되도록 설정할 수 있어서, 신뢰할 수 없는 입력으로부터 시스템을 보호할 수 있습니다.
// ~/.openclaw/openclaw.json
{
agents: {
defaults: {
sandbox: {
mode: "all", // "all", "non-main", "none"
scope: "agent", // "agent", "session"
workspaceAccess: "ro", // "ro" (읽기전용), "rw", "none"
},
},
},
}all로 설정하면 모든 세션이 샌드박스에서 실행되고, non-main은 메인 세션을 제외한 나머지만 샌드박스에서 실행합니다.
none은 샌드박스를 완전히 비활성화하는데, 보안상 권장하지 않습니다.
그룹 채팅 보안
공개 그룹 채팅에서는 추가적인 보안 설정이 필요합니다.
{
channels: {
discord: {
requireMention: true, // @OpenClaw 멘션 필수
disabledCommands: [
"/reasoning", // 추론 과정 노출 방지
"/verbose", // 상세 로그 비활성화
"/system", // 시스템 명령 비활성화
],
},
},
}requireMention: true 설정을 사용하면 봇이 명시적으로 멘션되었을 때만 응답합니다.
공개 채팅에서는 /reasoning, /verbose 같은 민감한 명령을 비활성화하는 것이 좋습니다.
보안 이슈 사례
2026년 초 Cisco AI 보안 팀이 서드파티 스킬에서 데이터 유출과 프롬프트 인젝션 취약점을 발견한 바 있습니다.
이를 계기로 v2026.2.23에서는 HTTP 보안 헤더 강화와 Strict-Transport-Security 적용 등 보안이 한층 강화되었는데요.
서드파티 스킬을 사용할 때는 항상 출처를 확인하고, 가능하면 샌드박스 환경에서 먼저 테스트하는 것이 좋습니다.
보안 감사
정기적으로 보안 감사를 실행하여 잠재적인 취약점을 확인하세요.
# 기본 보안 검사
openclaw security audit
# 심층 보안 검사 (스킬, 설정, 권한 모두 검사)
openclaw security audit --deep
# 특정 채널만 검사
openclaw security audit --channel whatsappCompanion Apps
OpenClaw는 여러 플랫폼을 위한 컴패니언 앱도 제공합니다.
macOS 앱
macOS 앱은 메뉴 바에서 Gateway를 편리하게 제어할 수 있게 해줍니다.
- 메뉴 바 상태: Gateway 실행 상태를 한눈에 확인하고 시작/중지
- Voice Wake + Push-to-Talk: Option 키를 길게 눌러 음성 입력, “Hey Claw”로 깨우기
- WebChat 내장: 앱 내에서 바로 AI와 대화
- 디버그 도구: 로그 뷰어, 세션 관리, 설정 편집기
시스템 요구사항: macOS 14+ (Sonoma 이상), Apple Silicon / Intel Universal Binary
# Homebrew로 설치
brew install --cask openclaw
# 또는 직접 다운로드
open https://openclaw.ai/download/macosiOS 앱
iOS 앱은 iPhone과 iPad에서 OpenClaw의 모든 기능을 활용할 수 있게 합니다.
- Bridge 페어링: 같은 네트워크의 Gateway와 Bonjour를 통해 자동 연결
- Voice Wake: 잠금 화면에서도 “Hey Claw”로 에이전트 깨우기
- Canvas 지원: AI가 생성한 UI를 모바일에서 확인
- 카메라 연동: “이 사진에 뭐가 보여?” 같은 비전 작업
# 페어링된 노드 확인
openclaw nodes
# 특정 노드로 메시지 전송
openclaw nodes send --node "iPhone" --message "테스트"App Store에서 “OpenClaw”를 검색하여 설치할 수 있습니다.
Android 앱
Android 앱도 iOS와 유사한 기능을 제공합니다.
- Bridge + 페어링: QR 코드 또는 페어링 코드로 Gateway와 연결
- Canvas 지원: 인터랙티브 UI 표시
- 카메라 및 화면 캡처: 비전 작업 및 화면 공유
- SMS 권한: 권한 부여 시
sms.send기능으로 문자 전송 가능
// Android에서 SMS 기능 활성화
{
android: {
permissions: {
sms: true,
camera: true,
screenCapture: true,
},
},
}Google Play Store에서 “OpenClaw”를 검색하여 설치할 수 있습니다.
마치며
OpenClaw는 Clawdbot으로 시작해서 Moltbot을 거쳐 지금의 이름에 도달했고, 창시자 Peter Steinberger의 OpenAI 합류와 독립 재단 이관이라는 새로운 전환점을 맞이하고 있습니다. 짧은 시간 동안 격동의 변화를 겪었지만, 프로젝트의 핵심 가치는 변하지 않았습니다. 우리가 이미 익숙하게 사용하는 메신저 플랫폼에서 AI 비서를 만날 수 있다는 것, 그리고 이 모든 것이 오픈소스라는 것.
GitHub 275,000개 이상의 스타를 기록하며 React를 추월했는데요, 출시 약 60일 만에 이뤄낸 놀라운 성과입니다. 터미널이나 IDE에서 벗어나 WhatsApp이나 Telegram에서 자연스럽게 AI와 대화하면서 복잡한 작업을 처리할 수 있다는 것은 정말 매력적인 경험입니다.
모바일에서도 AI 기능을 마음껏 활용할 수 있고, 브라우저 제어나 자동화 같은 도구를 메신저로 접근할 수 있다는 점이 돋보입니다. Canvas(A2UI)로 시각적 인터페이스를 만들고, Voice Wake로 음성 대화를 하고, Skills로 기능을 끝없이 확장할 수 있으니까요. 재단 이관이 완료되면 커뮤니티 주도의 거버넌스 아래 프로젝트가 더욱 안정적으로 발전해 나갈 것으로 기대됩니다.
시스템 설정을 조정하고 싶다면 OpenClaw 설정 가이드를, 에이전트의 성격과 기억을 커스터마이징하고 싶다면 워크스페이스 가이드를 참고하세요. OpenClaw 에이전트들이 모여서 어떤 일을 벌이는지 궁금하다면 Moltbook: AI 에이전트들의 소셜 네트워크도 읽어보세요.
더 자세한 정보는 공식 문서와 GitHub 저장소에서 확인할 수 있습니다. 궁금한 점이 있다면 Discord 커뮤니티에서 언제든지 질문해주세요!
This work is licensed under
CC BY 4.0
