RoqueOS

日本語

Português (BR)
English
Español
Français
Deutsch
简体中文
Русский
العربية
हिन्दी

日本語

Português (BR)
English
Español
Français
Deutsch
简体中文
Русский
العربية
हिन्दी

Appearance

AIエージェント — RoqueClaw ​

「サーバーにPlexをインストールして」「ターミナルを開いてディスク使用量を表示して」「今日のHacker Newsを調査してNotesに要約を生成して」

RoqueClaw（OpenClawベース）は、あなたのRoqueOSの自律オペレーターです。テキストで応答するだけのチャットボットとは異なり、サーバーとデスクトップで実際のアクションを実行します: コンテナをインストールし、アプリを開き、ファイルを書き込み、通知をトリガーし、ウェブをナビゲートし、ターミナルでコマンドを実行します。

実際の違いは？「メディアサーバーが必要」と言えば、Jellyfinをインストールし、設定し、ブラウザで開いて、準備ができたら通知してくれます。5つのタブを開いてチュートリアルを読み20のステップに従う代わりに。

できること ​

🐳 自然言語でDockerコンテナをインストール ​

あなた: 「Nextcloudをインストールして、RAM 2GBで」
RoqueClaw: ✓ nextcloud:latestをインストール中...
           ✓ 2GBのRAMと永続ボリュームを構成
           ✓ コンテナがポート8080で起動
           ✓ ブラウザで開きました。初期ログイン: admin/admin

裏では、サーバーにプリインストールされている roqueos-cli を使用してRoqueOS ServerのAPIを呼び出します（下のセクションを参照）。同じApp Store、同じカタログ、同じ installApp(appId, config) — ただクリックではなく自然言語によってトリガーされるだけです。

💻 デスクトップでの操作 ​

  • 特定のアプリを開く（Finderを開いて、VS Codeを開いて、google.comでブラウザを開いて）
  • Filesにファイルを作成（この要約を /home/user/notes/reuniao.md として保存）
  • 通知を送信（バックアップが終わったら知らせて）
  • ダイアログを表示（続行する前にこのステップを承認するかユーザーに尋ねて）

🌐 ウェブをナビゲートし自動化 ​

  • 分離されたコンテナ内でChromiumを開きます（あなたのブラウザではない — セキュリティ）
  • スクレイピング、フォーム入力、ファイルダウンロード
  • 進捗を視覚的に追跡できるようにスクリーンショットを撮ります

🤖 複雑なマルチステップタスクを実行 ​

単一のプロンプト → 単一の応答ではありません。自律ループです:

  1. 目的を説明します
  2. RoqueClawがステップを計画します
  3. 各ステップを実行します（VNC経由でライブで見ます）
  4. 何か問題が発生した場合、調整して再試行します
  5. 最終的に、実行されたことと、彼が取った行動を要約します

アーキテクチャ ​

