채팅 채널

OpenClaw은 이미 사용 중인 어떤 채팅 앱에서도 사용자와 대화할 수 있습니다. 각 채널은 Gateway를 통해 연결됩니다. 텍스트는 모든 채널에서 지원되지만, 미디어와 반응 지원은 채널마다 다릅니다.

iMessage, Telegram 및 WebChat UI는 핵심 설치에 포함되어 제공됩니다. "공식 Plugin"으로 표시된 채널은 명령 하나(openclaw plugins install @openclaw/<id>)로 설치하거나 openclaw onboard / openclaw channels add 중 필요할 때 설치할 수 있으며, 이후 Gateway를 다시 시작해야 합니다. "외부 Plugin" 채널은 OpenClaw 저장소 외부에서 유지 관리됩니다.

지원 채널

• Discord - Discord Bot API + Gateway를 사용하며 서버, 채널 및 DM을 지원합니다(공식 Plugin).
• Feishu - WebSocket을 통한 Feishu/Lark 봇입니다(공식 Plugin).
• Google Chat - HTTP Webhook을 통한 Google Chat API 앱입니다(공식 Plugin).
• iMessage - 핵심에 포함됩니다. 로그인된 Mac에서 imsg 브리지를 통해 macOS와 기본 통합됩니다(Gateway가 다른 곳에서 실행되는 경우 SSH 래퍼 사용). 답장, 탭백, 효과, 첨부 파일 및 그룹 관리를 위한 비공개 API 작업도 포함됩니다.
• IRC - 기존 IRC 서버를 지원하며, 페어링/허용 목록 제어 기능과 함께 채널 및 DM을 제공합니다(공식 Plugin).
• LINE - LINE Messaging API 봇입니다(공식 Plugin).
• Matrix - Matrix 프로토콜입니다(공식 Plugin).
• Mattermost - Bot API + WebSocket을 사용하며 채널, 그룹 및 DM을 지원합니다(공식 Plugin).
• Microsoft Teams - Bot Framework를 사용하며 엔터프라이즈 환경을 지원합니다(공식 Plugin).
• Nextcloud Talk - Nextcloud Talk을 통한 자체 호스팅 채팅입니다(공식 Plugin).
• Nostr - NIP-04를 통한 탈중앙화 DM입니다(공식 Plugin).
• QQ Bot - QQ Bot API를 사용하며 비공개 채팅, 그룹 채팅 및 리치 미디어를 지원합니다(공식 Plugin).
• Raft - 사람과 에이전트의 협업을 위한 Raft CLI 깨우기 브리지입니다(공식 Plugin).
• Signal - signal-cli를 사용하며 개인정보 보호에 중점을 둡니다(공식 Plugin).
• Slack - Bolt SDK를 사용하는 워크스페이스 앱입니다(공식 Plugin).
• SMS - Gateway Webhook을 통해 Twilio 기반 SMS를 제공합니다(공식 Plugin).
• Synology Chat - 송신 및 수신 Webhook을 통한 Synology NAS Chat입니다(공식 Plugin).
• Telegram - 핵심에 포함됩니다. grammY를 통한 Bot API를 사용하며 그룹을 지원합니다.
• Tlon - Urbit 기반 메신저입니다(공식 Plugin).
• Twitch - IRC 연결을 통한 Twitch 채팅입니다(공식 Plugin).
• 음성 통화 - Plivo, Telnyx 또는 Twilio를 통한 전화 통신입니다(공식 Plugin).
• WebChat - 핵심에 포함됩니다. WebSocket을 통한 Gateway WebChat UI입니다.
• WeChat - QR 로그인을 사용하는 Tencent iLink 봇이며 비공개 채팅만 지원합니다(외부 Plugin).
• WhatsApp - 가장 널리 사용되며 Baileys를 사용하고 QR 페어링이 필요합니다(공식 Plugin).
• Yuanbao - Tencent Yuanbao 봇입니다(외부 Plugin).
• Zalo - Zalo Bot API를 사용하는 베트남의 인기 메신저입니다(공식 Plugin).
• Zalo ClawBot - QR 로그인을 사용하는 개인용 Zalo 어시스턴트이며 소유자에게 귀속됩니다(외부 Plugin).
• Zalo Personal - QR 로그인을 통해 Zalo 개인 계정을 사용합니다(공식 Plugin).

전달 참고 사항

• ![alt](url)과 같은 마크다운 이미지 구문이 포함된 Telegram 답장은 가능한 경우 최종 발신 경로에서 미디어 답장으로 변환됩니다.
• Slack 다인 DM은 그룹 채팅으로 라우팅되므로 그룹 정책, 멘션 동작 및 그룹 세션 규칙이 MPIM 대화에 적용됩니다.
• WhatsApp 설정은 필요할 때 설치하는 방식입니다. 온보딩은 Plugin 패키지가 설치되기 전에도 설정 흐름을 표시할 수 있으며, Gateway는 채널이 실제로 활성화된 경우에만 외부 ClawHub/npm Plugin을 로드합니다.
• 봇이 작성한 수신 메시지를 허용하는 채널에서는 봇 쌍이 서로에게 무한히 답장하지 않도록 공유 봇 루프 방지 기능을 사용할 수 있습니다.
• 지원되는 상시 활성 대화방에서는 주변 대화방 이벤트를 사용할 수 있습니다. 그러면 에이전트가 message 도구로 메시지를 보내지 않는 한, 에이전트를 멘션하지 않은 대화방 메시지는 조용한 컨텍스트로 처리됩니다.

참고 사항

• 여러 채널을 동시에 실행할 수 있습니다. 여러 채널을 구성하면 OpenClaw이 채팅별로 라우팅합니다.
• 일반적으로 가장 빠르게 설정할 수 있는 채널은 Telegram입니다(간단한 봇 토큰만 필요하며 Plugin 설치가 필요 없음). WhatsApp은 QR 페어링이 필요하고 디스크에 더 많은 상태를 저장합니다.
• 그룹 동작은 채널마다 다릅니다. 그룹을 참조하세요.
• 안전을 위해 DM 페어링 및 허용 목록이 적용됩니다. 보안을 참조하세요.
• 문제 해결: 채널 문제 해결.
• 모델 제공자는 별도로 문서화되어 있습니다. 모델 제공자를 참조하세요.