Feishu 채널 설정
Feishu 앱을 생성하고 OpenClaw의 채널로 구성하는 단계별 안내입니다.
Feishu 개발자 콘솔 열기
https://open.feishu.cn/app 에 접속한 뒤 Feishu 계정으로 로그인하세요.
앱 만들기
'Create Enterprise App'을 클릭하고 앱 이름/설명을 입력한 뒤 아이콘을 선택하세요.

앱 자격 증명 받기
'Credentials & Basic Info' 페이지에서 App ID(`cli_xxx` 형식)와 App Secret을 복사하세요. App Secret은 안전하게 보관하세요.

봇 기능 활성화
'App Capabilities' > 'Bot'에서 봇 기능을 활성화하여 앱이 채팅에서 봇으로 동작하도록 하세요.

권한 설정
'Permission Management'에서 'Bulk Import'를 클릭하고 아래 JSON을 붙여넣어 필요한 테넌트/사용자 권한을 가져오세요. ```json { "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ```

OpenClaw에 Feishu 채널 추가
OpenClaw에 로그인한 뒤 'My OpenClaw' → 'Channels'에서 '+ Add Channel'을 클릭하세요. Feishu App ID와 App Secret을 입력하고 저장한 뒤 설정 완료를 기다리세요.

이벤트 구독 및 콜백 설정
'Use long connection to receive events'(WebSocket 모드)를 선택하세요. 참고: OpenClaw에서 먼저 Feishu 채널이 설정되어 있어야 하며, 아니면 저장이 실패할 수 있습니다.

수신 메시지를 받기 위해 `im.message.receive_v1` 이벤트를 추가하세요.

앱 게시
버전 정보를 입력하고 저장한 다음 앱을 게시하여 테넌트에서 사용할 수 있게 하세요.

봇과 채팅하기
Feishu Workbench에서 생성한 봇을 찾아 메시지를 보내 채팅을 시작하세요.

