Get started
OpenClaw
OpenClaw 🦞
"각질 제거! 각질 제거!" — 아마도 우주 바닷가재
Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등을 통해 AI 에이전트를 이용할 수 있는 모든 OS용 Gateway입니다.
메시지를 보내면 어디서든 에이전트의 응답을 받을 수 있습니다. 채널 플러그인, WebChat, 모바일 노드 전반에서 하나의 Gateway를 실행하십시오.
OpenClaw를 설치하고 몇 분 안에 Gateway를 실행하십시오.
openclaw onboard 및 페어링 흐름을 이용한 안내형 설정입니다.
Discord, Signal, Telegram, WhatsApp 등을 연결하여 어디서든 채팅하십시오.
채팅, 구성, 세션을 위한 브라우저 대시보드를 실행하십시오.
문서 둘러보기
모바일 브라우저에서는 전체 데스크톱 탭 표시줄 없이 섹션 메뉴만 표시될 수 있습니다. 페이지 본문에서 동일한 최상위 문서 영역으로 이동하려면 다음 허브 링크를 사용하십시오.
개요, 쇼케이스, 첫 단계, 설정 가이드입니다.
설치 경로, 업데이트, 컨테이너, 호스팅, 고급 설정입니다.
메시징 채널, 페어링, 라우팅, 액세스 그룹, 채널 QA입니다.
아키텍처, 세션, 컨텍스트, 메모리, 다중 에이전트 라우팅입니다.
도구, 스킬, Cron, Webhook, 자동화 기능입니다.
Plugin 마켓플레이스, 게시, 큐레이션, 신뢰 지침입니다.
제공자, 모델 구성, 장애 조치, 로컬 모델 서비스입니다.
macOS, Windows, iOS, Android, 노드, 웹 화면입니다.
Gateway 구성, 보안, 진단, 운영입니다.
CLI 참조, 스키마, RPC, 릴리스 노트, 템플릿입니다.
문제 해결, 자주 묻는 질문, 테스트, 진단, 환경 검사입니다.
OpenClaw란 무엇입니까?
OpenClaw는 채널 플러그인을 통해 즐겨 사용하는 채팅 앱(Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등)을 AI 코딩 에이전트에 연결하는 자체 호스팅 Gateway입니다. 자체 컴퓨터(또는 서버)에서 단일 Gateway 프로세스를 실행하면 메시징 앱과 항상 이용 가능한 AI 어시스턴트 사이를 연결하는 다리가 됩니다.
누구를 위한 것입니까? 데이터에 대한 통제권을 포기하거나 호스팅 서비스에 의존하지 않으면서 어디서든 메시지를 보낼 수 있는 개인 AI 어시스턴트를 원하는 개발자와 고급 사용자에게 적합합니다.
어떤 점이 다릅니까?
- 자체 호스팅: 사용자의 하드웨어에서 사용자의 규칙에 따라 실행됩니다.
- 다중 채널: 하나의 Gateway가 구성된 모든 채널 플러그인을 동시에 지원합니다.
- 에이전트 네이티브: 도구 사용, 세션, 메모리, 다중 에이전트 라우팅을 지원하는 코딩 에이전트용으로 구축되었습니다.
- 오픈 소스: MIT 라이선스가 적용되며 커뮤니티가 주도합니다.
무엇이 필요합니까? Node 24.15+ (권장), 호환성을 위한 Node 22 LTS (22.22.3+), 또는 Node 25.9+, 선택한 제공자의 API 키, 그리고 5분이 필요합니다. 최상의 품질과 보안을 위해 사용 가능한 최신 세대 모델 중 가장 강력한 모델을 사용하십시오.
작동 방식
flowchart LR
A["채팅 앱 + 플러그인"] --> B["Gateway"]
B --> C["OpenClaw 에이전트"]
B --> D["CLI"]
B --> E["웹 제어 UI"]
B --> F["macOS 앱"]
B --> G["iOS 및 Android 노드"]Gateway는 세션, 라우팅, 채널 연결을 관리하는 단일 기준 정보원입니다.
주요 기능
단일 Gateway 프로세스로 Discord, iMessage, Signal, Slack, Telegram, WhatsApp, WebChat 등을 지원합니다.
채널 플러그인으로 Matrix, Nostr, Twitch, Zalo 등을 추가할 수 있으며, 공식 플러그인은 필요할 때 설치됩니다.
에이전트, 작업 공간 또는 발신자별로 세션을 격리합니다.
이미지, 오디오, 문서를 주고받습니다.
채팅, 구성, 세션, 노드를 위한 브라우저 대시보드입니다.
Canvas, 카메라, 음성 지원 워크플로를 위해 iOS 및 Android 노드를 페어링합니다.
빠른 시작
OpenClaw 설치
npm install -g openclaw@latest온보딩 및 서비스 설치
openclaw onboard --install-daemon채팅
브라우저에서 제어 UI를 열고 메시지를 보내십시오.
openclaw dashboard또는 채널(Telegram이 가장 빠름)을 연결하고 휴대전화에서 채팅하십시오.
전체 설치 및 개발 설정이 필요합니까? 시작하기를 참조하십시오.
대시보드
Gateway가 시작된 후 브라우저 제어 UI를 여십시오.
- 로컬 기본값: http://127.0.0.1:18789/
- 원격 액세스: 웹 화면 및 Tailscale
구성(선택 사항)
구성은 ~/.openclaw/openclaw.json에 있습니다.
- 아무것도 하지 않으면 OpenClaw는 번들 OpenClaw 에이전트 런타임을 사용합니다. DM은 에이전트의 기본 세션을 공유하며, 각 그룹 채팅에는 자체 세션이 할당됩니다.
- 액세스를 제한하려면
channels.whatsapp.allowFrom부터 설정하고 그룹의 경우 멘션 규칙도 구성하십시오.
예:
{ channels: { whatsapp: { allowFrom: ["+15555550123"], groups: { "*": { requireMention: true } }, }, }, messages: { groupChat: { mentionPatterns: ["@openclaw"] } },}여기서 시작하기
사용 사례별로 정리된 모든 문서와 가이드입니다.
핵심 Gateway 설정, 토큰, 제공자 구성입니다.
SSH 및 tailnet 액세스 패턴입니다.
Discord, Feishu, Microsoft Teams, Telegram, WhatsApp 등의 채널별 설정입니다.
페어링, Canvas, 카메라, 기기 작업을 지원하는 iOS 및 Android 노드입니다.
일반적인 해결 방법과 문제 해결 진입점입니다.