ターミナルやAI環境から直接Sonosスピーカーの検出、制御、グループ化を行うための、Goベースの強力なCLIです。
インストール＆ダウンロード
1. ClawHub CLI
レジストリから直接スキルをインストールする最速の方法です。
npx clawhub@latest install sonoscli
2. 手動インストール
スキルフォルダを以下のいずれかの場所にコピーしてください
~/.openclaw/skills/ <project>/skills/ 優先順位：ワークスペース > ローカル > バンドル
3. プロンプトのインストール
このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。
Clawhubを使って sonoscli をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。
ダウンロードをご希望ですか？
ZIPアーカイブで生のスキルファイルを取得します。
Sonos CLI とは？
Sonos CLIは、コマンドラインを介してSonosオーディオハードウェアとやり取りするための包括的なインターフェースを提供します。Openclaw Skills用のこのスキルにより、ユーザーはスピーカーの検出、音量調整、再生制御などの複雑なアクションをシンプルなコマンドで実行できます。既存の自動化スクリプトやローカルネットワーク管理ツールにスマートホームオーディオを統合したい開発者にとって、特に有用です。
sonosバイナリを利用することで、ユーザーは開発環境と物理的なオーディオ設定の間のギャップを埋めることができます。スピーカーを素早くミュートする必要がある場合でも、複数の部屋で同期されたパーティグループを設定する必要がある場合でも、このツールはCLIアプリケーションの精度と速度を提供します。
Sonos CLI のユースケース
- 特定のトリガーやスケジュールに基づいた音楽再生の自動化。
- 開発や集中セッション中の音量と再生のプログラム制御。
- 同期されたホームオーディオのためのマルチルームスピーカーグループの管理。
- システム監視ツールやダッシュボードに統合するためのスピーカー状態のクエリ。
Sonos CLI の仕組み
- ツールはSSDPを使用して、ローカルサブネット上のすべてのアクティブなSonosスピーカーを見つける検出プロセスを開始します。
- ユーザーは名前またはIPアドレスで特定のスピーカーを指定し、再生または音量コマンドを発行します。
- CLIはSonos UPnP APIと通信して、再生、一時停止、スキップなどのリクエストされたアクションを実行します。
- 音楽検索では、ツールはSMAPI（Sonos Music API）を利用して、コマンドラインから直接Spotifyなどのサービスを閲覧します。
Sonos CLI のセットアップ
Openclaw Skillsワークフロー内でこれを使用するには、Goがインストールされている必要があります。次のコマンドを実行してバイナリをインストールします。
go install github.com/steipete/sonoscli/cmd/sonos@latest
インストール後、次を実行して接続を確認します。
sonos discover
スピーカーが自動的に見つからない場合は、--ipフラグを使用して直接指定できます。
Sonos CLI のデータスキーマとタクソノミー
| コマンドコンポーネント | 説明 |
|---|---|
discover |
ローカルネットワーク上のSonosデバイスをスキャン |
--name |
ターゲットスピーカー識別子文字列（例："Kitchen"） |
--ip |
手動接続用の直接IPアドレス |
favorites |
保存されたSonosお気に入りステーションの一覧表示または開始 |
smapi search |
特定のサービスプロバイダーを介した音楽検索の実行 |
queue |
アクティブなキューの一覧表示、再生、またはクリアのための管理コマンド |
Sonos CLI の高度な機能
- 参加、解除、ソロ、マルチスピーカー同期のためのパーティモードを含むグループ管理。
- 検索機能を強化するための、オプションの
SPOTIFY_CLIENT_IDおよびSECRETを使用したSpotify Web APIとの統合。 - クリアや特定のトラックの再生を含む完全なキュー操作。
- SSDP検出が失敗する可能性がある複雑なネットワーク環境向けの手動IPオーバーライド機能。
SKILL.md
ローディング
関連するOpenclawのスキル
Songsee
Songseeは、オーディオファイルを詳細なスペクトログラムやマルチパネルの特徴視覚化に変換するために設計された、高性能なCLIユーティリティです。
Slack アクション
AI エージェントを介してメッセージング、リアクション、チャンネル整理など、Slack ワークスペースのインタラクションを管理するための堅牢な統合機能です。
sag
プロフェッショナルな AI 音声生成に macOS スタイルのシンプルさをもたらす、高性能な ElevenLabs テキスト読み上げ用 CLI 工具です。
Spotify プレイヤー
spogo または spotify_player を使用して Spotify の再生を検索および制御するためのコマンドラインインターフェーススキルです。
Summarize
高度な AI モデルを使用して、Web ページ、ローカル ドキュメント、マルチメディア コンテンツの簡潔な要約を生成する高性能 CLI ユーティリティです。
特徴*
