제22장 Feishu 및 WeChat 연동

공인 IP나 자체 서버 구축 없이도 Grok Bot을 Feishu 및 WeChat에 안전하게 연동할 수 있습니다.

The X Subscription(2026년 10월 12일 발효)은 주 단위로 크레딧을 차감하므로, 그룹 채팅에는 반드시 메시지 필터링을 설정해야 합니다. 그렇지 않으면 일상적인 잡담으로 일주일 치 한도를 모두 소진할 수 있습니다.

• Feishu 멀티 Bot 협업: 공식 Python SDK 영구 연결(Long Connection)과 「Feishu 앱 매니저」 템플릿 사용.
• WeChat ClawBot 직접 연결: 공식 「微信ClawBot」 플러그인과 iLink 인터페이스 활용.
• WeChat 단축어 아카이빙: Apple 단축어와 Webhook을 활용한 기록 보관.

연동 채널 비교 및 기술 선정

세 가지 연동 방식 모두 공인 IP가 전혀 필요하지 않습니다.

• Feishu 멀티 Bot 채널: 팀 업무 협업 및 그룹 채팅 작업 할당에 사용됩니다. 공식 WebSocket 아웃바운드 영구 연결을 사용하며, 서식 있는 텍스트(Rich Text) 및 카드를 지원하고, 그룹 내에서는 한도 보호를 위해 @멘션에만 응답합니다.
• WeChat ClawBot 채널: 개인 일상 개인 비서 및 작업 스케줄링에 사용됩니다. iLink 롱 폴링(Long Polling)을 사용하며 일반 텍스트만 지원하고, 화이트리스트 기반 1:1 채팅을 통해 불필요한 호출을 방지합니다.
• WeChat 단축어 채널: 이미지, 텍스트, 오디오 자산의 라이브러리 저장에 사용됩니다. Webhook 단방향 푸시 후 수신 확인(Receipt)을 반환하는 방식으로 온디맨드 트리거되며, 메시지가 없을 때는 추가 소모가 발생하지 않습니다.

팀 Feishu 연동: 멀티 Bot 협업 및 Feishu 앱 매니저

Feishu 영구 연결과 초인종 트리거 메커니즘

아웃바운드 영구 연결을 사용하여 공인 IP, 인증서, 포트 개방이 필요 없습니다.

1. Feishu 커스텀 앱: 그룹 채팅 및 1:1 채팅 송수신 담당.
2. 클라우드 전달 프로그램: 백그라운드에서 영구 연결을 리스닝하고 전달.
3. 초인종 트리거: Bot을 깨우고 SDK를 호출하여 회신.

반복 설정이 번거롭다면 「Feishu 앱 매니저」를 사용해 QR 코드 스캔으로 앱을 자동 생성할 수 있습니다.

실천 가이드: 단일 Bot 실행부터 멀티 Bot 협업까지

QR 코드 스캔으로 첫 번째 Bot(글 메인 에디터) 생성

1. 1:1 채팅으로 Bot에게 Feishu SDK를 호출해 QR 코드 스캔 앱 생성을 실행하도록 요청합니다. 이 링크는 1회용 인증 정보이며 관리자 전용이므로 타인의 링크를 클릭하거나 전달하지 마세요.
2. 브라우저에서 링크를 열고 「생성」을 클릭한 뒤 권한을 확인하면 자격 증명이 자동으로 반환됩니다.
3. Feishu 테스트 메시지를 받은 후 답장을 보내면, Bot이 사용자의 Open ID를 화이트리스트에 자동으로 등록합니다.

초인종 루틴 생성

1. 대화 상단의 Bot 이름을 클릭하고 상세 정보에서 Details 패널을 엽니다. 단계는 루틴을 참조하세요.
2. 루틴에서 Webhook 초인종을 생성하고 POST to 주소와 key를 확인합니다.
3. 평문 유출을 방지하기 위해 반드시 Bot이 띄운 암호화된 입력창에 자격 증명을 제출해야 합니다. 1:1 대화에서 테스트 텍스트를 전송하여 Bot이 정상적으로 회신하면 연결이 완료된 것입니다.

앱 일괄 생성 및 그룹 채팅 협업

