OpenClaw の使い方
RoqueOSの自律型AIエージェントを最大限に活用するための実践的ガイドです。
エージェントインターフェース
AI エージェントアプリは2つの主要な領域に分かれています：
- チャットパネル (左側) — ここでメッセージを送信し、応答を確認します
- デスクトッププレビュー (右側) — エージェントがコンテナ内で行っていることのライブストリーム
ステップパネル
チャットの下にあるリアルタイムステップパネルには、エージェントが実行している各アクションが表示されます：URLへの移動、要素のクリック、コマンドの実行など。
セッションの作成
エージェントとの各会話は、セッション — 占有のLinuxデスクトップを備えた隔離されたDockerコンテナ — を作成します。始めるには：
- Launchpadで AIエージェント アプリを開きます。
- 新規セッション をクリックします。
- コンテナが初期化されます（初回は10〜30秒かかる場合があります）。
- 右側のパネルにデスクトップが表示されたら、エージェントの準備は完了です。
タスクの送信
プロンプトのベストプラクティス
タスクを記述するときは、具体的かつ客観的にしてください。コンテキストを多く提供するほど、良い結果が得られます。
❌ 曖昧:
Dockerについて調べて✅ 具体的:
Docker Compose v2 と v3 の主な違いトップ5を調べ、
ポイントをまとめたマークダウンファイルを作成し、/home/user/docker-comparison.md に保存してタスクの例
調査とドキュメント作成:
hetzner.com のウェブサイトにアクセスし、利用可能なVPSプランを見つけ、
価格と機能の比較表をCSVで作成して。フォームの自動化:
[URL] にある登録フォームに以下のデータを入力して:
名前: 山田 太郎, メール: yamada@example.com, プラン: ベーシック開発:
Hacker Newsのニュース見出しをスクレイピングし、
上位10件をJSONファイルに保存するPythonスクリプトを作成して。ウェブサイト分析:
このGitHubリポジトリ [URL] にアクセスし、READMEを読んで、
プロジェクトが何をするのか、そしてインストールの前提条件は何かを私に説明して。エージェントがRoqueOSで実行できるアクション
OpenClawは隔離されたコンテナの外で、あなたのRoqueOSと直接対話することができます：
| アクション | 説明 |
|---|---|
| 通知 | あなたのRoqueOSデスクトップにアラートを送信します |
| アプリを開く | Launchpadで特定のアプリケーションを開きます |
| URLを開く | RoqueOSブラウザでURLを開きます |
使用例: 長いタスクの終了時に、エージェントはタスクが完了したことを知らせる自動通知を送信することができます。
セッションの管理
アクティブなセッション
すべてのアクティブなセッションはアプリの上部にリストされます。以下のことができます：
- クリックして以前のセッションを再開する
- セッションを終了してサーバーリソースを解放する
同時セッションの制限
デフォルトでは、サーバーは最大3つの同時セッションを許可します（AGENT_MAX_SESSIONS を介して構成可能）。RAMを節約するために、使用しなくなったセッションは終了してください。
スクリーンショットとフルスクリーン
- スクリーンショット — カメラアイコンをクリックして、エージェントのデスクトップの現在の状態をキャプチャします
- フルスクリーン — 視覚的なタスクをよりよく確認するために、デスクトップビューをフルスクリーンに拡大します
既知の制限事項
- エージェントは隔離された環境で動作します — チャットで情報を提供しない限り、あなたのローカルファイルに直接アクセスすることはできません。
- アカウントへのログイン（メール、ソーシャルネットワーク）が必要なタスクでは、会話中に資格情報を提供する必要があります。
- デフォルトのタイムアウトは30分の非アクティブ状態です — 非常に長いタスクの場合は、定期的な対話が必要になることがあります。
トラブルシューティング
エージェントが応答しない
- サーバーがオンラインか確認します:
curl http://localhost:27021/health - APIキーが正しく構成されているか確認します。
- 現在のセッションを終了し、新しいセッションを作成します。
デスクトップがパネルに表示されない
コンテナがまだ初期化中の可能性があります。30秒待ってからアプリをリロードしてください。
応答が遅い、または不完全
AIプロバイダーからのレート制限の問題である可能性があります。少し待ってから再試行するか、タスクの複雑さを減らしてください。