OpenClaw를 활용하여 효율적인 작업 환경을 구축했다면, 이제 이를 Feishu(Lark)와 연동하여 메신저 인터페이스를 통해 제어할 수 있습니다. 이 가이드에서는 Feishu 앱 생성부터 OpenClaw 채널 연결, 보안 설정까지의 전 과정을 상세히 설명합니다.
1. Feishu 애플리케이션 생성 및 권한 설정
먼저 Feishu 오픈 플랫폼(https://open.feishu.cn/app)에 접속하여 관리자 권한으로 로그인합니다. '기업 자빌드 앱 생성(Create Custom App)'을 클릭하고 앱 이름과 설명을 입력하여 프로젝트를 생성합니다.
애플리케이션이 생성되면 왼쪽 메뉴에서 봇(Bot) 기능을 찾아 '활성화(Enable)'를 클릭합니다. 그 다음 권한 관리(Permission Management) 섹션으로 이동하여 아래의 권한 구성을 적용합니다. '권한 일괄 가져오기/내보내기' 기능을 활용하면 편리합니다.
{
"scopes": {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"im:chat.members:bot_access",
"im:resource",
"aily:file:read",
"aily:file:write",
"application:application:self_manage",
"contact:user.employee_id:readonly",
"cardkit:card:read",
"cardkit:card:write"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read",
"aily:file:read",
"aily:file:write"
]
}
}
권한 신청이 완료되면 버전 관리 및 배포 메뉴에서 새 버전을 생성합니다. 버전 번호와 업데이트 내역을 입력한 뒤 앱을 배포합니다. 배포 후 자격 증명 및 기본 정보 탭에서 App ID와 App Secret을 안전하게 보관하세요.
2. OpenClaw CLI를 통한 채널 추가
터미널을 열고 OpenClaw가 설치된 환경에서 다음 명령어를 실행하여 Feishu 채널을 등록합니다.
openclaw channels add
상호작용 프롬프트가 나타나면 다음 순서로 설정을 진행합니다.
- 채널 유형으로 Feishu/Lark를 선택합니다.
- 설치 소스로 Download from npm을 선택합니다.
- 이전 단계에서 확인한 App ID와 App Secret을 차례로 입력합니다.
- 보안 전략 설정 시 Pairing Code(페어링 코드) 방식을 권장합니다. 이는 승인되지 않은 사용자가 봇을 조작하는 것을 방지하기 위한 필수 안전 장치입니다.
3. 이벤트 구독 및 콜백 설정
다시 Feishu 오픈 플랫폼의 앱 설정 페이지로 돌아가 이벤트 및 콜백(Events & Callbacks) 메뉴를 선택합니다. 연결 방식으로 장기 연결(Long Connection/WebSocket)을 선택하고 저장합니다.
이어 '이벤트 추가' 버튼을 눌러 메시지 수신(Receive Message) 이벤트를 검색하고 체크합니다. 설정 변경 사항을 적용하기 위해 다시 한 번 버전 관리 메뉴에서 새 버전을 생성하고 배포 프로세스를 완료해야 합니다.
4. 최종 기기 페어링
Feishu 클라이언트 앱을 실행하고 생성한 봇의 이름을 검색하여 대화를 시작합니다. 봇에게 아무 메시지나 보내면 페어링을 위한 인증 코드가 포함된 안내 메시지가 돌아옵니다. 해당 코드를 복사하여 터미널에 다음과 같이 입력합니다.
# 예시: openclaw pairing approve feishu [인증코드]
openclaw pairing approve feishu 9PH4V4CX
성공 메시지가 출력되면 이제 Feishu를 통해 OpenClaw와 자유롭게 대화할 수 있는 상태가 됩니다.
5. 기능 확장 및 활용 예시
연동된 봇은 단순한 대화를 넘어 시스템 제어 및 파일 전송 등의 작업을 수행할 수 있습니다. 예를 들어 원격지에 있는 PC의 파일을 전송받고 싶다면, 봇이 해당 기능을 학습할 수 있도록 가이드를 제공해야 합니다.
채팅창에 다음과 같은 지침을 입력하여 봇의 동작 방식을 정의할 수 있습니다.
"Feishu의 파일 및 이미지 전송 API를 활용하여 워크스페이스 내의 문서를 사용자에게 전송하는 기능을 학습하세요.
앞으로 내가 특정 파일을 요청하면 해당 경로의 파일을 작업 공간으로 가져와 즉시 전송해야 합니다."
이러한 프롬프트를 통해 봇은 자동으로 관련 기능을 최적화하며, 이후 PDF나 이미지 파일 등을 요청했을 때 즉각적으로 응답하게 됩니다.