메인 콘텐츠로 건너뛰기
Stream 모드를 사용하여 DingTalk(钉钉)을 LemonClaw 인스턴스에 연결하세요. 이는 퍼블릭 URL이 필요 없는 WebSocket 기반 연결 방식입니다. 이 가이드는 호스팅된 Claw 인스턴스와 셀프 호스팅된 LemonClaw 배포 모두에 적용됩니다.

​
사전 요구 사항

​
설정 가이드

1

DingTalk 앱 생성

  1. DingTalk Open Platform으로 이동합니다
  2. Application Development → Enterprise Internal Development를 클릭합니다
  3. Create Application을 클릭합니다
  4. 앱 이름과 설명을 입력합니다
  5. Confirm을 클릭합니다
2

로봇 기능 활성화

  1. 앱에서 App Features → Robot으로 이동합니다
  2. 로봇 구성을 활성화합니다
  3. Stream Mode를 선택합니다 (권장 — 퍼블릭 URL이 필요하지 않음)
  4. Publish를 클릭합니다
Stream 모드는 WebSocket을 사용하므로 LemonClaw 인스턴스에 공개적으로 액세스 가능한 webhook URL이 필요하지 않습니다. 가장 간단한 설정 방법입니다.
3

자격 증명 가져오기

  1. Basic Information → Credentials로 이동합니다
  2. AppKey와 AppSecret을 복사합니다
4

앱 게시

  1. Version Management로 이동합니다
  2. 새 버전을 생성합니다 (최소한 테스트 버전 이상)
  3. 공개 범위를 설정합니다 (봇을 볼 수 있는 사용자/부서)
  4. 제출 및 게시합니다
5

LemonClaw WebUI 열기

  1. 호스팅된 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭합니다
  2. LemonClaw를 셀프 호스팅하는 경우, 자체 WebUI(예: http://your-ip:18789)를 열고 token으로 로그인합니다
  3. WebUI에서 Settings → Channels로 이동합니다
  4. DingTalk 섹션을 확장합니다
  5. AppKey와 AppSecret을 붙여넣습니다
  6. Save를 클릭합니다
6

채팅 시작하기

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

​
그룹 설정

LemonClaw WebUI의 Channels 설정에서 그룹 채팅 동작을 구성하세요:
설정옵션설명
Group PolicyOpen (기본값) / Allowlist / Disabled그룹에서 봇을 트리거할 수 있는 사용자를 제어합니다
Group Allowed Users사용자 ID 목록이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드)
DingTalk은 그룹에서 봇을 트리거하기 위해 항상 @mention이 필요합니다. 이는 플랫폼의 제한 사항이며 구성할 수 없습니다. DingTalk에서는 그룹 ID 필터링을 사용할 수 없습니다. 액세스를 제어하려면 Group Policy 설정을 사용하세요.

​
문제 해결

현재 LemonClaw의 DingTalk 지원은 아직 완전한 그룹 워크벤치 통합이 아닙니다. 그룹 메시지는 봇을 @멘션했을 때만 AI 흐름에 들어가며, 응답은 원래 sessionWebhook을 우선 사용합니다.
  • AppKey와 AppSecret이 올바른지 확인하세요
  • 앱이 게시되었는지 확인하세요 (최소 테스트 버전)
  • 로봇 구성에서 Stream 모드가 선택되었는지 확인하세요
  • 사용자 계정에서 봇이 보이는지 확인하세요
  • Stream 모드는 지속적인 WebSocket 연결을 유지합니다
  • 일시적인 연결 끊김은 정상이며, 봇이 자동으로 재연결됩니다
  • 문제가 지속되면 대시보드에서 인스턴스를 재시작해 보세요