메인 콘텐츠로 건너뛰기
공식 QQ Open Platform Bot API를 사용하여 LemonClaw 인스턴스를 QQ(중국에서 가장 인기 있는 메시징 앱)에 연결하세요. 이 가이드는 호스팅된 Claw 인스턴스와 셀프 호스팅 LemonClaw 배포 모두에 적용됩니다.

​
사전 요구 사항

​
설정 가이드

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

LemonClaw WebUI 열기

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

채팅 시작하기

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

​
지원되는 메시지 유형

유형설명
C2C (개인)봇에게 보내는 직접 메시지
그룹 @멘션QQ 그룹에서 봇을 @멘션
채널QQ 채널(频道)에서의 메시지

​
문제 해결

현재 LemonClaw의 QQ 지원 범위는 개인 메시지와 그룹 내 @bot 이벤트입니다. @ 없는 일반 그룹 메시지와 QQ 채널 대화는 아직 지원되지 않습니다.
  • AppID와 AppSecret이 올바른지 확인하세요
  • 테스트 중인 경우 QQ 번호가 샌드박스 화이트리스트에 있는지 확인하세요
  • 봇 애플리케이션이 승인되었는지 확인하세요
  • AppID를 다시 확인하세요. 숫자로 된 문자열이어야 합니다
  • 토큰이 아닌 올바른 AppSecret을 사용하고 있는지 확인하세요