OpenClaw
Self-hosted personal AI assistant gateway. 설치와 기본 CLI 명령 위주로 정리.
Summary
- 공식 사이트: https://openclaw.ai/
- 하나의 Gateway 프로세스로 여러 chat channel과 agent runtime을 연결한다.
Installation
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
npm
npm install -g openclaw@latest
Usage
openclaw setup: 기본 config/workspace 생성openclaw onboard: 전체 guided onboardingopenclaw onboard –install-daemon: onboarding + gateway service 설치openclaw dashboard: Control UI 열기openclaw gateway status: gateway 상태 확인openclaw gateway start,openclaw gateway stop,openclaw gateway restartopenclaw doctor: health check / guided repairopenclaw channels add: channel 계정 추가openclaw config SUBCOMMAND: 설정 조회/수정openclaw update: source install 기준 업데이트openclaw –profile NAME: profile별 상태 분리openclaw –dev:~/.openclaw-dev아래로 격리 실행
Examples
가장 빠른 시작
curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon openclaw gateway status openclaw dashboard
npm 설치 후 onboarding
npm install -g openclaw@latest openclaw onboard --install-daemon
gateway 제어
openclaw gateway status openclaw gateway start openclaw gateway stop openclaw gateway restart
channel 추가
openclaw channels add
profile 분리 실행
openclaw --profile work onboard openclaw --profile work dashboard
Config
- 기본 config:
~/.openclaw/openclaw.json - 기본 Control UI:
http://127.0.0.1:18789/ - 환경변수:
OPENCLAW_HOME,OPENCLAW_STATE_DIR,OPENCLAW_CONFIG_PATH
Compatibility
- 공식 문서 기준 Node 24 권장
- Node 22 LTS는
22.19+이상에서 호환 - Windows는 Hub 앱, PowerShell installer, WSL2 경로를 지원한다.
Related
History
- codex:: 2026-06-21 Added OpenClaw install and gateway CLI quick reference from official docs.