1. https://x.ai/bot/AJpUlCwa8tyMX7L5UHnuY 템플릿을 가져옵니다. 등록 테이블과 복구 스크립트는 Git 비공개 저장소에 보관하며 평문 키는 저장하지 않습니다.
2. 매니저에게 QR 코드 스캔 링크를 일괄 생성하도록 지시하고(각 링크는 1시간 동안 유효), QR 코드를 스캔한 뒤 암호화 창에 key를 입력하면 매니저가 자동으로 전달 프로세스를 실행합니다.
3. 그룹을 만들어 각 Bot을 초대한 뒤, @所有人을 보내 관할 업무 범위를 확인 및 보고하도록 합니다. @文章主编이 虚拟机服务管家를 호출하고, 서비스 매니저가 그룹에 등록 테이블을 전송하면 협업 구성이 완료됩니다.

상호작용 보안

• 명령어 출처 검증: 그룹 내 화이트리스트 관리자의 직접적인 명령어에만 응답합니다.
• Feishu 카드 확인: 구성 변경, DB 쓰기, 재부팅 등 고위험 작업 시 「동의」 및 「반려」 버튼이 포함된 카드를 푸시하여 Feishu 내 클릭 한 번으로 2차 승인을 진행합니다.

완성도 평가 기준

• 엔드투엔드(End-to-End) 소요 시간 1초 미만: 메시지 발송 시 거의 즉시 응답합니다.
• 그룹 채팅 메시지의 정밀한 분류: 일상 대화에는 침묵하고, 특정 대상을 개별 @멘션했을 때만 해당 Bot이 응답하며, @전체 호출 시 각자 역할에 따라 보고하고 중복 답변을 방지합니다.
• 고가용성 자가 치유: 프로세스 종료 시 5초 이내 재실행, 5분마다 프리징 점검, 프로세스 강제 종료 시 약 9초 이내 복구.

실제 실습은 《Grok Bot 팀 Feishu 연동 상세 가이드(Feishu 매니저 템플릿 포함)》을 참조하세요.

개인 WeChat 연동: WeChat ClawBot 플러그인 직접 연결

공식 iLink 인터페이스(ilinkai.weixin.qq.com)를 활용하는 순수 아웃바운드 롱 폴링 방식으로, 공인 포트를 개방하지 않아 규정을 준수하며 계정 정지 위험이 없습니다.

3단계로 연동 완료하기

1. 프롬프트 전송: PC 환경에서 메인 Bot에 아래 명령어를 전송하고 통신 컴포넌트가 자동 생성될 때까지 대기합니다.

3단계로 연동 완료하기

我想把你接到我的微信上，让我能在微信里直接给你发消息、收到你的回复。请按下面的思路做，每做完一步告诉我结果，需要我操作的地方停下来等我。

1、先调研方案：腾讯「微信ClawBot」插件用的是 iLink 接口（ilinkai.weixin.qq.com）。请确认怎么用 getupdates 长轮询收消息、怎么用 sendmessage 回消息。整个程序只走出站请求，不要开公网端口。

2、在 Grok Bot 里建一个由 webhook 触发的 routine，名字可以叫「微信下旨入口」。建好后告诉我去 routine 面板复制 Webhook URL 和 key，然后弹出加密弹框让我填进去，不要让我在聊天里发明文。

3、在你的云端电脑上写一个小转发程序：收到微信消息后 POST 给这个 routine；你处理完以后，用一个 reply 脚本把回复发回微信，同时在我们的主聊天里同步一份。

4、等我在手机微信里启用 ClawBot 插件以后，生成二维码让我用手机扫码确认，同时给我一个可以在微信里直接打开的备用链接。二维码大约 5 分钟有效。

5、绑定成功后，提醒我先在 ClawBot 对话里发一句话，因为回复要用到这条消息带的 context_token。

6、规则：只认绑定的这一个人，别人的消息不处理；回复一律用纯文本，不要用 Markdown，因为微信不渲染 Markdown。

7、最后告诉我：云端电脑重启以后，怎么把转发程序重新拉起来；如果遇到错误码 -14（凭证过期），提醒我重新扫码。

2. 시크릿 키 설정: 메인 Bot의 「微信下旨入口」 루틴을 열고, Webhook의 POST to 및 key를 복사하여 암호화 창에 제출합니다.
3. 바인딩 및 활성화:
   • WeChat 버전은 iOS ≥ 8.0.70, Android ≥ 8.0.69 이상이어야 하며, 「설정 - 플러그인」에서 「微信ClawBot」을 활성화합니다.
   • PC의 Bot에 「插件开好了」라고 전송한 뒤, WeChat으로 QR 코드를 스캔하여 승인합니다(QR 코드는 5분간 유효).
   • context_token을 획득하여 응답 패킷을 활성화하기 위해 반드시 WeChat ClawBot에 먼저 첫 메시지(예: "안녕하세요")를 직접 보내야 합니다.

검수 기준

