QQBot 富媒体收发은(는) 무엇을 하나요?
사용법
<qqmedia>{실제 경로 또는 URL}</qqmedia>
시스템이 파일 확장자를 기준으로 자동으로 유형을 식별하고 라우팅합니다.
.jpg/.png/.gif/.webp/.bmp→ 이미지.silk/.wav/.mp3/.ogg/.aac/.flac등 → 음성.mp4/.mov/.avi/.mkv/.webm등 → 비디오- 기타 확장자 → 파일
- 확장자가 없는 현재 세션 로컬/호스트 읽기 미디어 → 로드된 실제 미디어 유형에 따라 라우팅
- 확장자가 없는 원격 URL → 파일로 전송될 수 있음; 이미지/음성/비디오가 필요하면 유형을 식별할 수 있는 URL/경로를 제공하거나 명시적인 미디어 태그를 사용하세요
미디어 수신
- 사용자가 보낸 이미지는 QQBot 런타임에 의해 OpenClaw가 관리하는 QQBot 미디어 디렉토리에 다운로드되며, 경로는 현재 세션의 첨부 파일 컨텍스트로만 사용됩니다.
- 사용자가 보낸 음성 경로는 컨텍스트에 포함됩니다. STT 기능이 있으면 우선적으로 변환합니다.
- 첨부 파일 경로와 원격 URL에는 사용자의 개인 콘텐츠가 포함될 수 있습니다. 로컬 절대 경로를 무관하게 출력하지 말고, 첨부 파일을 다른 세션으로 전달하지 마세요. 사용자가 명시적으로 해당 미디어를 다시 보내거나 분석하거나 저장하도록 요청한 경우에만 사용하세요.
- 첨부 파일의 장기 보존을 보장하지 않습니다. 사용자가 장기 보관을 원하면 사용자가 직접 저장하거나 다시 보내도록 안내하세요.
규칙
- 태그는 열림-닫힘 태그로 실제 경로 또는 URL을 감싸야 합니다:
<qqmedia>{실제 경로 또는 URL}</qqmedia> - 실제로 보이는 파일 경로를 사용하세요: 파일을 생성한 직후에는 생성 결과에 표시된 경로를 사용하세요. 샌드박스 workspace-write 생성 결과에 실제로
/workspace/...가 표시되는 경우에만 그 경로를 그대로 사용합니다. 예:<qqmedia>/workspace/report.pdf</qqmedia> - 첨부 파일 경로는 컨텍스트에서 제공된 경로를 직접 사용하세요: 경로가 세션 [첨부 파일] 컨텍스트에서 온 경우
/workspace/...로 다시 쓰지 마세요. - URL은 직접 보낼 수 있습니다: 예:
<qqmedia>https://example.com/image.png</qqmedia> - 로컬 경로는 여전히 보안 루트에 의해 제한됩니다: 현재 세션에 권한이 부여된 에이전트 작업 공간, 범위 지정 미디어 루트, OpenClaw 미디어 디렉토리 또는 QQBot 미디어 디렉토리 내의 파일만 보낼 수 있습니다.
..를 사용하여 작업 공간을 이스케이프하지 마세요. - 컨텍스트 외부의 로컬 파일을 스캔하거나 능동적으로 보내지 마세요: 사용자가 제공한 파일, 도구가 방금 생성한 파일, 또는 현재 세션 컨텍스트에서 명시적으로 제공된 경로만 사용하세요.
- 파일 크기 제한: 이미지 30MB / 비디오 100MB / 파일 100MB / 음성 20MB
- 로컬 이미지/파일을 보낼 수 있습니다: 태그로 경로를 감싸기만 하면 됩니다. "보낼 수 없습니다"라고 말하지 마세요.
- 음성을 보낼 때 이미 음성에서 낭독된 텍스트를 반복하지 마세요.
- 여러 미디어는 여러 태그를 사용하세요.
- 세션 컨텍스트의 기능 설명을 따르세요(예: 음성이 활성화되지 않은 경우 음성을 보내지 마세요).