{{tag>[agent ai openclaw]}}

====== OpenClaw ======
Self-hosted personal AI assistant gateway. 설치와 기본 CLI 명령 위주로 정리.

===== Summary =====
  * 공식 사이트: [[https://openclaw.ai/]]
  * 문서: [[https://docs.openclaw.ai/]]
  * 저장소: [[https://github.com/openclaw/openclaw]]
  * 하나의 Gateway 프로세스로 여러 chat channel과 agent runtime을 연결한다.

===== Installation =====
==== macOS / Linux ====
<code bash>
curl -fsSL https://openclaw.ai/install.sh | bash
</code>

==== Windows PowerShell ====
<code powershell>
iwr -useb https://openclaw.ai/install.ps1 | iex
</code>

==== npm ====
<code bash>
npm install -g openclaw@latest
</code>

===== Usage =====
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**setup**</color>'' : 기본 config/workspace 생성
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**onboard**</color>'' : 전체 guided onboarding
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**onboard**</color> <color #22b14c>**--install-daemon**</color>'' : onboarding + gateway service 설치
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**dashboard**</color>'' : Control UI 열기
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**gateway status**</color>'' : gateway 상태 확인
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**gateway start**</color>'', ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**gateway stop**</color>'', ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**gateway restart**</color>''
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**doctor**</color>'' : health check / guided repair
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**channels add**</color>'' : channel 계정 추가
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**config**</color> <color #7092be>SUBCOMMAND</color>'' : 설정 조회/수정
  * ''<color #c3c3c3>**openclaw**</color> <color #ff7f27>**update**</color>'' : source install 기준 업데이트
  * ''<color #c3c3c3>**openclaw**</color> <color #22b14c>**--profile**</color> <color #7092be>NAME</color>'' : profile별 상태 분리
  * ''<color #c3c3c3>**openclaw**</color> <color #22b14c>**--dev**</color>'' : ''~/.openclaw-dev'' 아래로 격리 실행

===== Examples =====
==== 가장 빠른 시작 ====
<code bash>
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
</code>

==== npm 설치 후 onboarding ====
<code bash>
npm install -g openclaw@latest
openclaw onboard --install-daemon
</code>

==== gateway 제어 ====
<code bash>
openclaw gateway status
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
</code>

==== channel 추가 ====
<code bash>
openclaw channels add
</code>

==== profile 분리 실행 ====
<code bash>
openclaw --profile work onboard
openclaw --profile work dashboard
</code>

===== 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 =====
  * [[agent:hermes]]
  * [[claude]]
  * [[npm:codex]]

===== History =====
  * codex:: 2026-06-21 Added OpenClaw install and gateway CLI quick reference from official docs.