OpenClaw 명령어 완전 해설 2026: /run·/ask·/clear 모든 커맨드의 뜻과 올바른 사용법
이 글에서 다루는 내용: OpenClaw의 모든 내장 명령어(/run, /ask, /clear, /memory, /skill, /status 등)의 정확한 의미와 올바른 사용법을 예시와 함께 완전 해설합니다. X.com에서 "CLI가 낯설다"고 했던 수많은 사용자들을 위한 실전 커맨드 완전 가이드입니다.
OpenClaw 명령어 체계: 왜 알아야 하는가
2026년 X.com에서 OpenClaw 돌풍이 일었을 때, 가장 많이 등장한 불만 중 하나는 "CLI가 완전 새로운 인터페이스라서 새벽 2시인데도 멈출 수 없었다"는 말이었습니다. @marvelgirl_eth는 "전혀 기술적이지 않은 초보자인데 CLI가 낯설다, 그래도 중독됐다"고 고백했습니다. 명령어를 제대로 알면 이 중독의 힘이 몇 배는 커집니다.
OpenClaw의 명령어는 크게 두 가지 방식으로 사용됩니다. 첫 번째는 터미널(CLI)에서 직접 실행하는 방식이고, 두 번째는 텔레그램·WhatsApp·Discord 등 메신저 채팅창에서 슬래시(/) 명령어로 입력하는 방식입니다. 두 방식 모두 알아두면 어떤 상황에서든 OpenClaw를 완벽하게 제어할 수 있습니다.
⚠️ 많은 초보자가 혼동하는 것
OpenClaw는 일반 자연어 대화와 슬래시 명령어를 모두 받아들입니다. 슬래시 명령어(/run 등)는 시스템 수준 동작을 지시하고, 일반 문장은 AI가 의도를 파악해서 처리합니다. 어떤 것을 언제 써야 하는지가 핵심입니다.
핵심 CLI 명령어 완전 해설
아래 명령어들은 터미널에서 직접 실행하는 시스템 명령어입니다. openclaw 다음에 붙여서 사용합니다.
의미: OpenClaw의 초기 설정 마법사를 실행합니다. AI 모델 API 키, 메신저 봇 토큰, AI 비서의 이름과 성격, 사용자 정보 등을 대화 형식으로 설정합니다.
언제 쓰나: 처음 설치 후 반드시 한 번 실행해야 합니다. 이후에도 설정을 변경하고 싶을 때 다시 실행할 수 있습니다.
$ openclaw onboard
# → AI 모델 선택 (Claude/GPT/로컬)
# → API 키 입력
# → 봇 이름 설정 ("Jarvis", "Claudia" 등)
# → 메신저 연동 (텔레그램/WhatsApp/Discord)
의미: OpenClaw AI 비서를 백그라운드 서비스(데몬)로 시작합니다. 이 명령어를 실행해야 메신저에서 메시지를 보내도 응답을 받을 수 있습니다.
언제 쓰나: 컴퓨터를 켤 때마다 실행하거나, 부팅 시 자동 시작으로 설정해두는 것이 좋습니다.
$ openclaw start
# → OpenClaw 데몬 시작
# → 텔레그램/WhatsApp 연결 확인
# → "Claw is ready! 🦞" 메시지 수신
의미: 실행 중인 OpenClaw 데몬을 안전하게 종료합니다. 진행 중인 작업을 마무리하고 메신저 연결을 끊습니다.
주의: 강제 종료(Ctrl+C)보다 이 명령어를 쓰는 것이 안전합니다. 스킬 실행 중 강제 종료하면 파일이 손상될 수 있습니다.
의미: 현재 OpenClaw 데몬의 실행 상태, 연결된 AI 모델, 활성화된 메신저 채널, 로드된 스킬 목록을 한눈에 보여줍니다.
언제 쓰나: 메신저에서 응답이 없거나, 어떤 스킬이 활성화되어 있는지 확인하고 싶을 때 가장 먼저 실행해야 하는 진단 명령어입니다.
$ openclaw status
Status: 🟢 Running (PID: 12345)
Model: claude-opus-4.5
Channels: telegram ✓, discord ✓
Skills: gmail, calendar, github (3 loaded)
Uptime: 2h 34m
의미: OpenClaw의 실행 로그를 실시간으로 출력합니다. 오류가 발생했을 때 원인을 파악하는 데 필수적입니다.
$ openclaw logs --follow # 실시간 로그
$ openclaw logs --lines 50 # 마지막 50줄
메신저 채팅 슬래시 명령어 완전 해설
텔레그램, WhatsApp, Discord 등 메신저 채팅창에서 사용하는 슬래시(/) 명령어입니다. 이 명령어들은 AI 비서에게 특정 시스템 동작을 지시합니다.
의미: AI 비서와 대화를 시작합니다. 처음 봇을 열었을 때 또는 연결이 끊어진 후 재연결 시 사용합니다. AI 비서가 자기소개를 하고 사용자를 맞이합니다.
💡 텔레그램에서 첫 메시지는 반드시 /start
의미: 사용 가능한 모든 명령어 목록과 간단한 설명을 출력합니다. 어떤 기능이 있는지 모를 때 가장 먼저 입력해야 할 명령어입니다.
💡 설치 후 가장 먼저 실행하세요
의미: 채팅창에서 현재 AI 비서의 상태를 확인합니다. 어떤 AI 모델을 사용 중인지, 활성화된 스킬이 무엇인지 알 수 있습니다.
💡 응답이 이상하면 먼저 /status 확인
의미: 현재 대화 세션의 컨텍스트(context)를 초기화합니다. AI가 이전 대화 내용을 기억하지 못하게 됩니다. 새로운 주제로 전환할 때 사용합니다.
⚠️ 영구 기억(memory)은 삭제되지 않음
/run — 가장 강력한 명령어
/run은 OpenClaw에서 가장 자주 쓰이고 가장 강력한 명령어입니다. 쉘 명령어나 스크립트를 AI 비서가 직접 실행하게 합니다.
# /run 사용 예시
/run ls -la ~/Documents # 파일 목록 확인
/run python3 my_script.py # 파이썬 스크립트 실행
/run git pull && npm install # 여러 명령어 연속 실행
/run curl https://api.example.com # API 호출
⚠️ /run 사용 시 주의사항
- • rm -rf 같은 삭제 명령은 되돌릴 수 없습니다. 반드시 확인 후 실행하세요
- • sudo 권한이 필요한 명령어는 별도 설정이 필요합니다
- • 긴 작업은 완료까지 기다리므로 타임아웃에 주의하세요
- • 출력이 너무 길면 잘려서 표시될 수 있습니다
/ask — 파일/URL에 대해 질문하기
/ask는 특정 파일이나 URL의 내용에 대해 AI에게 질문할 때 사용합니다. 일반 대화와 다른 점은 특정 자료를 컨텍스트로 지정한다는 것입니다.
# /ask 사용 예시
/ask ~/Documents/report.pdf 이 문서를 3줄로 요약해줘
/ask https://example.com/news 이 기사의 핵심 주장은?
/ask ~/code/app.py 이 코드에서 버그를 찾아줘
기억 관련 명령어: /memory·/forget
OpenClaw의 가장 강력한 기능 중 하나는 영구 기억(persistent memory)입니다. 사용자의 선호도, 일정, 습관을 장기간 기억합니다. 이 기억을 관리하는 명령어입니다.
현재 저장된 모든 기억 항목을 목록으로 보여줍니다. AI 비서가 나에 대해 무엇을 알고 있는지 확인할 수 있습니다.
사용자: /memory
OpenClaw: 현재 기억 항목 (5개):
- 이름: 김민준
- 직업: 프리랜서 개발자
- 선호 언어: Python, TypeScript
- 매일 오전 8시 날씨 브리핑 요청
- 애완동물: 고양이 2마리
특정 기억 항목을 삭제합니다. 오래된 정보나 잘못 저장된 내용을 제거할 때 사용합니다.
/forget 이전 직장 정보
/forget 모든 기억 # 전체 초기화 (주의!)
스킬 관련 명령어: /skill·/skills
OpenClaw의 스킬(Skills)은 AI 비서의 기능을 확장하는 플러그인입니다. 커뮤니티가 만든 스킬을 설치하거나, AI가 새 스킬을 직접 만들 수도 있습니다.
현재 설치된 모든 스킬 목록을 보여줍니다. 각 스킬의 이름, 버전, 활성화 상태를 확인할 수 있습니다.
커뮤니티 스킬 저장소에서 특정 스킬을 설치합니다. 예: /skill install gmail, /skill install github
특정 스킬을 비활성화합니다. 삭제하지 않고 임시로 끄고 싶을 때 유용합니다.
스킬을 완전히 제거합니다. 관련 설정 파일도 함께 삭제되므로 주의가 필요합니다.
# 스킬 설치 및 사용 예시
나: /skill install gmail
OpenClaw: ✅ Gmail 스킬 설치 완료! 이제 이메일을 관리할 수 있습니다.
나: 받은 편지함에서 읽지 않은 중요한 메일 알려줘
OpenClaw: Gmail 스킬로 확인 중... (3개 발견)
1. 김부장님 - 내일 회의 일정 변경
2. GitHub - PR 리뷰 요청
3. 은행 - 이체 확인
/heartbeat — AI가 먼저 연락하게 만들기
OpenClaw의 독특한 기능 중 하나는 하트비트(Heartbeat)입니다. AI 비서가 정해진 시간에 먼저 메시지를 보내거나 백그라운드 작업을 실행하게 할 수 있습니다.
💓 하트비트 설정 예시
매일 오전 8시: 오늘 날씨, 일정, 뉴스 브리핑
매주 월요일: GitHub 이슈 요약 보고
매 2시간마다: 서버 상태 모니터링 결과
X.com @HixVAC: "하트비트가 먼저 체크인한다는 걸 발견했다. 정말 멋진 놀라움!"
/model — AI 모델 전환 명령어
OpenClaw는 Claude, GPT, Gemini, 로컬 모델 등 다양한 AI 모델을 지원합니다. /model 명령어로 실시간으로 AI 엔진을 바꿀 수 있습니다.
# 모델 전환 예시
/model list # 사용 가능한 모델 목록
/model use claude-opus-4.5 # Claude 오퍼스로 전환
/model use gpt-4o # GPT-4o로 전환
/model use ollama/llama4 # 로컬 Llama4로 전환
/model use minimax-m2 # MiniMax M2로 전환
💡 실전 팁: 토큰 한도 초과 시 즉시 전환
X.com @jonahships_: "Claude Max 한도를 빠르게 써버렸다. 그래서 ClawdBot이 CoPilot 구독을 API 엔드포인트로 프록시하도록 설정했다. 이제 그걸로 실행한다." 이처럼 /model 명령어로 즉시 대안 모델로 전환하면 서비스 중단 없이 계속 작업할 수 있습니다.
/config — 설정 변경 명령어
현재 모든 설정값을 표시합니다. API 키 (마스킹됨), 모델명, 언어 설정, 타임아웃 등을 확인할 수 있습니다.
AI 응답 언어를 한국어로 설정합니다. 기본값은 영어이므로 한국어 사용자는 반드시 설정하세요.
명령어 실행 타임아웃을 120초로 설정합니다. 긴 스크립트를 실행할 때 타임아웃 오류가 발생하면 이 값을 늘리세요.
전체 명령어 빠른 참조표
| 명령어 | 위치 | 기능 |
|---|---|---|
| openclaw onboard | 터미널 | 초기 설정 마법사 |
| openclaw start | 터미널 | AI 비서 데몬 시작 |
| openclaw stop | 터미널 | 데몬 안전 종료 |
| openclaw status | 터미널 | 실행 상태 확인 |
| openclaw logs | 터미널 | 로그 출력 |
| /start | 메신저 | 대화 시작/재연결 |
| /help | 메신저 | 명령어 목록 표시 |
| /clear | 메신저 | 대화 컨텍스트 초기화 |
| /run [명령] | 메신저 | 쉘 명령어 직접 실행 |
| /ask [파일/URL] | 메신저 | 특정 자료에 질문 |
| /memory | 메신저 | 저장된 기억 목록 |
| /skills | 메신저 | 설치된 스킬 목록 |
| /model use [이름] | 메신저 | AI 모델 전환 |
| /config set | 메신저 | 설정값 변경 |
고급 사용자를 위한 명령어 조합 레시피
기본 명령어를 익혔다면, 여러 명령어를 조합하여 강력한 자동화 워크플로우를 만들 수 있습니다. 아래는 X.com에서 인기 있는 조합 예시입니다:
🔀 레시피 1: 아침 자동 브리핑
# 하트비트로 매일 오전 8시 자동 실행
/heartbeat "매일 08:00: 오늘 날씨 + Google Calendar 일정 + 미읽은 중요 이메일 3개 요약해서 보내줘"
# AI가 매일 아침 먼저 메시지를 보냅니다
OpenClaw: 🌤 서울 날씨: 맑음 12°C
📅 오늘 일정: 14시 팀 미팅, 16시 고객 콜
📧 중요 이메일: [김부장] 내일 보고서 제출 요청
🔀 레시피 2: 코드 자동 리뷰 파이프라인
# GitHub 푸시 시 자동 코드 리뷰
/skill install github-webhook
# 이제 git push 할 때마다 자동으로:
# 1. /run pytest 테스트 실행
# 2. /ask 코드 스타일 검토
# 3. /run git commit 결과를 텔레그램으로 보고
🔀 레시피 3: 스마트 메모리 관리
# 새로운 정보 기억시키기
나: 내 생일은 4월 15일이야. 기억해줘.
OpenClaw: ✅ 기억했습니다! 생일: 4월 15일
# 기억 확인
나: /memory | grep 생일
OpenClaw: - 생일: 4월 15일
# 다가오는 생일 알림 설정
나: 내 생일 3일 전에 미리 알려줘
OpenClaw: ✅ 4월 12일에 생일 알림을 설정했습니다
명령어 관련 자주 묻는 질문
Q. /run 명령어로 파이썬 스크립트를 실행할 수 있나요?
네. /run python3 ~/scripts/my_script.py 처럼 실행할 수 있습니다. 가상환경이 필요한 경우 /run source ~/.venv/bin/activate && python3 script.py 처럼 체인으로 연결할 수 있습니다. 단, 긴 실행 시간이 필요한 스크립트는 백그라운드 실행(&)을 권장합니다.
Q. 명령어 자동 완성 기능이 있나요?
터미널에서는 Tab 자동 완성이 지원됩니다. 메신저에서는 /로 시작하면 사용 가능한 명령어 목록이 표시됩니다(텔레그램 기준). 또한 /help [키워드]로 특정 기능 관련 명령어를 검색할 수 있습니다.
Q. 모든 명령어 목록은 어디서 확인하나요?
메신저에서 /help 입력 시 전체 목록이 표시됩니다. 또는 docs.openclaw.ai에서 최신 명령어 레퍼런스를 확인할 수 있습니다. OpenClaw는 활발히 개발 중이므로 새 명령어가 자주 추가됩니다. openclaw start 후 openclaw --version으로 현재 버전을 확인하고 최신 버전을 유지하세요.
OpenClaw 업데이트 및 유지보수 명령어
OpenClaw는 거의 매일 새 기능과 버그 수정이 이루어지는 빠르게 발전하는 프로젝트입니다. X.com @cnakazawa는 "OpenClaw는 내가 GitHub 새 릴리즈를 계속 확인하는 첫 소프트웨어"라고 말했습니다. 최신 버전을 유지하는 명령어를 알아두세요.
OpenClaw를 최신 버전으로 업데이트합니다. 실행 중인 데몬이 있으면 자동으로 재시작됩니다. 중요한 보안 패치나 새 기능이 포함될 수 있으므로 정기적으로 실행하세요.
npm i -g openclaw@latest
# 또는
openclaw update
현재 모든 설정, 기억(memory), 스킬을 백업합니다. 업데이트 전 또는 컴퓨터 변경 전에 반드시 백업해두세요.
openclaw backup ~/openclaw-backup-$(date +%Y%m%d).zip
백업 파일에서 설정과 기억을 복원합니다. 새 컴퓨터에 OpenClaw를 이전하거나, 실수로 설정을 초기화했을 때 사용합니다.
시스템 환경, API 연결, 설정 파일을 자동으로 진단하고 잠재적 문제를 알려줍니다. 뭔가 이상할 때 가장 먼저 실행할 명령어입니다.
명령어가 작동하지 않을 때: 99%는 네트워크 문제
OpenClaw 명령어가 제대로 실행되지 않을 때 가장 먼저 의심해야 할 것은 네트워크 연결입니다. Claude, GPT, 텔레그램 봇 서버 모두 해외에 위치해 있어, 불안정한 연결은 명령어 타임아웃이나 응답 없음으로 이어집니다.
📌 이 가이드의 OpenClaw 버전 정보
OpenClaw는 빠르게 업데이트되는 프로젝트입니다. 명령어 체계가 변경될 수 있으니 docs.openclaw.ai에서 최신 정보를 확인하세요.
팁: OpenClaw 명령어는 꾸준히 업데이트됩니다.
npm i -g openclaw@latest로
최신 버전을 유지하면 새로운 명령어와 버그 수정을 바로 받을 수 있습니다.
X.com @openclaw 팔로우를 추천합니다.
VPN07 - OpenClaw 명령어 실행 최적화
1000Mbps 기가급 속도로 모든 명령어가 즉각 응답
10년 이상 안정 운영. /run, /ask, /skill 등 OpenClaw 모든 명령어가 해외 API와 연동될 때 VPN07의 IEPL 전용선으로 지연 없이 즉각 실행됩니다. 70개국 서버로 최적 경로를 자동 선택합니다.