Agent ツールに音声クライアントの作成と実行を任せ、Token Plan のリアルタイム音声対話モデルに接続します。
対応モデル
| モデル | 機能 |
|---|---|
qwen-audio-3.0-realtime-plus | リアルタイム音声対話 |
前提
- Token Plan を購読している。個人版は My Subscription(個人版) で
sk-sp-で始まる API Key を取得する。チーム版は メンバー管理 でシートを割り当ててから API Key を取得する。 - Python 3.9 以降、マイク、スピーカーが利用可能である。
ステップ 1:Agent ツールに接続指示を送る
以下の接続指示を展開してコピーし、使用している Agent ツールに送ります。設定済みの Token Plan Key を読み取り、依存関係をインストールし、qwen_realtime_voice.py を作成して実行します。Key の手動設定や Python の記述は不要です。
接続指示(音声クライアントスクリプトを含む)
接続指示(音声クライアントスクリプトを含む)
初回実行時に、システム設定で Agent ツールを実行するアプリ(Cursor や Terminal など)にマイクへのアクセスを許可してください。許可しないとスクリプトに音声が届きません。スピーカーの音声がマイクに入り、応答が中断されるのを防ぐため、ヘッドホンの使用を推奨します。
ステップ 2:音声対話を開始する
Agent ツールがスクリプトを起動したら、開始メッセージが表示されたときに話し始めます。ターミナルに認識結果とモデルの応答が表示され、スピーカーからモデルの音声が再生されます。Ctrl+C でセッションを終了します。
Agent ツールが依存関係のインストール、スクリプトの作成、セッションの開始を行います。音声データはローカルクライアントと Token Plan の間で送受信され、Agent ツールのテキストモデルは経由しません。
ツール拡張として保存する
再度使用する場合は、Agent ツールに上の指示を現在のツールの Skill、Slash Command、または Agent 設定として保存させ、そのツールの起動方法で実行します。主なツールの拡張メカニズムとパスは次のとおりです:
| ツール | 拡張メカニズム | 設定ファイルのパス |
|---|---|---|
| Claude Code | Slash Command | .claude/commands/voice-chat.md |
| Codex | Skill | ~/.codex/skills/token-plan-voice/SKILL.md |
| Qwen Code | Skill | ~/.qwen/skills/voice-chat/SKILL.md |
| OpenCode | Agent | .opencode/agents/voice-chat.md |
| OpenClaw | Skill | ~/.openclaw/workspace/skills/token-plan-voice/SKILL.md |
| Hermes Agent | Skill | ~/.hermes/skills/media/voice-chat/SKILL.md |
| Qoder | Skill | ~/.qoder/skills/voice-chat/SKILL.md |
制限
- スピーカーを使用すると、モデルの音声がマイクに拾われて応答が中断される場合があります。ヘッドホンを使用してください。
- Agent ツールの Bash 呼び出しにはタイムアウトがあります。長時間の対話では、スクリプトを独立したプロセスとして実行するか、MCP サーバーとしてラップしてください。
- 現在の構成は音声入力と出力のみを処理します。