OpenClaw macOS コンパニオン アプリ: メニューバー ガイド

はじめに

OpenClaw は主にチャット アプリに接続するコマンドライン ツールとして実行されますが、macOS ユーザーはメニューバーにある強力な コンパニオン アプリ にアクセスできます。このネイティブ macOS アプリケーションは、OpenClaw、デスクトップ通知、および Mac のシステムとのシームレスな統合への素早いアクセスを提供します。

コンパニオン アプリは CLI バージョンを補完し、チャット アプリの統合とネイティブ macOS の利便性という両方の長所を提供します。このガイドでは、OpenClaw macOS コンパニオン アプリのインストール、設定、使用について知っておくべきことをすべて説明します。

コンパニオン アプリとは何ですか?

OpenClaw macOS コンパニオン アプリは、次の機能を備えたネイティブ アプリケーションです。

• メニューバーに存在 — ターミナルを開かずにクイックアクセス
• デスクトップ通知を提供 — 重要なメッセージのアラートを受け取ります
• クイック クエリ インターフェイスを提供 — チャット アプリを開かずに質問できます
• macOS と統合 — システム サービスおよびショートカットと連携します
• CLI の補完 — コマンドライン バージョンと並行して動作します

これは、チャットベースの OpenClaw インスタンスのデスクトップ コンパニオンとして考えられ、ネイティブ macOS 統合と便利な機能を提供します。

インストール

方法 1: 直接ダウンロード

1. OpenClaw リリース ページ にアクセスします。
2. macOS 用の最新の .dmg ファイルをダウンロードします。
3. ダウンロードした .dmg ファイルを開きます
4. OpenClaw をアプリケーション フォルダーにドラッグします。
5. アプリケーションまたはスポットライトから起動する

方法 2: 自家製カスク

brew install --cask openclaw

方法 3: ソースからビルドする

最新の開発バージョンが必要な場合:

git clone https://github.com/openclaw/openclaw.git
cd openclaw/companion-app
npm install
npm run build
npm run dist

初回起動セットアップ

コンパニオン アプリを初めて起動するとき:

ステップ 1: OpenClaw インスタンスに接続する

アプリは、実行中の OpenClaw CLI インスタンスに接続する必要があります。

1. OpenClaw CLI を開始します - CLI インスタンスが実行されていることを確認します
2. API エンドポイントを入力 — デフォルトは http://localhost:3000 です
3. 接続を確認 — アプリは接続をテストします

ステップ 2: 環境設定を構成する

メニューバーのアイコンから設定にアクセスします。

• 一般 — 起動時の動作、通知
• 外観 — テーマ、アイコンのスタイル
• 上級 — API エンドポイント、デバッグ

ステップ 3: 権限を付与する

アプリは次のことを要求する場合があります。

• アクセシビリティ — システム統合用
• 通知 — デスクトップ アラートの場合
• フル ディスク アクセス - ファイル操作用 (必要な場合)

[システム設定] > [プライバシーとセキュリティ] でこれらを許可します。

メニューバーの機能

クイックアクセスメニュー

メニューバーのアイコンをクリックして、以下にアクセスします。

• クイッククエリ — 直接質問する
• 最近の会話 — チャット履歴を表示
• スキル — インストールされているスキルにアクセスします
• 設定 — 環境設定を構成します
• ステータス — 接続ステータスを確認します

ステータスインジケーター

メニューバーのアイコンには次のものが表示されます。

• 緑色 — 接続され準備完了
• 黄色 — 接続されていますが、警告があります
• 赤 — 切断またはエラー
• グレー — 起動中

キーボード ショートカット

グローバル ショートカットを構成します。

• Cmd+Shift+C — クイッククエリを開く
• Cmd+Shift+A — アシスタントの切り替え
• Cmd+Shift+S — ステータスを表示

クイッククエリインターフェイス

コンパニオン アプリのクイック クエリ機能を使用すると、WhatsApp、Telegram、または Discord を開かずに OpenClaw を操作できます。

クイッククエリを開く

1. メニューバーのアイコンをクリックします
2. 「クイッククエリ」を選択するか、キーボードショートカットを使用します。
3. 質問を入力します
4. Enter キーを押して送信します

使用例

簡単な情報:

• 「今日のカレンダーには何が入っていますか?」
• 「緊急メッセージがないかメールをチェックしてください」
• 「天気はどうですか？」

クイックアクション:

• 「タスクの追加: プロジェクト提案書を確認する」
• 「リマインダーを設定: 午後 3 時にサラに電話してください」
• 「GitHub PRステータスを確認する」システム クエリ:
• 「今日はどのファイルを変更しましたか?」
• 「最近の端末コマンドを表示」
• 「私のシステムのステータスは何ですか?」

デスクトップ通知

コンパニオン アプリは、次のデスクトップ通知を送信できます。

メッセージアラート

OpenClaw がメッセージを受信したときに通知を受け取ります:

• ワッツアップ
• 電報
• 不和
• その他の接続されたプラットフォーム

タスクリマインダー

デスクトップ通知をトリガーするリマインダーを設定します。

• カレンダーイベント
• タスクの期限
• カスタムリマインダー

システムイベント

次の通知:

• OpenClawのステータス変化
• スキル実行結果
• エラーアラート
• アップデート通知

通知の構成

1. 設定を開く
2. 「通知」セクションに移動します
3. 通知タイプの有効化/無効化
4. 通知音をカスタマイズする
5. サイレント時間を設定する

CLI との統合

コンパニオン アプリは CLI インスタンスと連携して動作します。

共有構成

どちらも同じものを使用します。

