OpenClaw는 채널 플러그인을 통해 즐겨 사용하는 채팅 앱인 Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo 등을 AI 코딩 에이전트에 연결하는 자체 호스팅 Gateway입니다. 자체 컴퓨터나 서버에서 단일 Gateway 프로세스를 실행하면 메시징 앱과 언제든 이용할 수 있는 AI 어시스턴트를 연결하는 다리가 됩니다.

누구를 위한 것인가요? 데이터에 대한 제어권을 포기하거나 호스팅 서비스에 의존하지 않으면서 어디서든 메시지를 보낼 수 있는 개인용 AI 어시스턴트를 원하는 개발자와 고급 사용자에게 적합합니다.

무엇이 다른가요?

자체 호스팅: 사용자의 하드웨어에서 사용자의 규칙에 따라 실행됩니다
다중 채널: 하나의 Gateway가 구성된 모든 채널 플러그인을 동시에 지원합니다
에이전트 중심: 도구 사용, 세션, 메모리, 다중 에이전트 라우팅을 사용하는 코딩 에이전트를 위해 설계되었습니다
오픈 소스: MIT 라이선스로 제공되며 커뮤니티가 주도합니다

무엇이 필요한가요? Node 24(권장) 또는 호환성을 위한 Node 22 LTS(22.19+), 선택한 제공자의 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

하나의 Gateway 프로세스로 Discord, iMessage, Signal, Slack, Telegram, WhatsApp, WebChat 등을 지원합니다.

Plugin 채널

채널 플러그인으로 Matrix, Nostr, Twitch, Zalo 등을 추가할 수 있으며 공식 플러그인은 필요할 때 설치됩니다.

다중 에이전트 라우팅

에이전트, 작업 공간 또는 발신자별로 격리된 세션을 제공합니다.

미디어 지원

이미지, 오디오, 문서를 주고받을 수 있습니다.

웹 제어 UI

채팅, 구성, 세션, 노드를 위한 브라우저 대시보드입니다.

모바일 노드

Canvas, 카메라, 음성 지원 워크플로를 위해 iOS 및 Android 노드를 페어링하세요.

빠른 시작

OpenClaw 설치

bash

npm install -g openclaw@latest

온보딩 및 서비스 설치

bash

openclaw onboard --install-daemon

채팅

브라우저에서 제어 UI를 열고 메시지를 보내세요.

bash

openclaw dashboard

또는 채널(Telegram이 가장 빠릅니다)을 연결하고 휴대전화에서 채팅하세요.

전체 설치 및 개발 환경 설정이 필요한가요? 시작하기를 참조하세요.

대시보드

Gateway가 시작된 후 브라우저 제어 UI를 여세요.

로컬 기본값: http://127.0.0.1:18789/
원격 접근: 웹 인터페이스 및 Tailscale

구성(선택 사항)

구성은 ~/.openclaw/openclaw.json에 저장됩니다.

아무것도 하지 않으면 OpenClaw는 번들로 제공되는 OpenClaw 에이전트 런타임을 사용합니다. 다이렉트 메시지는 에이전트의 기본 세션을 공유하며 각 그룹 채팅에는 자체 세션이 할당됩니다.
접근을 제한하려면 channels.whatsapp.allowFrom과 그룹의 경우 멘션 규칙부터 설정하세요.

예시:

json5

{  channels: {    whatsapp: {      allowFrom: ["+15555550123"],      groups: { "*": { requireMention: true } },    },  },  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },}