사전 요구 사항
설정 가이드
DingTalk 앱 생성
- DingTalk Open Platform으로 이동합니다.
- Application Development → Enterprise Internal Development를 클릭합니다.
- Create Application을 클릭합니다.
- 앱 이름과 설명을 입력합니다.
- Confirm을 클릭합니다.
로봇 기능 활성화
- 앱에서 App Features → Robot으로 이동합니다.
- 로봇 구성을 활성화합니다.
- Stream Mode를 선택합니다 (권장 — 퍼블릭 URL이 필요하지 않음).
- Publish를 클릭합니다.
앱 게시
- Version Management로 이동합니다.
- 새 버전을 생성합니다 (최소한 테스트 버전).
- 공개 범위(봇을 볼 수 있는 사용자/부서)를 설정합니다.
- 제출 및 게시합니다.
LemonData 대시보드에서 구성
- Claw Dashboard로 이동합니다.
- 인스턴스의 설정 아이콘을 클릭합니다.
- IM Integrations 탭을 엽니다.
- DingTalk 섹션을 확장합니다.
- AppKey와 AppSecret을 붙여넣습니다.
- Save를 클릭합니다.
그룹 설정
대시보드의 IM Integrations 탭에서 그룹 채팅 동작을 구성하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 그룹에서 봇을 트리거할 수 있는 사용자를 제어합니다 |
| Group Allowed Users | 사용자 ID 목록 | 이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드) |
DingTalk은 그룹에서 봇을 트리거하기 위해 항상 @mention이 필요합니다 — 이는 플랫폼 제한 사항이며 구성할 수 없습니다. DingTalk에서는 그룹 ID 필터링을 사용할 수 없습니다. 액세스를 제어하려면 Group Policy 설정을 사용하세요.
문제 해결
봇이 응답하지 않음
봇이 응답하지 않음
- AppKey와 AppSecret이 올바른지 확인하세요
- 앱이 게시되었는지 확인하세요 (최소 테스트 버전)
- 로봇 구성에서 Stream 모드가 선택되었는지 확인하세요
- 사용자 계정에서 봇이 보이는지 확인하세요
연결이 자주 끊김
연결이 자주 끊김
- Stream 모드는 지속적인 WebSocket 연결을 유지합니다
- 일시적인 연결 끊김은 정상입니다 — 봇이 자동으로 재연결됩니다
- 문제가 지속되면 대시보드에서 인스턴스를 재시작해 보세요