OpenClaw QQ 봇 채널
커뮤니티 플러그인을 통해 OpenClaw를 QQ에 연결합니다(QQ는 OpenClaw 공식 내장 채널이 아닙니다). 이 통합은 개인 메시지, 그룹 채팅(@트리거), 채널 메시지, 채널 DM, 리치 미디어(이미지, 오디오, 비디오, 파일), 음성-텍스트 변환, 예약 메시지, Markdown 형식 및 인용 메시지 컨텍스트를 지원합니다. 플러그인을 설치하고, QQ 오픈 플랫폼에서 봇을 생성하고, 인증 정보를 구성하면 시작할 수 있습니다.
QQ 지원 기능
텍스트 메시지
지원
미디어 및 파일
지원
리액션
미지원
스레드
미지원
음성 메시지
지원
그룹 채팅
지원
QQ 사전 요구사항
- QQ 오픈 플랫폼 개발자 계정
- QQ 플러그인 설치: openclaw plugins install @openclaw-china/qqbot
- OpenClaw Gateway가 실행 및 구성되어 있어야 함
- 서버에 Node.js 18+가 설치되어 있어야 함
QQ 빠른 설정
QQ 플러그인 설치
터미널에서 'openclaw plugins install @openclaw-china/qqbot'를 실행하여 Tencent 공식 유지보수 QQ 봇 플러그인을 설치합니다. 이 플러그인은 GitHub에서 186개의 스타를 보유하고 있습니다.
QQ 오픈 플랫폼에서 봇 생성
QQ 오픈 플랫폼(q.qq.com)에 로그인하여 새로운 봇 애플리케이션을 생성합니다. 앱 설정 페이지에서 AppID와 ClientSecret 인증 정보를 획득합니다. 이것은 OpenClaw와 QQ를 연결하는 데 필요한 정보입니다.
권한 구성
QQ 오픈 플랫폼의 권한 관리 페이지에서 봇에 필요한 권한을 설정합니다. 개인 메시지, 그룹 채팅, 채널 메시지 등 관련 권한과 미디어 메시지 전송 권한을 활성화합니다. 완료 후 심사에 제출합니다.
OpenClaw 구성 및 테스트
권장: 'openclaw china setup'를 실행하여 대화형 설정 마법사를 시작합니다. 또는 ~/.openclaw/openclaw.json에 QQ 채널 구성을 추가하고 appId와 clientSecret를 입력합니다. 'openclaw gateway restart'를 실행하여 Gateway를 재시작하고, QQ에서 봇에게 메시지를 보내 정상 작동하는지 테스트합니다.
QQ 구성 예시
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "your-app-id",
"clientSecret": "your-app-secret",
"sandbox": false,
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}QQ 통합 가이드
OpenClaw QQ 아키텍처 개요
OpenClaw QQ 플러그인 설치
# QQ 플러그인 설치
openclaw plugins install @openclaw-china/qqbot
# 설치 확인
openclaw plugins list
# 플러그인 업데이트
openclaw plugins update @openclaw-china/qqbot
# 대화형 설정 마법사 시작
openclaw china setupOpenClaw QQ 봇 생성
# 환경 변수로 설정
export QQ_APP_ID="your-app-id"
export QQ_CLIENT_SECRET="your-app-secret"
# 또는 CLI로 설정
openclaw channels addOpenClaw QQ 메시지 유형 및 미디어 지원
OpenClaw QQ 그룹 채팅 및 채널 구성
{
"channels": {
"qqbot": {
"dmEnabled": true,
"groupEnabled": true,
"channelEnabled": true
}
}
}OpenClaw QQ 유용한 명령어
QQ 구성 참조
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | QQ 채널 활성화 또는 비활성화 |
| appId | string | "" | QQ 봇의 AppID, QQ 오픈 플랫폼에서 획득 |
| clientSecret | string | "" | QQ 봇의 ClientSecret, QQ 오픈 플랫폼에서 획득 |
| sandbox | boolean | false | 샌드박스 모드 활성화, 개발 및 테스트 환경용 |
| dmEnabled | boolean | true | 개인 메시지 응답 활성화 |
| groupEnabled | boolean | true | 그룹 채팅 메시지 응답 활성화(@트리거 필요) |
| channelEnabled | boolean | true | QQ 채널 메시지 응답 활성화 |
| messageFormat | string | "markdown" | 응답 메시지 형식. 옵션: text(일반 텍스트), markdown |
| debug | boolean | false | 디버그 모드 활성화, 연결 및 메시지에 대한 상세 로그 출력 |
QQ 채널 활성화 또는 비활성화
QQ 봇의 AppID, QQ 오픈 플랫폼에서 획득
QQ 봇의 ClientSecret, QQ 오픈 플랫폼에서 획득
샌드박스 모드 활성화, 개발 및 테스트 환경용
개인 메시지 응답 활성화
그룹 채팅 메시지 응답 활성화(@트리거 필요)
QQ 채널 메시지 응답 활성화
응답 메시지 형식. 옵션: text(일반 텍스트), markdown
디버그 모드 활성화, 연결 및 메시지에 대한 상세 로그 출력
QQ 자주 묻는 질문
QQ 문제 해결
AppID 또는 ClientSecret가 올바르지 않거나, 플러그인이 제대로 설치되지 않았거나, 봇이 플랫폼 심사를 통과하지 못함.
QQ 서버에 능동 메시지 필터링 메커니즘이 있어 응답 유형이 아닌 메시지가 차단될 수 있음.
미디어 메시지 관련 권한이 부족하거나 파일 크기가 QQ 플랫폼 제한을 초과.
channelEnabled가 활성화되지 않았거나 봇이 QQ 채널에 추가되지 않음.
음성 인식 서비스 이상 또는 권한 부족.