메인 콘텐츠로 건너뛰기
공식 QQ Open Platform Bot API를 사용하여 QQ(중국에서 가장 인기 있는 메시징 앱)를 Claw 인스턴스에 연결하세요.

​
사전 요구 사항

​
설정 가이드

1

QQ Bot 애플리케이션 생성

  1. QQ Open Platform으로 이동합니다
  2. 로그인 후 Bot 섹션으로 이동합니다
  3. Create Bot을 클릭합니다
  4. 봇 정보(이름, 아바타, 설명)를 입력합니다
  5. 검토를 위해 제출합니다
2

자격 증명 가져오기

  1. 승인되면 봇의 Development Settings로 이동합니다
  2. AppID를 복사합니다
  3. AppSecret(Client Secret)을 복사합니다
3

샌드박스 구성 (테스트용)

  1. 봇 설정에서 Sandbox Configuration으로 이동합니다
  2. 샌드박스 화이트리스트에 QQ 번호를 추가합니다
  3. 이를 통해 실제 배포 전에 테스트할 수 있습니다
프로덕션 검토를 위해 제출하기 전에 샌드박스 모드에서 모든 것이 작동하는지 먼저 확인하세요.
4

LemonData 대시보드에서 구성

  1. Claw 대시보드로 이동합니다
  2. 인스턴스에서 설정 아이콘을 클릭합니다
  3. IM Integrations 탭을 엽니다
  4. QQ 섹션을 확장합니다
  5. AppID와 AppSecret을 붙여넣습니다
  6. Save를 클릭합니다
5

채팅 시작하기

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

​
지원되는 메시지 유형

유형설명
C2C (개인)봇에게 보내는 다이렉트 메시지
그룹 @mentionQQ 그룹에서 봇을 @mention
채널QQ 채널(频道)의 메시지

​
문제 해결

  • AppID 및 AppSecret이 올바른지 확인하세요
  • (테스트 중인 경우) QQ 번호가 샌드박스 화이트리스트에 있는지 확인하세요
  • 봇 애플리케이션이 승인되었는지 확인하세요
  • AppID를 다시 확인하세요 — 숫자 문자열이어야 합니다
  • 올바른 AppSecret을 사용하고 있는지 확인하세요 (토큰이 아님)