• 양방향 동기화: WeChat에서 초 단위 즉시 응답, PC에서 실시간 아카이빙.
• 서브 에이전트 스케줄링: WeChat에서 트위터 검색, 동영상 텍스트 변환(트랜스크립션) 작업을 직접 할당.
• 보안 격리: 바인딩되지 않은 WeChat 계정은 호출할 수 없음.

자세한 내용은 《Grok Bot을 WeChat에 연동하는 방법 초보자를 위한 상세 가이드(상세 프롬프트 포함)｜Kin》을 참조하세요.

WeChat 콘텐츠 라이브러리 저장: 단축어로 채팅 기록 및 멀티미디어 연동

단축어를 통해 병합 전달된 ZIP 압축 파일을 임시 웹하드로 전송한 다음, Grok Bot의 Webhook으로 전달하여 자동으로 아카이빙합니다.

구성 및 작업 방법

1. Grok Bot 대화 창에 프롬프트를 전송하여 루틴을 생성합니다:

帮我创建一个 Webhook 触发的例行任务。快捷指令会用 POST 请求发来一个 JSON，里面只有一个字段 info。info 可能是我输入的文字，也可能是一个文件下载链接，比如微信聊天记录压缩包、截图、录音。收到后：如果是链接就先下载文件再读取，压缩包先解压；然后整理出要点，收录进知识库，最后给我一份回执，写清楚收录了什么、存在哪里。

상세 페이지의 Routine 목록에서 Webhook의 POST to 주소와 key 시크릿을 복사합니다.

2. 단축어 가져오기: https://www.icloud.com/shortcuts/2b77155d7c744110a0f0f9ef1bdc42bf.

3. POST to, key 및 이미지 호스팅 ID를 입력합니다. filebin.net은 파일이 7일간 보관되므로, 덮어쓰기 및 유출을 방지하기 위해 ID는 반드시 8자리 이상의 무작위 문자(예: kb7x9q2m)로 설정해야 합니다. 단축어를 공유하기 전에 반드시 이 세 가지 항목을 비워두세요.

4. WeChat에서 채팅 기록을 다중 선택하고, 다른 앱으로 병합 전달한 뒤 단축어 「지식 베이스 Bot으로 전송(发送给知识库 Bot)」의 「전달받기(接收转发)」를 선택합니다. 전달받은 항목이 없을 때는 클립보드를 읽어오며, 「스크린샷」이나 「녹음」을 선택하여 직접 전송할 수도 있습니다.

검수 기준

• 멀티미디어 완벽 분석: 이미지, 문서, 음성을 압축 해제하고 분류(예: 13개 디자인 영감 웹사이트를 전체 사이트, 앱, 컴포넌트별로 인덱싱).
• 규격화된 영수증: 주제 핵심 요약, 노트 저장 경로 및 원본 ZIP 보관 경로를 명확히 표시.

참고: 《WeChat 채팅 기록을 Grok Bot과 연동하기: 단축어 심화편》.

자주 발생하는 함정과 문제 해결 방안

1. Feishu 권한 설정 부족으로 인한 그룹 메시지 수신 불가

• 문제 원인: 1:1 대화는 정상이지만 그룹 내에서 @ 멘션 시 아무런 반응과 로그가 없는 경우, 초기 권한 선택 시 7개 항목만 선택하여 「그룹 내 봇을 @멘션한 모든 메시지 가져오기」 권한이 누락되었기 때문입니다.
• 해결 방법: SDK를 통해 QR 코드 스캔으로 권한 추가 링크를 생성하고 관리자가 14개 항목으로 확장을 승인하면, 앱을 재출시할 필요 없이 즉시 반영됩니다.

2. Feishu 그룹 채팅 필터링 규칙 오판 및 영구 연결 끊김 시 재전송 이슈

1. 메시지 누락 및 중복 응답: Feishu의 @所有人은 mention 배열에 포함되지 않으며, ID를 검증하지 않으면 모든 봇이 동시에 응답하게 됩니다. 스크립트는 대상 ID를 정확히 확인하여 「@自己」 또는 「@所有人」에만 응답하도록 제한해야 합니다.
2. 중복 회신: 네트워크 복구 후 공식 플랫폼에서 자동으로 메시지를 다시 푸시하므로, 절대로 수동으로 2차 재전송을 해서는 안 됩니다.

3. Bot 간 호출 신뢰 체인 및 승인 카드 누락