• APIエンドポイント
• 認証
• スキルと統合
• 記憶と文脈

補完的な機能

CLI が提供するもの:

• チャットアプリブリッジ
• 完全なコマンドライン アクセス
• サーバーの機能
• 高度な構成

コンパニオン アプリが提供するもの:

• ネイティブ macOS 統合
• デスクトップ通知
• クイックアクセスインターフェース
• システムサービス

両方を同時に実行する

両方を同時に実行できます。

1. CLI インスタンスを開始します: npm start
2. コンパニオンアプリを起動します
3. 両方とも同じバックエンドに接続します
4. 使いやすいインターフェイスを使用する

高度な機能

システムサービスの統合

コンパニオン アプリは macOS サービスと統合できます。

テキストの選択:

1. 任意のアプリでテキストを選択します
2. 右クリック → サービス → 「Ask OpenClaw」
3. 通知で AI 応答を取得する

ファイル操作:

1. Finder でファイルを選択します
2. 右クリック → サービス → 「OpenClaw で分析」
3. ファイル分析を取得する

スポットライトの統合

Spotlight 経由で OpenClaw コマンドを検索します。

• 「OpenClaw」と入力してアプリを開きます
• 「Ask OpenClaw」を検索してクエリをトリガーします
• 最近の会話に素早くアクセス

ショートカット アプリの統合

macOS でオートメーションを作成するショートカット:

1. ショートカットアプリを開く
2. 新しいショートカットを作成する
3. 「シェルスクリプトの実行」アクションを追加
4. OpenClaw API エンドポイントを呼び出す
5. Siriまたはウィジェットからのトリガー

カスタマイズ

外観

アプリの外観をカスタマイズします。

• アイコン スタイル — 利用可能なアイコンから選択します
• テーマ — ライト、ダーク、または自動
• メニュー スタイル — コンパクトまたは拡張

行動

アプリの動作を構成します。

• ログイン時に起動 — 自動的に起動します
• 非アクティブな場合は非表示 — メニューバー アイコンを最小化します
• 終了動作 — 実行を続けるか、アプリを終了します

詳細設定

パワーユーザーのオプション:

• カスタム API エンドポイント — リモート インスタンスを指す
• デバッグ モード — 詳細ログを有効にする
• プロキシ設定 — ネットワーク プロキシを構成します
• アップデート チャネル — ベータ版または安定版リリース

トラブルシューティング

アプリが接続できない

問題: コンパニオン アプリが CLI に接続できない

解決策:

1. CLI が実行されていることを確認します: ps aux | grep openclaw
2. API エンドポイントが CLI ポートと一致することを確認します
3. ファイアウォールがローカルホストをブロックしていないことを確認する
4. CLI ログでエラーを確認します。

通知が機能しない

問題: デスクトップ通知が表示されない

解決策:

1. macOS の通知設定を確認する
2. アプリに通知権限があることを確認します
3. 応答不可ステータスを確認する
4. アプリを再起動します

メニューバーのアイコンがありません

問題: メニューバーにアイコンが表示されない

解決策:

1. アイコンが非表示になっているかどうかを確認します (macOS ではアイコンが非表示になる場合があります)
2. メニューバーをリセット: killall SystemUIServer
3. アプリを再インストールする
4. macOS の互換性を確認する

パフォーマンスの問題

問題: アプリが遅い、または応答しない解決策:

1. システムリソースを確認する
2. 通知頻度を減らす
3. アプリのキャッシュをクリアする
4. アプリを再起動します

ベストプラクティス

毎日のワークフロー

1. CLI の開始 — 起動時に OpenClaw CLI を実行します
2. コンパニオンの起動 — コンパニオン アプリを実行したままにします
3. クイック クエリを使用 — 簡単な質問用
4. チャット アプリを使用する — より長い会話の場合
5. 通知の監視 — 常に最新情報を入手

リソース管理

• メモリ使用量を監視する
• 不要な場合はコンパニオン アプリを閉じます
• サーバーには CLI 専用モードを使用します
• 通知設定の最適化

セキュリティ

• アプリを常に最新の状態に保つ
• 安全な API エンドポイントを使用する
• APIを公開しないでください
• 通知権限を確認する

比較: コンパニオン アプリと CLI

コンパニオン アプリを使用する場合

• クイックデスクトップクエリ
• デスクトップ通知
• macOS システム統合
• 視覚的なステータス監視

CLI のみを使用する場合

• サーバーの展開
• ヘッドレスセットアップ
• 高度な構成
• リソースに制約のあるシステム

両方を使用する

両方の長所:

• コア機能用の CLI
• 便利なコンパニオンアプリ
• 共有バックエンドと構成
• 柔軟なアクセス方法

将来の機能強化

コンパニオン アプリは次のような機能を追加して進化し続けています。

• macOS のウィジェットのサポート
• Siriの統合
• より多くのシステムサービス
• 強化された通知
• パフォーマンスの向上

結論

OpenClaw macOS コンパニオン アプリは、CLI バージョンを完全に補完するネイティブ デスクトップ統合を提供します。クイッククエリ、デスクトップ通知、またはシステム統合が必要な場合でも、コンパニオン アプリは macOS での OpenClaw エクスペリエンスを強化します。

最高のエクスペリエンスを得るには、CLI インスタンスと一緒にインストールしてください。簡単な質問にはクイック クエリを使用し、重要なアラートについては通知を利用し、シームレスな macOS 統合をお楽しみください。

詳細については、インストール ガイド および macOS 固有のセットアップ を参照してください。ご質問がある場合は、FAQ にアクセスするか、他の チュートリアル をご覧ください。