46 KiB
ClawX
OpenClaw AIエージェントのためのデスクトップインターフェース
機能 • なぜClawXなのか • はじめに • アーキテクチャ • 開発 • コントリビューション
English | 简体中文 | 日本語 | Русский
概要
ClawXは、強力なAIエージェントと日常のユーザーとの間のギャップを埋めます。OpenClawをベースに構築されており、コマンドラインによるAIオーケストレーションを、アクセスしやすく美しいデスクトップ体験に変換します。ターミナルは不要です。
ワークフローの自動化、AI搭載チャネルの管理、インテリジェントなタスクのスケジューリングなど、ClawXはAIエージェントを効果的に活用するために必要なインターフェースを提供します。
ClawXはベストプラクティスのモデルプロバイダーが事前設定されており、Windowsおよび多言語設定をネイティブにサポートしています。もちろん、設定 → 詳細設定 → 開発者モードから高度な設定を微調整することもできます。
完全なエンタープライズ版、専用のサービスサポート、または御社のビジネスシナリオに合わせた導入支援が必要な場合は、public@valuecell.ai までお問い合わせください。
スクリーンショット
なぜClawXなのか
AIエージェントの構築にコマンドラインの習得は不要であるべきです。ClawXはシンプルな哲学のもとに設計されました：強力な技術には、あなたの時間を尊重するインターフェースがふさわしい。
| 課題 | ClawXのソリューション |
|---|---|
| 複雑なCLIセットアップ | ワンクリックインストールとガイド付きセットアップウィザード |
| 設定ファイル | リアルタイムバリデーション付きのビジュアル設定 |
| プロセス管理 | ゲートウェイライフサイクルの自動管理 |
| アプリ更新 | 起動時に更新を確認し、ダウンロードやインストール前に通知 |
| 複数のAIプロバイダー | 統合プロバイダー設定パネル |
| スキル/プラグインのインストール | 組み込みのスキルマーケットプレイスと管理機能 |
OpenClaw内蔵
ClawXは公式のOpenClawコアを直接ベースに構築されています。別途インストールを必要とせず、アプリケーション内にランタイムを組み込むことで、シームレスな「バッテリー同梱」体験を提供します。
私たちはアップストリームのOpenClawプロジェクトとの厳密な整合性を維持することにコミットしており、公式リリースが提供する最新の機能、安定性の改善、エコシステムの互換性に常にアクセスできることを保証します。
開発者モードを有効にすると、サイドバーにはネイティブの Dreams ページも表示され、ClawX 内で OpenClaw の記憶レビュー、夢日記、基本メンテナンス操作を扱えます。詳細な診断が必要な場合は、そのページから完全版の OpenClaw Dreams UI も開けます。
機能
🎯 ゼロ設定バリア
インストールから最初のAIインタラクションまで、すべてのセットアップを直感的なグラフィカルインターフェースで完了できます。ターミナルコマンド不要、YAMLファイル不要、環境変数の探索も不要です。
💬 インテリジェントチャットインターフェース
モダンなチャット体験を通じてAIエージェントとコミュニケーションできます。複数の会話コンテキスト、メッセージ履歴、Markdownによるリッチコンテンツレンダリング（GitHub 風テーブルや KaTeX による LaTeX 数式 $インライン$、$$ブロック$$、\(インライン\)、\[ブロック\] を含む）に加え、マルチエージェント構成ではメイン入力欄の @agent から対象エージェントへ直接ルーティングできます。
コンポーザーから挿入した Skill は /skill-name 形式のチップとして表示され、チップをクリックすると右側のプレビュー側欄でその Skill の SKILL.md を開けます。
@agent で別のエージェントを選ぶと、ClawX はデフォルトエージェントを経由せず、そのエージェント自身の会話コンテキストへ直接切り替えます。各エージェントのワークスペースは既定で分離されていますが、より強い実行時分離は OpenClaw の sandbox 設定に依存します。
セッション側欄はワークスペース優先で整理され、既定ワークスペースを先頭に固定し、その他のワークスペースは自然順に並べます。各ワークスペースは折りたたみや追加読み込みができます。AI の返信中は行にスピナーが表示され、未確認の返信が完了すると青い点に変わり、会話を開くと相対アクティビティ時刻に戻ります。ホバーすると引き続き操作ボタンが表示されます。インポートしたワークスペースは側欄の見出しから名前を変更でき、新しい名前はチャット入力欄の下にも反映されます。見出しにホバーすると引き続きファイルシステムのパスを確認できます。選択中の会話に有効なワークスペースがある場合、新しいチャットはそれを引き継ぎ、最初の送信までは変更できます。編集可能な新規または未バインドのチャットでは、コンポーザーのワークスペースチップから最近使用したワークスペースと既存セッションのワークスペースの一覧を開き、既定ワークスペースへ戻すか別フォルダーを選べます。保存済みのワークスペースフォルダーが移動または削除されている場合、Chat はセッション作成を一時停止し、無効なパスを繰り返し再試行せずに既存のフォルダーを選ぶよう案内します。利用できない既定以外のグループには側欄で印が付き、確認後に削除できます。この操作ではグループ内の全セッションが完全に削除されます。OpenClaw が生成する UUID と日付のフォールバックタイトルは、そのセッション ID と一致する場合に限って欠落タイトルとして扱い、セッション名として保存せず、会話の最初のユーザーメッセージに置き換えて表示します。
各 Agent は provider/model の実行時設定を個別に上書きできます。上書きしていない Agent は引き続きグローバルの既定モデルを継承します。
Chat の右パネルにあるワークスペースとプレビューの各タブでは、.docx と .pptx ファイルを読み取り専用でプレビューできます。従来形式の .doc と .ppt はアプリ内ではプレビューせず、引き続き OS 経由で開きます。DOCX のページ区切りは Microsoft Word と異なる場合があり、PPTX プレビューではアニメーション、画面切り替え、メディア再生をサポートしません。20 MB を超える Office ファイルはアプリ内でプレビューされません。
シングルページ Web ブラウザ
Chat の右パネルには、ワークスペース、プレビュー、変更、ウェブブラウザの 4 タブがあります。ウェブブラウザは初回利用時に 1 つのライブページを遅延作成し、パネルを閉じる、別のパネルタブを選ぶ、チャットセッションを切り替える、または ClawX の別ルートへ移動しても、ページを非表示にするだけで実行を継続します。そのため、非表示中もスクリプト、ネットワーク通信、音声、リソース消費が続く場合があります。専用の永続セッションはアプリ再起動後も Cookie とサイトストレージを保持しますが、起動ごとに about:blank から始まり、以前の URL、ページ状態、ナビゲーション履歴は復元しません。ページが favicon を提供する場合はタイトルの左側に表示され、favicon がない間は同じサイズのプレースホルダーでタイトル位置を維持します。アドレス編集中はアイコン領域全体が非表示になります。追加のブラウザタブやウィンドウ、ブックマーク、履歴の永続化、パスワードマネージャー、自動入力管理はありません。
トップレベルナビゲーションでは HTTP、HTTPS、および明示的に入力した標準 file:/// URL を利用できます。通常のファイルシステムパスとその他のプロトコルは拒否されます。ローカルファイルを開くと、通常の Chromium セキュリティ規則の範囲で、読み取り可能な内容が埋め込みページに公開されます。また、file: URL に システムブラウザで開くを使うと、ブラウザではなく OS の関連付け済みアプリが起動する場合があります。許可されたポップアップ先は子ウィンドウを作らず現在のページを置き換えます。この同一ページへのフォールバックでは、window.opener、返されたウィンドウハンドル、空白ページを後から書き換えるスクリプト型ポップアップ、POST 本文や referrer、名前付きウィンドウ、ウィンドウ機能の完全な動作を維持できません。
ダウンロードには Electron と OS の既定動作がそのまま使われます。プラットフォームによってはネイティブの保存ダイアログが表示され、ユーザー操作が必要です。ClawX はカスタム保存先を指定せず、ダウンロードの進捗、履歴、管理 UI も提供しません。カメラとマイクはリクエストごとにネイティブの許可／拒否ダイアログを表示し、選択を記憶しません。クリップボードアクセスは許可され、位置情報、画面キャプチャ、通知、その他の権限は拒否されます。
Cookie を消去はブラウザセッション内の全オリジンの Cookie のみを削除し、キャッシュとサイトストレージを保持します。サイトデータを消去は全オリジンの HTTP/Chromium キャッシュ、Cache Storage、Local Storage、IndexedDB、Service Worker を削除し、Cookie とダウンロード済みファイルを保持します。ブラウザ通信は Electron/Chromium のシステムプロキシ解決に従います。ClawX クライアントのプロキシ設定はこのブラウザセッションへ同期されず、設定を変更しても再構成されません。
📡 マルチチャネル管理
複数のAIチャネルを同時に設定・監視できます。各チャネルは独立して動作するため、異なるタスクに特化したエージェントを実行できます。
現在は各チャンネルで複数アカウントを扱え、Channels ページでアカウントの Agent 紐付けやデフォルトアカウント切替を直接管理できます。
カスタムのチャンネルアカウント ID には、ルーティング不一致を防ぐため OpenClaw 互換の正規形式（[a-z0-9_-]、英小文字、最大 64 文字、先頭は英小文字または数字）を必須にしています。
ClawX には Tencent 公式の個人 WeChat チャンネルプラグインも同梱されており、Channels ページからアプリ内 QR フローで直接 WeChat を連携できます。
⏰ Cronベースの自動化
AIタスクを自動的に実行するようスケジュール設定できます。トリガーを定義し、間隔を設定することで、手動介入なしにAIエージェントを24時間稼働させることができます。
定期タスク画面では外部配信を「送信アカウント」と「受信先ターゲット」の 2 段階セレクターで設定できるようになりました。対応チャネルでは、受信先候補をチャネルのディレクトリ機能や既知セッション履歴から自動検出するため、jobs.json を手で編集する必要はありません。タスクのメッセージ入力欄でも、メインのチャット入力と同じインライン /skill トークン記法でスキルを挿入できるようになりました（選択中のエージェントに応じて読み込み）。スケジュールされたプロンプトから直接スキルを起動できます。スケジュール選択は繰り返しと1回のみのタブに分かれました。繰り返しは毎時・毎日・平日・毎週・カスタム（生の cron）の頻度を時刻／曜日コントロール付きで選べ、1回のみは選択した日付（曜日を表示）と時刻に一度だけ実行します。1回のみのタスクは未来の時刻を指定する必要があり、実行後はランタイムにより自動的に削除されます。
🧩 拡張可能なスキルシステム
事前構築されたスキルでAIエージェントを拡張できます。統合 Skills ページはローカル優先で、管理ディレクトリや workspace のスキルをスキャンし、Gateway に依存せず有効/無効を切り替えられます。エンタープライズ拡張がある場合は、その拡張が提供する marketplace も表示できます。
ClawX はドキュメント処理スキル（pdf、xlsx、docx、pptx）もフル内容で同梱し、起動時に管理スキルディレクトリ（既定 ~/.openclaw/skills）へ自動配備し、初回インストール時に既定で有効化します。
Skills ページでは OpenClaw の複数ソース（管理ディレクトリ、workspace、追加スキルディレクトリ）から検出されたスキルを表示でき、各スキルの実際のパスを確認して実フォルダを直接開けます。OpenClaw 同梱の bundled skill については、コミュニティ版ではパッケージにも表示にも skill-creator のみを残し、dev 起動時と packaged 起動時の両方で他の bundled skill を物理的に削除します。さらに、削除済み bundled skill の古い openclaw.json エントリも一緒に掃除します。
🔐 セキュアなプロバイダー統合
複数のAIプロバイダー（OpenAI、Anthropic、Z.AI / GLMなど）に接続でき、資格情報はシステムのネイティブキーチェーンに安全に保存されます。OpenAI は API キーとブラウザ OAuth（Codex サブスクリプション）の両方に対応しています。
開発者モードでは、専用の Image Generation ページで、独立した OpenAI 互換の画像生成エンドポイント（Base URL、API キー、gpt-image-2 などのモデル名）を設定でき、画像生成だけ専用の /v1/images/generations サービスを使い、チャットは通常の OpenAI Provider のまま継続できます。
OpenAI-compatible ゲートウェイを Custom プロバイダー で使う場合、設定 → AI Providers → Provider 編集 でカスタム User-Agent を設定でき、互換性が必要なエンドポイントで有効です。
プロバイダーの編集や切り替え時、ClawX は input: ["text", "image"] など既存のモデル単位の能力メタデータを保持します。新しく選択した Custom プロバイダーのモデルには OpenClaw onboarding と同等の画像入力推論を適用し、不明なモデルはテキスト専用として扱います。
Custom プロバイダーのモデル行には明示的な contextWindow も書き込まれ（モデルファミリーから推定、例：gpt-5.x → 272k）、旧バージョンで保存された行は起動時に自動補完されます。これにより OpenClaw は長いセッションを "Context overflow" エラーになる前に圧縮できます。compaction 未設定の場合は agents.defaults.compaction.mode = "safeguard" と reserveTokensFloor = 50000 が既定値として設定されますが、ユーザーが自分で設定したモデル行や圧縮設定が変更されることはありません（reserveTokensFloor が未設定の場合のみ補完されることがあります）。
Z.AI（CN / Global）は OpenClaw 組み込みの zai プロバイダー（ZAI_API_KEY）に対応し、既定モデルは glm-5.2 です。Code Plan プリセットで Coding Plan エンドポイント（…/api/coding/paas/v4）へ切り替え、通常 API（…/api/paas/v4）も利用できます。CN と Global は同じ OpenClaw ランタイムキーを共有するため同時追加できません。
互換ゲートウェイで /models が認証以外の理由で使えない場合、ClawX は API キー検証時に軽量な /chat/completions または /responses プローブへ自動フォールバックします。
🌙 アダプティブテーマ
ライトモード、ダークモード、またはシステム同期テーマ。ClawXはあなたの好みに自動的に適応します。
🚀 自動起動設定
設定 → 通用 から システム起動時に自動起動 を有効化すると、ログイン後に ClawX が自動的に起動します。
🔔 更新通知
ClawX は起動時に新しいバージョンを自動確認できます。更新が見つかるとアプリ内通知を表示し、ダウンロードやインストールはユーザーが選択した後にのみ実行されます。
はじめに
システム要件
- オペレーティングシステム: macOS 11以上、Windows 10以上、またはLinux（Ubuntu 20.04以上）
- メモリ: 最低4GB RAM（8GB推奨）
- ストレージ: 1GBの空きディスク容量
インストール
ビルド済みリリース（推奨）
Releasesページから、お使いのプラットフォーム向けの最新リリースをダウンロードしてください。
ソースからビルド
# リポジトリをクローン
git clone https://github.com/ValueCell-ai/ClawX.git
cd ClawX
# プロジェクトの初期化
pnpm run init
# 開発モードで起動
pnpm dev
初回起動
ClawXを初めて起動すると、セットアップウィザードが以下の手順をガイドします：
- 言語と地域 – 使用する言語・地域の設定
- AIプロバイダー – APIキーまたは OAuth（ブラウザ/デバイスログイン対応プロバイダー）で追加
- スキルバンドル – 一般的なユースケース向けの事前設定スキルを選択
- 検証 – メインインターフェースに入る前に設定をテスト
サポート対象のシステム言語がある場合、ウィザードはその言語を初期選択し、未対応の場合は英語にフォールバックします。
プロキシ設定
ClawXには、Electron、OpenClaw Gateway、またはTelegramなどのチャネルがローカルプロキシクライアントを介してインターネットにアクセスする必要がある環境向けに、組み込みのプロキシ設定が含まれています。
設定 → ゲートウェイ → プロキシを開いて以下を設定します：
- プロキシサーバー: すべてのリクエストのデフォルトプロキシ
- バイパスルール: 直接接続すべきホスト（セミコロン、カンマ、または改行で区切る）
- 開発者モードでは、オプションで以下をオーバーライドできます：
- HTTP プロキシ
- HTTPS プロキシ
- ALL_PROXY / SOCKS
推奨されるローカル設定例：
プロキシサーバー: http://127.0.0.1:7890
注意事項：
host:portのみの値はHTTPとして扱われます。- 高度なプロキシフィールドが空の場合、ClawXは
プロキシサーバーにフォールバックします。 - プロキシ設定を保存すると、Electronのネットワーク設定が即座に再適用され、ゲートウェイが自動的に再起動されます。
- ClawXはTelegramが有効な場合、プロキシをOpenClawのTelegramチャネル設定にも同期します。
- ClawXのプロキシが無効な状態では、Gatewayの通常再起動時に既存のTelegramチャネルプロキシ設定を保持します。
- OpenClaw設定のTelegramプロキシを明示的に消したい場合は、プロキシ無効の状態で一度「保存」を実行してください。
- 設定 → 詳細 → 開発者 では OpenClaw Doctor を実行でき、
openclaw doctor --jsonの診断出力をアプリ内で確認できます。 - Windows のパッケージ版では、同梱された
openclawCLI/TUI は端末入力を安定させるため、同梱のnode.exeエントリーポイント経由で実行されます。
アーキテクチャ
ClawXは、デュアルプロセス + Host API 統一アクセス構成を採用しています。Renderer は単一クライアント抽象を呼び出し、プロトコル選択とライフサイクルは Main が管理します：
Chat は Electron Main が所有する ACP stdio bridge を使用します。Renderer は型付き host event を受け取り、メモリ上の ACP timeline を描画します。Gateway は providers、models、skills、workspace、settings、diagnostics、media configuration などの非 Chat 機能を引き続き担当します。
別の会話やページを開いても、未完了の ACP 応答はストリーミングを継続します。完了前に戻ると最新のメモリ内 timeline が復元され、ライブ応答の表示が続きます。完了後は通常の ACP 履歴リプレイが引き続き唯一の正となります。
ACP の assistant ターンにはターン全体の所要時間が表示されます。ライブ計時はクライアントが観測した prompt ライフサイクルに従い、アプリ内を移動しても継続します。履歴の所要時間は Electron Main が範囲を限定した OpenClaw transcript のタイムスタンプから算出し、ACP リプレイですでに復元されたターンだけに付与します。
ACP Chat は標準 ACP resource を添付ファイルとして表示します。ユーザーが選択した画像は、ホバー時のオーバーレイにファイル名を表示するサムネイルとして描画され、その他の利用可能な添付カードはファイル名に続いて、淡色で省略可能なソースパスを表示します。現在の OpenClaw ACP adapter が assistant のメディアを省略した場合も、明示的な assistant の MEDIA: ディレクティブを、元のディレクティブを表示せずに添付カードとして復元できます。現在の workspace 外を含む既存のローカルファイル参照は、プレビューまたはオープンのたびに Electron Main で正確な session と generation に対して再検証されます。AI が生成したプレビュー可能なローカル添付ファイル（20 MB 以下の .docx と .pptx を含む）は、読み取り専用のアプリ内プレビューを主要操作として維持し、対応アプリで開く操作と Finder、エクスプローラー、またはシステムのファイルマネージャーで表示する操作を副次メニューから利用できます。ローカル HTML 添付ファイルでは、そのメニューの先頭項目がファイル URL を右側のウェブブラウザで開きます。ここでも Office プレビューには同じ制限があります。.doc と .ppt はシステムアプリで開く形式のままで、DOCX のページ区切りは Microsoft Word と異なる場合があり、PPTX のアニメーション、画面切り替え、メディア再生はサポートされません。対応アプリの検出は macOS と Windows のみで利用でき、Linux または検出失敗時には通知せず、ファイルの場所を表示する操作だけに切り替わります。それ以外のローカルファイル（20 MB を超える Office ファイルを含む）はユーザーのクリック後にシステムアプリで開かれます。リモートの HTTP/HTTPS 添付ファイルはクリック後に外部で開かれます。通常の文章内にある単独またはインラインのパスは添付ファイルとして扱われません。
ACP Chat は、runtime が画像生成メディアを信頼できる構造化メディアとして配信した場合に、生成画像のプレビューも表示できます。信頼できる OpenClaw internal-UI 配信と画像生成タスクに関連付けられた最終返信では、テキストのみの失敗説明を含む元のユーザー向け完了テキストを保持し、汎用の画像キャプションへ置き換えません。OpenClaw の履歴リプレイ中は、同じセッションで画像生成タスク開始が記録されている場合に限り、assistant の画像 MEDIA: マーカーがインライン画像表示へ昇格されます。ClawX は Renderer から任意にファイルシステムへアクセスするのではなく、Electron Main のホストメディア処理を通じてプレビューを読み込みます。標準 ACP の画像と resource コンテンツは引き続き推奨パスであり、そのまま描画されます。
ACP ファイルアクティビティのセマンティクス
- ファイルアクティビティは、成功して完了した OpenClaw の
write、edit、apply_patch呼び出しから投影されます。ツールの認識方法は公式 OpenClaw Chat UI に準拠し、完了した呼び出しだけに絞る処理は ClawX 固有です。 - 作成・変更されたアクティビティ行は、プレビュー可能な assistant 添付ファイルと同じファイルカードとアプリで開くメニューを使い、状態表示と利用可能な
+/-集計も保持します。HTML ファイルでは、メニューの先頭項目がローカルファイル URL を右側のウェブブラウザで開き、そのタブを有効にします。削除された行には Changes 操作だけを残します。アプリ一覧、選択アプリで開く操作、ファイル位置の表示は、workspace ルートと相対パスから Electron Main が毎回個別に再検証します。ツール由来のパスが添付ファイルに変換されたり、Renderer に正規化済みのネイティブパスが渡されたりすることはありません。 writeはツールが宣言したとおり、作成および全行追加の差分として表示されます。対象パスがすでに存在する可能性がある場合も同様です。- Changes は、ツールが宣言したアクティビティを時系列に並べたセッション単位の記録です。Git の出力でも、検証済みソースベースラインに対する差分でもありません。
- 各ファイルについて、Changes はアシスタントの各ターンに最大 1 つの diff エディターを表示します。安全に連結できるフラグメントは合成し、独立したフラグメントは 1 つのエディターに連結しますが、完全なファイルベースラインとの差分であるとはみなしません。
- シェルコマンド、スクリプト、ユーザー、IDE による副作用は検出されません。
- 完全な ACP リプレイからは記録済みのファイルアクティビティを復元できます。リプレイが不完全な場合、ClawX はフォールバック推論で欠落したアクティビティを補いません。
┌────────────────────────────────────────────────────────────────────┐
│ ClawX デスクトップアプリ │
│ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ Electron メインプロセス │ │
│ │ • ウィンドウ＆アプリケーションライフサイクル管理 │ │
│ │ • ゲートウェイプロセスの監視 │ │
│ │ • システム統合（トレイ、通知、キーチェーン） │ │
│ │ • 自動アップデートオーケストレーション │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │ │
│ │ IPC（権威ある制御プレーン） │
│ ▼ │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ React レンダラープロセス │ │
│ │ • モダンなコンポーネントベースUI（React 19） │ │
│ │ • Zustandによるステート管理 │ │
│ │ • 統一 host-api/api-client 呼び出し │ │
│ │ • リッチなMarkdownレンダリング │ │
│ └──────────────────────────────────────────────────────────────┘ │
└──────────────────────────────┬─────────────────────────────────────┘
│
│ 型付き IPC リクエスト
▼
┌─────────────────────────────────────────────────────────────────┐
│ Main Host Services と Gateway Manager │
│ │
│ • host:invoke 型付きサービスディスパッチ │
│ • 設定、ファイル、セッション、スキル、プロバイダー、診断サービス │
│ • Main が Gateway WebSocket とプロセス監視を所有 │
└──────────────────────────────┬──────────────────────────────────┘
│
│ Main 所有 WebSocket
▼
┌─────────────────────────────────────────────────────────────────┐
│ OpenClaw ゲートウェイ │
│ │
│ • AIエージェントランタイムとオーケストレーション │
│ • メッセージチャネル管理 │
│ • スキル/プラグイン実行環境 │
│ • プロバイダー抽象化レイヤー │
└─────────────────────────────────────────────────────────────────┘
設計原則
- プロセス分離: AIランタイムは別プロセスで動作し、重い計算処理中でもUIの応答性を確保します
- フロントエンド呼び出しの単一入口: Renderer は host-api/api-client を通じて呼び出し、下位プロトコルに依存しません
- Mainによるトランスポート制御: ACP Chat stdio bridge と Gateway トランスポートは Electron Main が所有し、Renderer は型付き IPC で Main と通信します
- 拡張 IPC コントリビューション: Main プロセス拡張は HTTP route ではなく、型付き IPC レジストリを通じて host-api action を提供します
- グレースフルリカバリ: 再接続・タイムアウト・バックオフで一時的障害を自動処理します
- セキュアストレージ: APIキーや機密データは、OSのネイティブセキュアストレージ機構を活用します
- CORSセーフ設計: Renderer はローカル Gateway や Host API HTTP エンドポイントを直接呼び出しません
プロセスモデルと Gateway トラブルシューティング
- ClawX は Electron アプリのため、1つのアプリインスタンスでも複数プロセス（main/renderer/zygote/utility）が表示されるのが正常です。
- 単一起動保護は Electron のロックに加え、ローカルのプロセスロックファイルも併用し、デスクトップ IPC / セッションバスが不安定な環境でも重複起動を防ぎます。
- ローリングアップグレード中に旧版/新版が混在すると、単一起動保護の挙動が非対称になる場合があります。安定運用のため、デスクトップクライアントは可能な限り同一バージョンへ揃えてください。
- ただし OpenClaw Gateway の待受は常に単一であるべきです。
127.0.0.1:18789を Listen しているプロセスは1つだけです。 - Gateway の readiness は
system-presence、health、statusなどの OpenClaw コア信号を基準にし、memory、Dreams、チャネルの失敗はグローバルな Gateway 障害ではなく capability degradation として表示します。 - Listen プロセスの確認例:
- macOS/Linux:
lsof -nP -iTCP:18789 -sTCP:LISTEN - Windows (PowerShell):
Get-NetTCPConnection -LocalPort 18789 -State Listen
- macOS/Linux:
- ウィンドウの閉じるボタン（
X）は既定でトレイへ最小化する動作で、完全終了ではありません。完全終了する場合はトレイメニューの Quit ClawX を使用してください。
ユースケース
🤖 パーソナルAIアシスタント
質問への回答、メールの下書き、ドキュメントの要約、日常タスクのサポートなど、汎用的なAIエージェントを設定できます。すべてクリーンなデスクトップインターフェースから操作できます。
📊 自動モニタリング
ニュースフィード、価格追跡、特定イベントの監視などを行うスケジュールエージェントを設定できます。結果はお好みの通知チャネルに配信されます。
💻 開発者の生産性向上
AI を開発ワークフローに統合できます。エージェントを使用して、コードレビュー、ドキュメント生成、反復的なコーディングタスクの自動化が可能です。
🔄 ワークフロー自動化
複数のスキルを連鎖させて、高度な自動化パイプラインを作成できます。データの処理、コンテンツの変換、アクションのトリガーを、すべてビジュアルにオーケストレーションできます。
開発
前提条件
- Node.js: 22.19以上（LTS推奨）
- パッケージマネージャー: pnpm 9以上（推奨）またはnpm
- Linux（Ubuntu/Debian）: Electron を実行する前に、必要なシステムライブラリをインストールしてください:
Ubuntu 24.04以降では、一部のパッケージに
sudo apt-get install -y libnss3 libgtk-3-0 libxss1 libxtst6 libatspi2.0-0 libnotify4 xdg-utilst64サフィックスが付いています。上記コマンドを実行するとaptが自動的に適切なバリアントを選択します。
プロジェクト構成
├── electron/ # Electron メインプロセス
│ ├── services/ # 型付き Host API、Provider/Secrets/ランタイムサービス
│ │ ├── providers/ # provider/account モデル同期ロジック
│ │ └── secrets/ # OS キーチェーンと秘密情報管理
│ ├── shared/ # 共通 Provider スキーマ/定数
│ │ └── providers/
│ ├── main/ # アプリ入口、ウィンドウ、IPC 登録
│ ├── gateway/ # OpenClaw ゲートウェイプロセスマネージャー
│ ├── preload/ # セキュア IPC ブリッジ
│ └── utils/ # ユーティリティ（ストレージ、認証、パス）
├── src/ # React レンダラープロセス
│ ├── lib/ # フロントエンド統一 API とエラーモデル
│ ├── stores/ # Zustand ストア（settings/chat/gateway）
│ ├── components/ # 再利用可能な UI コンポーネント
│ ├── pages/ # Setup/Dashboard/Chat/Channels/Skills/Cron/Settings
│ ├── i18n/ # ローカライズリソース
│ └── types/ # TypeScript 型定義
├── tests/
│ ├── e2e/ # Playwright による Electron E2E スモークテスト
│ └── unit/ # Vitest ユニット/統合寄りテスト
├── resources/ # 静的アセット（アイコン、画像）
└── scripts/ # ビルド/ユーティリティスクリプト
利用可能なコマンド
# 開発
pnpm run init # 依存関係のインストール + バンドルバイナリ（uv、agent-browser）のダウンロード
pnpm dev # ホットリロードで起動（不足時は同梱スキルを自動準備）
# コード品質
pnpm lint # ESLintを実行
pnpm typecheck # TypeScriptの型チェック
# テスト
pnpm test # ユニットテストを実行
pnpm run test:e2e # Electron E2E スモークテストを実行
pnpm run test:e2e:headed # 表示付きウィンドウで Electron E2E を実行
pnpm run comms:replay # 通信リプレイ指標を算出
pnpm run comms:baseline # 通信ベースラインを更新
pnpm run comms:compare # リプレイ指標をベースライン閾値と比較
# ビルド＆パッケージ
pnpm run build:vite # フロントエンドのみビルド
pnpm build # フルプロダクションビルド（パッケージアセット含む）
pnpm package # 現在のプラットフォーム向けにパッケージ化（同梱プリインストールスキルを含む）
pnpm package:mac # macOS向けにパッケージ化
pnpm package:win # Windows向けにパッケージ化
pnpm package:linux # Linux向けにパッケージ化
ヘッドレス Linux では Electron テストに表示サーバーが必要です。xvfb-run -a pnpm run test:e2e を利用してください。
通信回帰チェック
PR が通信経路（Gateway イベント、ACP Chat bridge の送受信フロー、Channel 配信、トランスポートのフォールバック）に触れる場合は、次を実行してください。
pnpm run comms:replay
pnpm run comms:compare
CI の comms-regression が必須シナリオと閾値を検証します。
技術スタック
| レイヤー | 技術 |
|---|---|
| ランタイム | Electron 40以上 |
| UIフレームワーク | React 19 + TypeScript |
| スタイリング | Tailwind CSS + shadcn/ui |
| ステート管理 | Zustand |
| ビルド | Vite + electron-builder |
| テスト | Vitest + Playwright |
| アニメーション | Framer Motion |
| アイコン | Lucide React |
コントリビューション
コミュニティからのコントリビューションを歓迎します！バグ修正、新機能、ドキュメントの改善、翻訳など、あらゆる貢献がClawXをより良くするのに役立ちます。
コントリビューション方法
- リポジトリをフォークする
- フィーチャーブランチを作成する（
git checkout -b feature/amazing-feature） - 明確なメッセージで変更をコミットする
- ブランチにプッシュする
- プルリクエストを作成する
ガイドライン
- 既存のコードスタイルに従う（ESLint + Prettier）
- 新機能にはテストを書く
- 必要に応じてドキュメントを更新する
- コミットはアトミックかつ説明的に保つ
謝辞
ClawXは優れたオープンソースプロジェクトの上に構築されています：
- OpenClaw – AIエージェントランタイム
- Electron – クロスプラットフォームデスクトップフレームワーク
- React – UIコンポーネントライブラリ
- shadcn/ui – 美しくデザインされたコンポーネント
- Zustand – 軽量ステート管理
コミュニティ
コミュニティに参加して、他のユーザーとつながり、サポートを受け、体験を共有しましょう。
| 企業微信 | Feishuグループ | Discord |
|---|---|---|
 |
 |
 |
ClawX パートナープログラム 🚀
ClawX パートナープログラムを開始します。特に、カスタム AI エージェントや自動化ニーズを持つより多くの顧客に ClawX を紹介してくださるパートナーを募集しています。
パートナーの皆さまには、見込みユーザーや案件との接点づくりを担っていただき、ClawX チームは技術サポート、カスタマイズ、統合を全面的に提供します。
AI ツールや自動化に関心のある顧客とお仕事をされている方は、ぜひご一緒できればうれしいです。
詳細は DM いただくか、public@valuecell.ai までメールでご連絡ください。
スター履歴
ライセンス
ClawXはMITライセンスの下でリリースされています。本ソフトウェアの使用、変更、配布は自由に行えます。
ValueCell Teamが❤️を込めて開発