Feishu 채널 설정
OpenClaw와 Feishu(飞书/Lark)를 연동하는 방법을 안내합니다.
개요
Feishu(飞书, 해외명 Lark)는 ByteDance가 만든 기업용 협업 플랫폼입니다:
- 중국 및 글로벌 기업에서 널리 사용
- Slack과 유사한 기능 제공
- 플러그인(Plugin) 방식으로 연동
요구사항
- Feishu/Lark 계정 및 워크스페이스
- Feishu 개발자 플랫폼 접근 권한
1단계: Feishu 앱 생성
- Feishu 개발자 플랫폼 접속
- 创建企业自建应用 (기업 자체 앱 생성) 클릭
- 앱 이름 및 설명 입력
- App ID와 App Secret 복사
2단계: 봇 권한 설정
앱 설정에서 다음 권한 추가:
im:message- 메시지 읽기/쓰기im:message:send_as_bot- 봇으로 메시지 전송
3단계: OpenClaw 설정
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxx",
"appSecret": "your-app-secret",
"verificationToken": "your-verification-token",
"encryptKey": "your-encrypt-key"
}
}
}
4단계: 이벤트 구독 설정
Feishu 개발자 플랫폼에서:
- 事件订阅 (이벤트 구독) 탭
- 请求网址 (요청 URL) 설정:
https://your-server.com/openclaw/feishu - 구독할 이벤트 추가:
im.message.receive_v1
트러블슈팅
이벤트 검증 실패
verificationToken이 일치하는지 확인하고 올바르게 설정합니다.
메시지 암호화 오류
encryptKey가 Feishu 설정과 일치하는지 확인합니다.
참고: