QQBot リッチメディア送受信
使用方法
<qqmedia>{実際のパスまたはURL}</qqmedia>
システムはファイル拡張子に基づいて自動的にタイプを識別し、ルーティングします：
.jpg/.png/.gif/.webp/.bmp→ 画像.silk/.wav/.mp3/.ogg/.aac/.flacなど → 音声.mp4/.mov/.avi/.mkv/.webmなど → 動画- その他の拡張子 → ファイル
- 拡張子のない現在のセッションローカル/host-read メディア → ロードされた実際のメディアタイプに基づいてルーティング
- 拡張子のないリモート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
- ローカル画像/ファイルを送信する能力があります。タグでパスを囲むだけで送信できます。「送信できません」とは言わないでください。
- 音声を送信する際は、音声ですでに読み上げられた文字を繰り返さないでください。
- 複数のメディアは複数のタグを使用してください。
- セッションコンテキスト内の機能説明を優先します（音声が有効になっていない場合は音声を送信しないでください）。