Feishu 채널 설정

Feishu 앱을 생성하고 OpenClaw의 채널로 구성하는 단계별 안내입니다.

Feishu 개발자 콘솔 열기

1
개발자 콘솔 열기

https://open.feishu.cn/app 에 접속한 뒤 Feishu 계정으로 로그인하세요.

앱 만들기

2
새 기업용 앱 만들기

'Create Enterprise App'을 클릭하고 앱 이름/설명을 입력한 뒤 아이콘을 선택하세요.

새 기업용 앱 만들기

앱 자격 증명 받기

3
App ID와 App Secret 복사

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

App ID와 App Secret 복사

봇 기능 활성화

4
봇 활성화

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

봇 활성화

권한 설정

5
필수 권한 가져오기

'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 채널 추가

6
채널 추가

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

채널 추가

이벤트 구독 및 콜백 설정

7
연결 모드 선택

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

연결 모드 선택
8
메시지 수신 이벤트 추가

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

메시지 수신 이벤트 추가

앱 게시

9
게시

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

게시

봇과 채팅하기

10
봇에게 메시지 보내기

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

봇에게 메시지 보내기