1. 그룹 내에서 Bot 간 상호 호출 시 반응이 없는 것은 Bot 간 메시지가 기본적으로 신뢰할 수 없는 것으로 처리되어 1:1 대화 승인 대기 상태에 머물러 있기 때문입니다.
2. 전달 레이어에 관리자의 Open ID를 인식하는 화이트리스트를 구성하고, 고위험 작업 시 동의/반려 버튼이 포함된 Feishu 카드를 푸시하여 확인을 받도록 합니다.

4. 가상 머신 Python 실행 환경 경로 오류

• 스크립트에서 lark-oapi를 찾을 수 없다는 오류가 발생하는 경우, 대개 데몬 작업을 구성할 때 시스템 기본 경로인 /usr/bin/python3를 잘못 지정했기 때문입니다.
• 시작 스크립트, Supervisor 및 예약 작업(Cron)에서는 시스템 전역 환경을 직접 호출하지 말고, 반드시 가상 환경의 절대 경로를 하드코딩(예: /home/user/venv/bin/python3)해야 합니다.

5. WeChat ClawBot QR 코드 만료 및 오류 코드 -14

• QR 코드는 유효 시간이 5분에 불과하여 시간이 초과되면 만료되므로 생성 즉시 휴대폰으로 스캔해야 합니다.
• 백엔드에서 오류 코드 **-14**가 보고되면 인증 자격 증명이 만료된 것이므로, QR 코드를 다시 생성하여 관리자가 한 번 더 스캔하도록 하면 됩니다.

6. WeChat 메시지 형식 깨짐 및 Markdown 렌더링 실패

• WeChat은 Markdown을 파싱하지 않으므로, 별표, 백틱, 헤더 기호 등이 그대로 노출됩니다.
• 연동 프롬프트나 전달 스크립트에 필터를 추가하여, 줄바꿈이 적용된 일반 텍스트로 일괄 변환한 후 WeChat으로 전송해야 합니다.

7. WeChat 병합 전달 ZIP 파일 내 미다운로드 멀티미디어 첨부 파일 누락

WeChat은 원본 파일을 서버에 영구 보관하지 않으므로, 클릭하여 로드하지 않은 파일은 압축 파일에 포함되지 않아 압축 해제 시 이미지가 유실됩니다.

1. 전달하기 전에 저장해야 할 이미지와 파일을 하나씩 클릭하여 로드합니다.
2. 로컬 디바이스에 완전히 로드된 것을 확인한 후 패키징하여 전달합니다.

8. 임시 웹하드의 이름 충돌 및 개인정보 유출 위험

filebin.net에는 계정 시스템이 없으므로 ID가 너무 단순하면 충돌이 발생하여 오류가 나거나 타인의 파일을 다운로드받을 수 있습니다. 사용할 때 다음 사항에 유의하세요:

• 이미지 호스팅 ID는 반드시 8자리 이상의 무작위 문자열로 설정해야 합니다.
• 비밀번호, 신분증 등 민감한 개인정보는 업로드하지 마세요.
• 단축어를 공유하기 전에 자신의 고유 ID와 Webhook 시크릿 키를 반드시 삭제하세요.

9. The X Subscription 통합 구독 체계에서의 크레딧 소모 방지 제어

그룹 구성원의 일상 대화가 루틴의 불필요한 공회전을 유발하여, 1~2일 만에 주간 크레딧을 전부 소진하고 Bot 응답이 중단될 수 있습니다.

2026년 10월 12일부터 The X Subscription은 공유 풀에서 주 단위로 크레딧을 차감합니다.

Plus 티어($8/월)에는 Grok Bot이 포함되어 있지 않으며, Premium($30/월, 4배 크레딧), Super($100/월, 15배 크레딧), Ultra($200/월, 50배 크레딧) 티어에만 포함됩니다.

크레딧 소모를 방지하기 위한 두 가지 핵심 원칙:

1. 정확한 멘션(@自己) 또는 특정 관리자 명령어 수신 시에만 Webhook을 트리거합니다.
2. 그룹 전체를 무차별적으로 리스닝하는 것을 엄격히 금지하고, 고주기 단간격 폴링 설정을 피합니다.

세부 규칙은 요금제 및 결제 및 루틴을 참조하세요.

실전 사례 분석

Feishu 멀티 Bot 협업 (铁柱AGI)

공인 IP 없이도 협업 시스템을 운영할 수 있으며, 핵심은 아웃바운드 영구 연결을 사용하여 포트 포워딩(홀펀칭)을 없애는 것입니다.