3つの層:

  • Frontend: チャット + noVNC経由のデスクトップのライブビジュアライゼーション
  • Backend: セッション、コンテナ、メッセージ/ステップのストリームを管理します。CLIからコマンドを受信し、接続されたフロントエンドでアクションをトリガーする /agent/actions/* エンドポイントを公開します。
  • RoqueClaw コンテナ: Ubuntu 22.04 + XFCE + VNC + Chromium + Node.js + OpenClaw + サーバーへのコールバック用に roqueos-cli プリインストール。

🔧 CLI roqueos-cli（エージェントの力、そしてあなたの力） ​

roqueos-cli はエージェントとRoqueOS Server間のチャネルです。2つの場所にプリインストールされています:

場所誰が使うか
RoqueClawコンテナ（/usr/local/bin/roqueos-cli）エージェント が、そのアクションを実行する際にサブプロセス経由で呼び出します
Terminalアプリ のコンテナ（サーバーの各ユーザーに1つ）あなた、シェル経由で必要なときはいつでも — エージェントなしでも

これは、エージェントを経由せずに CLIを直接使用することもできる ことを意味します。Terminalアプリを開いて、roqueos-cli ... と入力するだけです。

利用可能なコマンド ​

Terminalアプリで roqueos-cli --help を実行して完全なリファレンスを参照してください — それが信頼できる情報源です。6つの正規アクション:

roqueos-cli notify       <title> <message>        # RoqueOSデスクトップへの通知
roqueos-cli open-app     <appId>                  # アプリを開く（finder、vscode、browserなど）
roqueos-cli open-url     <url>                    # Roque BrowserでURLを開く
roqueos-cli create-file  <path>                   # stdinからコンテンツを読み込みファイルを作成
roqueos-cli run-terminal <command>                # コマンドを実行 + stdoutを返す
roqueos-cli show-dialog  <message> [--type X]     # confirm/alert/infoモーダル

実用的な例:

bash
# RoqueOSデスクトップに通知を送信
roqueos-cli notify "バックアップ完了" "Cloudflare R2に23 GBを同期"

# 特定のアプリを開く
roqueos-cli open-app finder

# ブラウザでURLを開く
roqueos-cli open-url "https://github.com/roqueribeiro"

# ファイルを作成/書き込み（stdinから読む）
echo "ミーティングノート..." | roqueos-cli create-file "/home/user/notes/reuniao.md"

# コマンドを実行 + 結果を通知として受信
roqueos-cli run-terminal "df -h"

# 確認モーダル（続行する前にユーザーの応答を待つ）
roqueos-cli show-dialog "古いログ50GBを削除しますか？" --type confirm

構文は 位置引数 を使用します（--title/--message フラグではありません）。CLIのバージョンが異なる場合は、コンテナ内で apt-get install --reinstall roqueos-cli で更新してください。

実際の使用例 ​

何かが起こったときに通知するcronスクリプト:

bash
# Crontabが毎日実行され、ディスク使用量について通知
0 9 * * * df -h | grep -E '^/' | awk '$5+0 > 80 {print $6, $5}' | \
  xargs -I {} roqueos-cli notify "ディスクほぼ満杯" "{}"

デプロイワークフロー:

bash
# 終了時にVS Codeでログを開くビルドスクリプト
yarn build && roqueos-cli open-app vscode && \
  roqueos-cli notify "ビルドOK" "/tmp/build.logのログを確認"

他のコンテナとの統合:

bash
# 別のコンテナ内のジョブ（例: Plexトランスコーディング）がユーザーに通知
roqueos-cli notify "Plex" "4Kトランスコード終了。映画準備完了。"

裏のHTTP APIは 75-agent-module.md（サーバーの内部ルール）の「Actions」セクションに文書化されています。フロントエンドがWebSocket経由で使用するのと同じアクション — notify、open-app、open-url、create-file、run-terminal、show-dialog。

サポートされるAIモデル ​

RoqueClawは主要なLLMプロバイダーで動作します:

プロバイダー推奨モデル設定
OpenAIGPT-4o、GPT-4-turboコンテナの OPENAI_API_KEY env var
AnthropicClaude 3.5 Sonnet、Claude 4.6 SonnetANTHROPIC_API_KEY env var

モデルの選択は、速度とアクションの品質に影響します。複雑なウェブ自動化には、Claude Sonnet 4.6またはGPT-4oがVNC経由の視覚的な制御に優れています。

実際の使用例 ​

シナリオタスク結果
新しいサーバーのセットアップ"Plex、qBittorrent、Sonarrをインストールし、連携するように設定して"~3分で3つのコンテナがアップ + 相互接続
調査"2026年のJavaScriptフレームワークのトップ5を調査し、Notesに比較記事を生成して"/home/user/notes/ にMDの記事 + Finderで開く
診断"サーバーが遅い理由を確認"top、df、free、docker statsを実行 — Notesにレポートを生成
自動化"昨日のGoogle Driveのバックアップをダウンロードして /data に解凍して"OAuthログイン + ダウンロード + tar経由で抽出
開発"私のAPIを監視し、ダウンしたら通知するPythonスクリプトを作成して"/home/user/projects/ にスクリプトを保存 + cron構成済み
スマートホーム"Home Assistantに接続し、点灯しているライトを表示して"ライブリスト + チャット経由でオフにするオプション

次のステップ ​

  • 設定 — RoqueClawをインストールして有効にする方法（インストーラーの --with-roqueclaw フラグ）
  • 使い方 — ステップバイステップのチュートリアル + プロンプトのベストプラクティス + CLIの完全なコマンド