Get started
OpenClaw
OpenClaw 🦞
"각질 제거! 각질 제거!" — 아마도 우주 바닷가재
Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등에서 AI 에이전트를 위한 모든 OS용 Gateway입니다.
메시지를 보내고, 주머니 속 기기에서 에이전트 응답을 받으세요. 기본 제공 채널, 번들 채널 Plugin, WebChat, 모바일 노드를 아우르는 하나의 Gateway를 실행하세요.
OpenClaw를 설치하고 몇 분 안에 Gateway를 실행하세요.
openclaw onboard와 페어링 흐름으로 안내되는 설정입니다.
채팅, 설정, 세션을 위한 브라우저 대시보드를 실행하세요.
OpenClaw란 무엇인가요?
OpenClaw는 즐겨 쓰는 채팅 앱과 채널 표면을 AI 코딩 에이전트에 연결하는 셀프 호스팅 Gateway입니다. 기본 제공 채널과 Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등과 같은 번들 또는 외부 채널 Plugin을 지원합니다. 사용자는 자신의 머신이나 서버에서 단일 Gateway 프로세스를 실행하며, 이 프로세스가 메시징 앱과 항상 사용 가능한 AI 어시스턴트 사이의 다리가 됩니다.
누구를 위한 것인가요? 데이터 제어권을 포기하거나 호스팅 서비스에 의존하지 않고, 어디서나 메시지를 보낼 수 있는 개인 AI 어시스턴트를 원하는 개발자와 고급 사용자입니다.
무엇이 다른가요?
- 셀프 호스팅: 사용자의 하드웨어와 규칙에 따라 실행됩니다
- 멀티채널: 하나의 Gateway가 기본 제공 채널과 번들 또는 외부 채널 Plugin을 동시에 제공합니다
- 에이전트 네이티브: 도구 사용, 세션, 메모리, 멀티 에이전트 라우팅을 갖춘 코딩 에이전트를 위해 구축되었습니다
- 오픈 소스: MIT 라이선스, 커뮤니티 주도
무엇이 필요한가요? Node 24(권장) 또는 호환성을 위한 Node 22 LTS(22.19+), 선택한 제공자의 API 키, 그리고 5분이면 됩니다. 최고의 품질과 보안을 위해 사용 가능한 가장 강력한 최신 세대 모델을 사용하세요.
작동 방식
flowchart LR
A["Chat apps + plugins"] --> B["Gateway"]
B --> C["OpenClaw agent"]
B --> D["CLI"]
B --> E["Web Control UI"]
B --> F["macOS app"]
B --> G["iOS and Android nodes"]Gateway는 세션, 라우팅, 채널 연결의 단일 진실 공급원입니다.
주요 기능
단일 Gateway 프로세스로 Discord, iMessage, Signal, Slack, Telegram, WhatsApp, WebChat 등을 사용할 수 있습니다.
번들 Plugin은 일반적인 최신 릴리스에서 Matrix, Nostr, Twitch, Zalo 등을 추가합니다.
에이전트, 워크스페이스 또는 발신자별 격리된 세션입니다.
이미지, 오디오, 문서를 보내고 받을 수 있습니다.
채팅, 설정, 세션, 노드를 위한 브라우저 대시보드입니다.
Canvas, 카메라, 음성 지원 워크플로를 위해 iOS 및 Android 노드를 페어링하세요.
빠른 시작
OpenClaw 설치
npm install -g openclaw@latest온보딩 및 서비스 설치
openclaw onboard --install-daemon채팅
브라우저에서 Control UI를 열고 메시지를 보내세요.
openclaw dashboard또는 채널을 연결하고(Telegram이 가장 빠릅니다) 휴대폰에서 채팅하세요.
전체 설치 및 개발 설정이 필요하신가요? 시작하기를 참조하세요.
대시보드
Gateway가 시작된 후 브라우저 Control UI를 여세요.
- 로컬 기본값: http://127.0.0.1:18789/
- 원격 액세스: 웹 표면 및 Tailscale
구성(선택 사항)
구성은 ~/.openclaw/openclaw.json에 있습니다.
- 아무것도 하지 않으면, OpenClaw는 발신자별 세션과 함께 번들 OpenClaw 에이전트 런타임을 사용합니다.
- 잠그고 싶다면
channels.whatsapp.allowFrom부터 시작하고, 그룹의 경우 멘션 규칙을 설정하세요.
예시:
{ channels: { whatsapp: { allowFrom: ["+15555550123"], groups: { "*": { requireMention: true } }, }, }, messages: { groupChat: { mentionPatterns: ["@openclaw"] } },}여기서 시작하세요
사용 사례별로 정리된 모든 문서와 가이드입니다.
핵심 Gateway 설정, 토큰, 제공자 구성입니다.
SSH 및 tailnet 액세스 패턴입니다.
Feishu, Microsoft Teams, WhatsApp, Telegram, Discord 등을 위한 채널별 설정입니다.
페어링, Canvas, 카메라, 기기 작업을 지원하는 iOS 및 Android 노드입니다.
일반적인 수정 방법과 문제 해결 진입점입니다.