메인 콘텐츠로 건너뛰기
Feishu (飞书) 또는 Lark를 LemonClaw 인스턴스에 연결하세요. 이 가이드는 호스팅된 Claw 인스턴스와 셀프 호스팅된 LemonClaw 배포 모두에 적용되며, WebSocket 모드를 사용하므로 공개 콜백 URL이 필요하지 않습니다.

​
사전 요구 사항

​
설정 가이드

1

Feishu 앱 생성

  1. Feishu Open Platform (또는 Lark Developer)으로 이동합니다.
  2. Create Custom App을 클릭합니다.
  3. 앱 이름과 설명을 입력합니다.
  4. Create를 클릭합니다.
2

봇 기능 추가

  1. 앱 설정에서 Features → Bot으로 이동합니다.
  2. 봇 기능을 활성화합니다.
  3. 이를 통해 앱이 메시지를 주고받을 수 있게 됩니다.
3

자격 증명 가져오기

  1. Credentials & Basic Info로 이동합니다.
  2. App ID (cli_로 시작)를 복사합니다.
  3. App Secret을 복사합니다.
4

이벤트 구독 구성

  1. Event Subscriptions로 이동합니다.
  2. WebSocket 모드를 선택합니다 (권장 — 공개 URL이 필요하지 않음).
  3. 메시지가 표시되면 Encrypt Key와 Verification Token을 설정합니다.
LemonClaw WebUI에서 Feishu를 구성할 때, Encrypt Key와 Verification Token이 자동으로 생성됩니다. 이 값들을 Feishu 개발자 콘솔에 복사하여 붙여넣으세요.
5

이벤트 권한 추가

  1. Event Subscriptions 아래에서 다음 이벤트를 추가합니다:
    • im.message.receive_v1 — 메시지 수신
  2. Permissions & Scopes로 이동하여 다음을 추가합니다:
    • im:message — 메시지 전송 및 수신
    • im:message.group_at_msg — 그룹 @멘션 수신
  3. Save를 클릭합니다.
6

앱 게시

  1. App Release → Version Management로 이동합니다.
  2. 새 버전을 생성합니다.
  3. 검토를 위해 제출합니다 (사내 앱의 경우 보통 즉시 승인됩니다).
  4. 승인되면 앱이 활성화됩니다.
7

LemonClaw WebUI 열기

  1. 호스팅된 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭합니다.
  2. LemonClaw를 셀프 호스팅하는 경우, 본인의 WebUI(예: http://your-ip:18789)를 열고 token으로 로그인합니다.
  3. WebUI에서 Settings → Channels로 이동합니다.
  4. Feishu 섹션을 확장합니다.
  5. App ID와 App Secret을 붙여넣습니다.
  6. 자동으로 생성된 Encrypt Key와 Verification Token을 다시 Feishu 개발자 콘솔에 복사합니다.
  7. Save를 클릭합니다.
8

채팅 시작하기

  1. Feishu에서 이름으로 봇을 검색합니다.
  2. 메시지를 보냅니다.
  3. 첫 번째 사용자는 자동으로 소유자(owner)로 페어링됩니다 — 코드가 필요 없습니다!
  4. AI와 채팅을 시작하세요!

​
그룹 설정

LemonClaw WebUI의 Channels 설정에서 그룹 채팅 동작을 구성하세요:
설정옵션설명
Group PolicyOpen (기본값) / Allowlist / Disabled그룹에서 누가 봇을 트리거할 수 있는지 제어합니다
Require @mentionOn / Off@멘션되었을 때만 봇이 응답합니다
Group IDs채팅 ID 목록특정 그룹으로 제한합니다 (비어 있으면 모든 그룹 허용)
Group Allowed UsersOpen ID 목록이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드)

​
문제 해결

  • 앱이 게시되고 승인되었는지 확인하세요
  • im.message.receive_v1 이벤트가 구독되어 있는지 확인하세요
  • WebSocket 모드가 선택되었는지 확인하세요 (HTTP 아님)
  • Feishu 콘솔과 LemonClaw 설정의 Encrypt Key 및 Verification Token이 일치하는지 확인하세요
  • 보통 App ID 또는 App Secret이 올바르지 않음을 의미합니다
  • 대시보드에서 자격 증명을 다시 확인하세요