OpenClaw 🦞 — 당신의 기기에서, 당신의 채팅에서 함께하는 어시스턴트

OpenClaw는 당신의 컴퓨터에서 실행되며 이미 사용 중인 채널에서 만나는 오픈소스 AI 어시스턴트입니다: Discord, iMessage, Slack, Teams, Telegram, WhatsApp 및 20개 이상의 채널, 그리고 macOS, iOS, Android, Windows, Linux용 네이티브 앱까지 지원합니다. 하나의 Gateway가 이를 노트북 위의 개인 어시스턴트로 실행하거나 공유 팀 배포로 실행하며, 차이는 오직 구성뿐입니다.

온전히 당신의 것, 숨은 조건 없이. 상태, 메모리, 자격 증명은 당신의 하드웨어에 저장됩니다. 모델과 에이전트 하네스(Claude, Codex, 로컬 모델)는 다른 무엇도 바꾸지 않고 교체할 수 있는 플러그인입니다. 당신의 프롬프트는 당신이 구성한 모델 제공자와 채팅 플랫폼, 그리고 당신이 직접 활성화한 진단 내보내기로만 전송됩니다. 기본적으로 OpenClaw 자체는 일일 버전 확인 외에는 아무것도 외부로 전송하지 않으며, 익명 기능 통계는 옵트인 방식이고, update.checkOnStart: false로 둘 다 비활성화할 수 있습니다 (OpenClaw가 전송하는 것). OpenClaw는 독립적인 501(c)(3) 재단인 OpenClaw Foundation이 관리하며, 유료 등급, 호스팅 서비스, 토큰이 없습니다. 신뢰할 수 있는 게이트웨이, 신뢰할 수 없는 실행, 코드로 강제되는 정책이라는 아키텍처 근거는 Why OpenClaw에 있습니다.

웹사이트 · 문서 · 시작하기 · Why OpenClaw · FAQ · 비전 · DeepWiki

설치

설치 프로그램은 macOS, Linux, Windows를 지원합니다. 필요할 경우 지원되는 Node.js 런타임을 프로비저닝합니다.

# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

Node.js를 이미 관리하고 계신가요? 대신 게시된 패키지를 설치하세요 (Node 24.22.1+ 또는 26.12.1+; Node 26 권장):

npm install -g openclaw@latest --allow-scripts=openclaw

해당 명령은 npm 12 또는 npm 11.16+용입니다. npm 11.15 및 이전 버전에서는 --allow-scripts=openclaw를 생략하세요. 라이프사이클 스크립트 계약, Docker, Nix 및 기타 배포 경로에 대해서는 설치 가이드를 참조하세요.

빠른 시작

새로 설치하는 경우, 설치 스크립트가 온보딩을 자동으로 시작합니다. 열리는 마법사를 완료하세요. npm, pnpm 또는 Bun으로 패키지를 직접 설치했다면 다음을 실행하세요:

openclaw onboard --install-daemon

온보딩 후:

openclaw gateway status
openclaw dashboard

온보딩은 모델 접근을 확인하고, 워크스페이스를 생성하며, Gateway를 구성합니다. 마지막 명령은 Control UI를 엽니다. 그곳에서 메시지를 보내 어시스턴트가 작동하는지 확인하세요. 채널 설정과 문제 해결은 시작 가이드를 참조하세요.

구성 방식

• Gateway는 세션, 도구, 이벤트, 채널 연결을 위한 로컬 제어 플레인입니다.
• Control UI, CLI, TUI는 Gateway에 연결됩니다.
• Channels는 어시스턴트를 WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage 및 기타 메시징 서비스로 가져옵니다.
• 컴패니언 앱과 노드는 지원되는 플랫폼에서 음성, Canvas, 카메라, 화면, 기기 로컬 작업을 추가합니다.

OpenClaw는 호스팅 및 로컬 모델 제공자와 함께 작동합니다. 도구, 스킬, 플러그인은 어시스턴트가 할 수 있는 일을 확장합니다.

보안

수신 메시지를 신뢰할 수 없는 입력으로 취급하세요. DM 지원 채널은 기본적으로 알 수 없는 발신자를 페어링합니다. openclaw pairing approve <channel> <code>로 페어링 요청을 승인하세요.

샌드박싱을 구성하지 않는 한 도구는 메인 세션의 호스트에서 실행됩니다. 다른 사용자를 연결하거나 Gateway를 원격으로 노출하기 전에 보안 가이드, 노출 런북, 샌드박싱 가이드를 읽어보세요.

문서

목표	시작 지점
모델 및 인증 구성	Models · Model providers
메시징 서비스 연결	Channels
도구, 스킬, 플러그인 추가	Tools · Skills · Plugins · ClawHub
앱 및 디바이스 노드 실행	Platforms · Nodes
CLI 및 채팅 명령 사용	CLI reference · Slash commands
Gateway 구성 또는 운영	Configuration · Architecture · Updating · Release channels

개발

이 저장소는 pnpm 워크스페이스입니다. 저장소 루트에서 일반 npm install은 지원되지 않습니다.

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

기여 워크플로는 CONTRIBUTING.md를, 개발 루프는 소스 설정 가이드를 참고하세요.

거버넌스

OpenClaw는 독립적인 501(c)(3) 단체인 OpenClaw Foundation에 의해 공개적으로 개발됩니다. 재단은 핵심 팀을 고용하고 릴리스를 승인합니다. 기부자와 인프라 후원자는 재단을 지원하지만, 그 누구도 프로젝트를 소유하거나 지시하지 않습니다. OpenAI는 소유자가 아닌 기부자입니다.

커뮤니티

유지관리자와 기여 지침은 CONTRIBUTING.md를 참고하세요. AI 지원 PR을 환영합니다.