1. 일괄 등록: Feishu Python SDK를 통한 QR 코드 스캔 승인, 매니저 Bot이 Git 백업 테이블을 읽어 에디터, 회계, 가상 머신 등 3개 Bot의 키와 Webhook을 관리.
2. 보안 확인: 그룹 내에서는 @自己 또는 @所有人에만 응답합니다. 민감도가 높은 작업은 Bot이 카드 버튼을 푸시하여 수동으로 승인합니다.

WeChat ClawBot 휴대용 콘솔 (Kin)

WeChat 내에서 트위터 운영 및 카피라이팅 추출 Bot을 스케줄링하며, 공식 플러그인 롱 폴링을 사용하여 계정 정지를 방지합니다.

1. 24시간 연중무휴 가동되는 클라우드 PC에 프롬프트를 전송하여 텐센트 iLink(ilinkai.weixin.qq.com)를 호출하고, getupdates 폴링 및 sendmessage 스크립트를 정상 구동합니다.
2. 팝업 창을 통해 Webhook 및 시크릿 키를 전달하고, QR 코드 스캔 후 첫 메시지를 보내 초기 context_token을 발급받습니다.
3. 주의 사항: Markdown 기호를 제거하고 WeChat 응답을 반드시 일반 텍스트로 강제 변환해야 합니다.

WeChat 이미지/텍스트 아카이빙 파이프라인

WeChat 샌드박스는 패키지 전체 직접 전송을 제한하므로, 임시 웹하드를 중계 서버로 활용하여 제약을 우회할 수 있습니다.

1. 중계 업로드: Mac 또는 iPhone에서 「병합 전달」을 통해 채팅 ZIP 압축 파일을 내보내고, 단축어가 이를 filebin.net으로 자동 업로드합니다.
2. 자동 아카이빙: 단축어가 JSON을 구성하여 Grok Bot의 Webhook으로 전송하고, 압축을 풀어 「13개 디자인 영감 웹사이트」 등의 이미지와 텍스트를 아카이빙합니다.
3. 검수 기준: 반드시 경로와 요약이 포함된 구조화된 영수증을 출력해야 합니다.

구현 완료 후 검수 방법

Feishu

1. 메시지 응답: 1:1 대화는 1초 이내에 응답, 그룹 대화에서 일반 텍스트 전송 시에는 침묵, @文章主编 개별 멘션 시 응답, @所有人 멘션 시 각 Bot이 순차적으로 보고.
2. 권한 및 자가 치유: 백엔드에서 14가지 이벤트 권한을 모두 활성화하고 카드 기반 승인을 지원, 프로세스를 수동으로 종료했을 때 5~10초 이내에 자동으로 재실행.

WeChat

1. 환경 및 핸드셰이크: WeChat 버전이 iOS 8.0.70 또는 Android 8.0.69 이상이고 플러그인이 활성화되어 있어야 함, 스캔 후 첫 메시지는 context_token을 사용하여 회신하며 Markdown 깨짐 현상이 없어야 함.
2. 차단 및 오류 처리: 바인딩되지 않은 계정은 즉시 무시, 재부팅 후 자동으로 프로세스 재실행, 오류 코드 -14 발생 시 QR 코드 재스캔 안내.

단축어

1. 아카이빙 작업: Webhook, Bearer 키, 8자리 이상의 이미지 호스팅 ID를 정확히 입력, WeChat에서 첨부 파일을 먼저 클릭하여 로드한 뒤 병합 전달하거나 독립적으로 호출 가능.
2. 출력 및 정산: 수신 확인서(영수증)에는 반드시 요약, 노트 경로, 원본 보관 경로가 포함되어야 함, 요금제 페이지에서 사용량을 확인하여 지속적인 공회전으로 인한 과금을 방지.

관련 자료

• Grok Bot 사용 가이드 (Grok Bot 공식 워크플로 및 스킬 사용 가이드)
• 루틴 사용 가이드 (루틴 구성, Webhook 호출 및 예약 작업 공식 문서)
• 요금제 및 결제 (The X Subscription 구독 티어 및 사용량 안내)
• 비밀 정보 및 키 관리 (보안 환경 변수 및 암호화 팝업 메커니즘)
• 《Grok Bot 팀 Feishu 연동 상세 가이드(Feishu 매니저 템플릿 포함)》 (커뮤니티 작성자 铁柱AGI 원문)
• 《Grok Bot을 WeChat에 연동하는 방법 초보자를 위한 상세 가이드(상세 프롬프트 포함)｜Kin》 (커뮤니티 작성자 Kin 원문)
• 《WeChat 채팅 기록을 Grok Bot과 연동하기: 단축어 심화편》 (커뮤니티 작성자 铁柱AGI 원문)