codex-feishu-onboarding-kit은(는) 무엇을 하나요?
Feishu CLI, 양방향 봇 채팅, 상시 실행되는 클라우드 런타임을 안전하게 연결하는 Codex 스킬입니다.
개요
이 스킬은 Codex 에이전트가 Feishu(飞书) 생태계와 원활하게 통합되도록 돕습니다. 주요 기능은 다음과 같습니다:
- CLI 통합: Feishu Open API와 직접 상호작용할 수 있는 CLI 명령어 제공
- 봇 채팅: 양방향 실시간 봇 채팅 지원 (사용자 ↔ 에이전트)
- 클라우드 런타임: 상시 실행되는 환경에서 안정적인 작업 처리
시작하기
전제 조건
- Codex 에이전트가 설치 및 설정되어 있어야 합니다.
- 유효한 Feishu 개발자 계정과 앱이 필요합니다.
- 적절한 권한이 있는 Feishu Personal Access Token (PAT)이 필요합니다.
설치
이 스킬을 Codex 환경에 복제하거나 추가합니다:
codex skill add wochihuolg/codex-feishu-onboarding-kit
또는 저장소를 클론합니다:
git clone https://github.com/wochihuolg/codex-feishu-onboarding-kit.git
cd codex-feishu-onboarding-kit
구성
스킬 디렉토리에 .env 파일을 생성하고 Feishu 자격 증명을 설정합니다:
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_PAT=your_personal_access_token
사용법
CLI 명령어
codex run feishu:send-message --to "user_id" --text "Hello from Codex!"
봇 채팅
메시지를 수신하고 응답하도록 봇을 구성:
from skill import FeishuBot
bot = FeishuBot(token=FEISHU_PAT)
bot.on("message", lambda event: print(f"수신: {event.text}"))
bot.start()
아키텍처
graph TD
A[사용자] -->|CLI 명령| B[Codex CLI]
A -->|봇 채팅| C[Feishu Bot]
B --> D[스킬 핸들러]
C --> D
D --> E[Feishu Open API]
E --> F[Feishu 플랫폼]
보안
- 모든 통신은 HTTPS를 통해 암호화됩니다.
- PAT(Personal Access Tokens)는 안전하게 저장해야 하며 절대 공유하지 마십시오.
- 승인된 엔드포인트만 API 호출이 허용됩니다.
문제 해결
일반적인 문제
- 인증 오류:
FEISHU_PAT가 올바르게 설정되었고 만료되지 않았는지 확인하십시오. - 연결 시간 초과: 방화벽이
open.feishu.cn으로의 아웃바운드 연결을 허용하는지 확인하십시오. - 메시지 전송 실패: 대상 사용자 ID가 올바르고 Feishu 테넌트 내에 존재하는지 확인하십시오.
라이선스
MIT
기여하기
버그 수정, 기능 제안, 풀 리퀘스트를 환영합니다. 주요 변경 사항의 경우 먼저 이슈를 열어 논의해 주십시오.