메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw를 설치하고, 온보딩을 실행한 다음, AI 어시스턴트와 채팅하세요. 모두 약 5분이면 됩니다. 완료하면 실행 중인 Gateway, 구성된 인증, 그리고 작동하는 채팅 세션을 갖게 됩니다.

​
필요한 것

  • Node.js — Node 24 권장(Node 22.16+도 지원)
  • 모델 제공업체(Anthropic, OpenAI, Google 등)의 API 키 — 온보딩 중 입력하라는 메시지가 표시됩니다
node --version으로 Node 버전을 확인하세요. Windows 사용자: 네이티브 Windows와 WSL2가 모두 지원됩니다. WSL2가 더 안정적이며 전체 경험에 권장됩니다. Windows를 참조하세요. Node를 설치해야 하나요? Node 설정을 참조하세요.

​
빠른 설정

1

OpenClaw 설치

curl -fsSL https://openclaw.ai/install.sh | bash
설치 스크립트 프로세스
기타 설치 방법(Docker, Nix, npm): 설치.
2

온보딩 실행

openclaw onboard --install-daemon
마법사가 모델 제공업체 선택, API 키 설정, Gateway 구성 과정을 안내합니다. 약 2분이 걸립니다.전체 참조는 온보딩(CLI)을 참조하세요.
3

Gateway 실행 확인

openclaw gateway status
Gateway가 포트 18789에서 수신 대기 중인 것을 볼 수 있어야 합니다.
4

대시보드 열기

openclaw dashboard
브라우저에서 Control UI가 열립니다. 로드되면 모든 것이 정상 작동 중입니다.
5

첫 메시지 보내기

Control UI 채팅에 메시지를 입력하면 AI 답변을 받을 수 있습니다.대신 휴대폰에서 채팅하고 싶나요? 가장 빠르게 설정할 수 있는 채널은 Telegram입니다(봇 토큰만 있으면 됩니다). 모든 옵션은 채널을 참조하세요.
현지화되었거나 사용자 지정된 대시보드 빌드를 유지 관리하는 경우, gateway.controlUi.root가 빌드된 정적 에셋과 index.html이 포함된 디렉터리를 가리키도록 설정하세요.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# 빌드된 정적 파일을 해당 디렉터리로 복사합니다.
그런 다음 다음을 설정하세요.
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
gateway를 다시 시작하고 대시보드를 다시 여세요.
openclaw gateway restart
openclaw dashboard

​
다음에 할 일

채널 연결

Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등.

페어링 및 안전

에이전트에게 메시지를 보낼 수 있는 사람을 제어하세요.

Gateway 구성

모델, 도구, sandbox, 고급 설정.

도구 탐색

브라우저, exec, 웹 검색, Skills, Plugin.
OpenClaw를 서비스 계정으로 실행하거나 사용자 지정 경로를 사용하려는 경우:
  • OPENCLAW_HOME — 내부 경로 확인을 위한 홈 디렉터리
  • OPENCLAW_STATE_DIR — 상태 디렉터리 재정의
  • OPENCLAW_CONFIG_PATH — 구성 파일 경로 재정의
전체 참조: 환경 변수.

​
관련 항목