WecomTeam/wecom-openclaw-plugin

OpenClaw 的官方企业微信插件，由企业微信团队开发和维护。它将你的 OpenClaw Agent 无缝对接到企业微信工作流，集成文档、智能表格、日历能力。

WeCom OpenClaw 플러그인 – 빠른 개요

무엇인가요 – OpenClaw AI 에이전트 프레임워크가 WeCom (텐센트의 엔터프라이즈 위챗)과 통신할 수 있게 해주는 공식 채널 플러그인입니다. WeCom 사용자와의 통신을 두 가지 방식으로 제공합니다:

모드	연결 방식	일반적인 사용 사례
Bot	WebSocket 장기 폴링 또는 HTTP 웹훅 (JSON)	빠른 스트리밍 응답, 간편한 설정.
Agent	HTTP 웹훅 콜백 (XML, AES-256-CBC 암호화)	기업급, API 기반 메시징.

이 플러그인은 수십 가지 WeCom 비즈니스 API(메시지, 이메일, 문서, 스프레드시트, 캘린더, 회의, 파일 저장소, 연락처 등)를 AI가 호출할 수 있는 "스킬"로 제공하는 wecom-cli 명령줄 도구도 함께 제공합니다.

주요 기능 (README에 설명됨)

이중 모드 작동 – Bot과 Agent는 병렬로 실행 가능하며, 시스템은 아웃바운드 메시지에 Bot을 우선하고 WebSocket이 다운되면 Agent로 폴백합니다.
메시지 유형 – 텍스트, 마크다운, 이미지, 동영상, 음성, 파일, 그리고 혼합 "도문혼배" 메시지를 처리합니다. 음성 메시지는 자동으로 텍스트로 변환됩니다.
프로액티브 메시징 – 사용자 입력을 기다리지 않고 특정 사용자, 그룹, 부서 또는 태그에게 메시지를 직접 전송할 수 있습니다.
스트리밍 응답 – LLM이 생각하는 동안 "생각 중"이라는 플레이스홀더 메시지를 보낼 수 있습니다 (Bot 모드 전용).
접근 제어 – 직접 메시지(페어링, 오픈, 허용 목록, 비활성화) 및 그룹 채팅에 대한 세밀한 정책, 계정별 명령 권한 설정이 가능합니다.
다중 계정 지원 – 하나의 OpenClaw 게이트웨이에서 여러 WeCom 계정을 실행할 수 있으며, 각 계정마다 독립된 Bot/Agent 설정이 가능합니다.
동적 에이전트 – 세션 격리 목적의 사용자 또는 그룹별로 선택적으로 고립된 에이전트를 설정할 수 있습니다.
미디어 처리 – 들어오는 미디어 자동 다운로드, 크기 제한 (이미지/동영상: 10MB, 음성: 2MB), 제한을 초과하면 자동으로 파일로 변환됩니다.
내장된 비즈니스 스킬 – wecom-cli는 다음 명령어를 제공합니다:
- 메시지, 이메일, 문서 및 스프레드시트 CRUD
- 스마트 시트 및 스마트 문서 관리
- 할 일, 캘린더, 회의 일정, 회의록 및 녹음 파일
- WeDrive 파일 검색/업로드/다운로드
- 연락처 조회
CLI 워즈드 – openclaw channels add 또는 @wecom/wecom-openclaw-cli install를 통해 Bot ID/Secret 입력과 설정을 안내받으며 진행할 수 있습니다.
강력한 네트워킹 – 허트비트, 재연결 로직, 킥 방지, 선택적 엑그레션 프록시.

시작하기 (README에서)

사전 요구 사항 – OpenClaw ≥ 2026.3.28.

설치 – 한 줄 명령:

npx -y @wecom/wecom-openclaw-cli install   # 필요 시 --force 추가

설정 – openclaw channels add (인터랙티브)를 실행하거나 직접 키를 설정합니다. 예시:

openclaw config set channels.wecom.botId <BOT_ID>
openclaw config set channels.wecom.secret <BOT_SECRET>
openclaw config set channels.wecom.enabled true
openclaw gateway restart

비즈니스 도구 활성화 – tools.alsoAllow에 플러그인 ID를 추가하고 게이트웨이를 재시작합니다.
모드 선택 – 기본값인 WebSocket 기반 Bot 모드 또는 CorpID/Secret, AgentId, Token, EncodingAESKey를 설정하고 WeCom 관리 콘솔에서 콜백 URL을 등록하여 Agent 모드를 선택합니다.

누구에게 적합한가요?

이미 OpenClaw 기반 AI 어시스턴트를 운영 중인 기업에서 WeCom 채팅 내에 AI를 노출시키고 싶은 경우.
프로액티브 알림, 리치 미디어 처리, WeCom의 문서, 캘린더, 회의 API를 호출해야 하는 개발자.
크론 기반으로 부서나 태그에 정기적으로 브로드캐스트를 보내고 싶은 운영 팀.

제한 사항 및 주의사항 (문서 참조)

Bot 모드는 Bot ID와 Secret이 필요합니다. Agent 모드는 전체 기업 앱(CorpID/Secret)과 XML 암호화 콜백이 필요합니다.
제한 크기를 초과하는 미디어는 파일로 전송되거나 거부됩니다.
Agent 전용 계정을 사용할 경우, WeCom 콘솔에 콜백 URL을 저장하기 전에 Agent를 미리 설정해야 합니다 (WeCom은 URL을 즉시 검증합니다).
플러그인 버전은 OpenClaw 버전과 일치해야 합니다 (예: OpenClaw 2026.3.22 → 플러그인 2026.3.20; 최신 OpenClaw → 플러그인 2026.3.24+).

요약 (TL;DR)

WeCom OpenClaw 플러그인은 OpenClaw AI 에이전트가 텐센트의 엔터프라이즈 위챗과 통신할 수 있도록 해주는 프로덕션 준비 완료된 브리지입니다. 리치 미디어, 프로액티브 메시지, WeCom 비즈니스 API의 전체 세트를 편리한 CLI를 통해 사용 가능합니다. WebSocket(Bot) 또는 암호화 XML 웹훅(Agent) 모드로 작동하며, 여러 계정을 지원하고, 접근 정책과 모드 간 자동 폴백과 같은 안전 기능을 포함합니다.