메시지 ID를 통해 상세한 Feishu 메시지 내용과 전체 대화 스레드 기록을 가져오기 위한 전문 도구입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install feishu-msg-reader
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 feishu-msg-reader 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Feishu 메시지 페처란 무엇인가요?
Feishu 메시지 페처는 개발자와 AI 에이전트가 프로그래밍 방식으로 Feishu 커뮤니케이션 데이터에 액세스할 수 있도록 Openclaw Skills를 위해 설계된 강력한 통합 도구입니다. Feishu IM API를 활용하여 텍스트, 포스트, 이미지, 병합 전달 등 다양한 형식의 메시지 본문을 검색할 수 있습니다. 특히 포괄적인 스레드 컨텍스트 검색을 제공함으로써 대화형 카드와 관련된 플랫폼 제한을 극복하는 데 효과적입니다.
이 유틸리티는 AI 에이전트가 팀 환경 내에서 사용자 요청을 정확하게 처리하는 데 필요한 배경 정보를 갖추도록 보장합니다. 이를 Openclaw Skills 워크플로우에 통합하면 표준화된 인증 방법을 통해 높은 수준의 보안을 유지하면서 채팅 데이터 추출을 자동화할 수 있습니다.
Feishu 메시지 페처 활용 사례
- AI 에이전트가 message_id만 가지고 있을 때 정확한 메시지 내용을 추출합니다.
- 주변 스레드 컨텍스트를 분석하여 [Interactive Card] 자리 표시자 뒤의 실제 의도를 파악합니다.
- 문서화 또는 요약 목적으로 시간순 채팅 기록 수집을 자동화합니다.
- 에이전트가 Feishu 그룹 내에서 복잡한 대화 분기를 따라갈 수 있도록 지원합니다.
Feishu 메시지 페처 작동 원리
- 에이전트가 인바운드 메타데이터 또는 사용자 입력에서 대상 message_id를 식별합니다.
- Openclaw Skills 모듈이 로컬 설정 또는 환경 변수에 저장된 자격 증명을 사용하여 Feishu와 인증을 수행합니다.
- 스킬이 Feishu GET 메시지 API를 호출하여 특정 메시지 페이로드를 가져옵니다.
- 스레드 플래그가 활성화된 경우, 도구는 동일한 root_id를 공유하는 모든 메시지를 집계하기 위해 추가 조회를 수행하고 시간순으로 정렬합니다.
- 가져온 데이터는 파싱되어 에이전트가 즉시 사용할 수 있도록 구조화된 JSON 객체로 반환됩니다.
Feishu 메시지 페처 설정 가이드
Openclaw Skills 프레임워크 내에서 이를 사용하려면 로컬 구성 파일에 자격 증명이 설정되어 있는지 확인하세요.
# 스킬은 다음 위치에서 appId 및 appSecret을 자동으로 읽습니다:
# ~/.openclaw/openclaw.json
# 또는 환경 변수를 설정하세요:
export FEISHU_APP_ID='your_app_id'
export FEISHU_APP_SECRET='your_app_secret'
# 메시지를 가져오기 위한 기본 사용법
python3 scripts/fetch_message.py <message_id>
Feishu 메시지 페처 데이터 스키마 및 분류 체계
이 스킬은 다음 주요 필드를 포함하는 구조화된 JSON 객체를 반환합니다:
| 필드 | 설명 |
|---|---|
| message_id | 검색된 메시지의 고유 식별자. |
| msg_type | 메시지 형식(text, post, image 등). |
| content | 파싱된 메시지 본문 내용. |
| chat_id | 메시지가 발생한 채팅의 ID. |
| thread | 전체 대화 컨텍스트를 포함하는 배열(요청 시). |
| thread_count | 반환된 스레드의 총 메시지 수. |
Feishu 메시지 페처 고급 기능
- 다중 모드 검색: 단일 메시지, 전체 스레드 컨텍스트 또는 원시 API 응답 모드 지원.
- 자동 폴백: 플랫폼 API 제한에 대한 해결 방법으로 스레드 컨텍스트를 제공하여 대화형 카드를 지능적으로 처리.
- 유연한 인증: 구성 파일, 환경 변수 또는 직접적인 tenant_access_token 전달 지원.
- 시간순 정렬: Openclaw Skills 내에서 더 나은 AI 추론을 위해 커뮤니케이션의 정확한 순서대로 스레드 컨텍스트가 반환되도록 보장.
SKILL.md
로드 중
관련 Openclaw 스킬
Feishu 통합 전달 메시지 추출기
Feishu의 통합 및 전달 메시지 형식 내의 하위 메시지를 프로그래밍 방식으로 검색하고 파싱하기 위한 전문 유틸리티입니다.
Feishu Markdown to Blocks
Markdown 콘텐츠를 Feishu 블록 구조로 변환하고 정확한 위치 지정을 통해 기존 문서에 삽입하기 위한 전문 도구입니다.
Feishu 문서 동기화
Markdown을 통해 Feishu 문서, 스프레드시트 및 복잡한 블록 구조를 관리하기 위한 고성능 동기화 도구입니다.
Feishu 스레드 전달
Feishu Open API를 통해 Feishu 스레드 수준의 주제를 사용자, 그룹 또는 다른 스레드로 전달하기 위한 전문 도구입니다.
추천*
