OpenClawの使い方
RoqueOSの自律型AIエージェントを最大限に活用するための実践ガイド。
エージェントのインターフェース
AIエージェントアプリは、主に2つのエリアに分かれています:
- チャットパネル（左）— メッセージを送信し、応答を確認する場所
- デスクトップビジュアライゼーション（右）— エージェントがコンテナ内で行っていることのライブストリーム
Stepsパネル
チャットの下、リアルタイムSteps パネルが、エージェントが実行している各アクションを表示します: URLへの移動、要素のクリック、コマンドの実行など。
セッションの作成
エージェントとの各会話は セッション を作成します — 専用のLinuxデスクトップを持つ分離されたDockerコンテナです。開始するには:
- Launchpadで AIエージェント アプリを開きます。
- 新しいセッション をクリックします。
- コンテナが初期化されます（初回は10〜30秒かかる場合があります）。
- 右パネルにデスクトップが表示されたら、エージェントは準備完了です。
タスクの送信
プロンプトのベストプラクティス
タスクを説明する際は 具体的かつ客観的 であってください。提供するコンテキストが多いほど、結果が良くなります。
❌ 曖昧:
Dockerについて調べて✅ 具体的:
Docker Compose v2とv3の主な5つの違いを調べて、
要点をまとめたマークダウンファイルを作成し、/home/user/docker-comparison.mdに保存してタスクの例
調査とドキュメント作成:
hetzner.comのサイトにアクセスし、利用可能なVPSプランを見つけて、
CSVで価格とリソースの比較表を作成して。フォームの自動化:
[URL]の登録フォームを以下のデータで記入して:
名前: João Silva、メール: joao@exemplo.com、プラン: ベーシック開発:
Hacker Newsのニュースタイトルをスクレイピングして、
最初の10件をJSONファイルに保存するPythonスクリプトを作成して。サイト分析:
このGitHubリポジトリ[URL]にアクセスして、READMEを読んで、
プロジェクトが何をするか、インストールの前提条件は何か教えて。エージェントがあなたのRoqueOSで実行するアクション
RoqueClawは分離されたコンテナに閉じ込められたままではありません — エージェントのコンテナと、サーバーの各ユーザーのTerminalアプリのコンテナの両方にプリインストールされている roqueos-cli CLIを介して、あなたのRoqueOSデスクトップで直接動作します。
6つの正規アクション
| CLIコマンド | 何をするか | トリガーするプロンプトの例 |
|---|---|---|
roqueos-cli notify "title" "msg" | デスクトップへの通知 | "終わったら知らせて" |
roqueos-cli open-app <id> | Launchpadでアプリを開く | "VS Codeを開いて" |
roqueos-cli open-url <url> | Roque BrowserでURLを開く | "プロジェクトのGitHubを開いて" |
roqueos-cli create-file <path> | ファイルを書き込む（stdinを読む） | "この要約をNotesに保存して" |
roqueos-cli run-terminal <cmd> | コマンドを実行 + 出力を返す | "空きディスク容量を表示して" |
roqueos-cli show-dialog "msg" | 確認モーダル（一時停止、待機） | "削除する前に確認して" |
CLIを直接使うこともできます（エージェントなしで）
CLIは各ユーザーの Terminalアプリ（分離されたUbuntuコンテナ）で利用可能です。LaunchpadでTerminalを開き、roqueos-cli --help と入力して直接使用します。
一般的な用途:
# バックアップスクリプトからの素早い通知
./backup.sh && roqueos-cli notify "バックアップOK" "23 GB同期済み"
# ビルドが終了したらシェルから直接VS Codeを開く
yarn build && roqueos-cli open-app vscode
# ディスクが80%を超えたら警告するcron
0 9 * * * df -h | awk '$5+0 > 80 {system("roqueos-cli notify \"ディスクがいっぱい\" \"" $6 " " $5 "\"")}'
# Pythonスクリプトがユーザーのファイルに直接書き込む
echo "$(date): meeting notes" | roqueos-cli create-file "/home/user/notes/reuniao-$(date +%F).md"
# Plexコンテナがトランスコード完了時に通知
# （roqueos-serverのネットワークを共有している場合、Plexコンテナ内）
roqueos-cli notify "Plex" "映画X の4Kトランスコードが完了"自然言語でコンテナをインストール（隠れた力）
エージェントの最も使われるアクション: roqueos-cli → サーバーAPI → appsService.installApp 経由でカタログから直接Dockerアプリをインストールします。
あなたが言う: 「Nextcloudをインストールして、RAM 2GB、準備できたら開いて」
エージェントが行う（VNCでライブで見ることができます）:
- カタログで
nextcloudを識別 roqueos-cli→ POST/apps/installをappId: nextcloud, memory: 2048で呼び出し- コンテナの起動 + ヘルスチェックを待つ
roqueos-cli open-url http://localhost:<割り当てられたポート>を呼び出し- "Nextcloud準備完了、初期ログイン admin/admin" を通知
ビジュアルApp Storeと同じAPI — ただし、ナビゲート/クリックする必要はありません。次のような用途に役立ちます:
- 大規模セットアップ: "Plex、Sonarr、Radarr、Bazarr、qBittorrentをインストールして。すべてが
/mediaストレージを使用するように設定して。" - スタック全体: "MariaDBとphpMyAdminを含むLAMPスタックを起動して"
- リカバリ: "クラッシュ前のすべてのアプリを再インストールして"
セッションの管理
アクティブなセッション
すべてのアクティブなセッションはアプリの上部にリストされます。次のことができます:
- 前のセッションをクリックして 再開
- サーバーのリソースを解放するためにセッションを 終了
同時セッションの制限
デフォルトでは、サーバーは最大3つの同時セッションを許可します（AGENT_MAX_SESSIONS で設定可能）。RAMを節約するために、使用していないセッションを終了してください。
スクリーンショットとフルスクリーン
- スクリーンショット — カメラアイコンをクリックして、エージェントのデスクトップの現在の状態をキャプチャ
- フルスクリーン — ビジュアルタスクをよりよく追跡するために、デスクトップビジュアライゼーションをフルスクリーンに展開
既知の制限
- エージェントは 分離された環境 で動作します — チャットで情報を提供しない限り、ローカルファイルに直接アクセスすることはできません
- アカウントへのログイン が必要なタスク（メール、ソーシャルネットワーク）では、会話中に資格情報を提供する必要があります
- デフォルトタイムアウト は非アクティブ30分です — 非常に長いタスクは定期的な対話が必要な場合があります
トラブルシューティング
エージェントが応答しない
- サーバーがオンラインであることを確認:
curl http://localhost:27021/health - APIキーが正しく設定されていることを確認
- 現在のセッションを終了し、新しいセッションを作成
パネルにデスクトップが表示されない
コンテナがまだ初期化中の可能性があります。30秒待ってアプリを再ロードしてください。
応答が遅いまたは不完全
AIプロバイダのレート制限の問題の可能性があります。少し待ってから再試行するか、タスクの複雑さを減らしてください。