{"id":44235385,"url":"https://github.com/valuecell-ai/clawx","last_synced_at":"2026-05-20T05:14:00.464Z","repository":{"id":337104571,"uuid":"1150626239","full_name":"ValueCell-ai/ClawX","owner":"ValueCell-ai","description":"ClawX is a desktop app that provides a graphical interface for OpenClaw AI agents. It turns CLI-based AI orchestration into a desktop experience without using the terminal. China website is https://clawx.com.cn.","archived":false,"fork":false,"pushed_at":"2026-04-16T11:04:19.000Z","size":17285,"stargazers_count":6560,"open_issues_count":93,"forks_count":952,"subscribers_count":41,"default_branch":"main","last_synced_at":"2026-04-16T11:05:18.139Z","etag":null,"topics":["agent","agentic-ai","agents","ai","clawdbot","moltbot","openclaw","skill"],"latest_commit_sha":null,"homepage":"https://claw-x.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ValueCell-ai.png","metadata":{"files":{"readme":"README.ja-JP.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-05T13:58:36.000Z","updated_at":"2026-04-16T10:54:49.000Z","dependencies_parsed_at":"2026-02-11T10:01:50.919Z","dependency_job_id":"e535dbe6-0f6c-4ed4-8e59-360a896237e4","html_url":"https://github.com/ValueCell-ai/ClawX","commit_stats":null,"previous_names":["valuecell-ai/clawx"],"tags_count":179,"template":true,"template_full_name":null,"purl":"pkg:github/ValueCell-ai/ClawX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValueCell-ai%2FClawX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValueCell-ai%2FClawX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValueCell-ai%2FClawX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValueCell-ai%2FClawX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ValueCell-ai","download_url":"https://codeload.github.com/ValueCell-ai/ClawX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ValueCell-ai%2FClawX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31962892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentic-ai","agents","ai","clawdbot","moltbot","openclaw","skill"],"created_at":"2026-02-10T09:17:30.879Z","updated_at":"2026-05-20T05:14:00.451Z","avatar_url":"https://github.com/ValueCell-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"src/assets/logo.svg\" width=\"128\" height=\"128\" alt=\"ClawX Logo\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eClawX\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eOpenClaw AIエージェントのためのデスクトップインターフェース\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#機能\"\u003e機能\u003c/a\u003e •\n  \u003ca href=\"#なぜclawxなのか\"\u003eなぜClawXなのか\u003c/a\u003e •\n  \u003ca href=\"#はじめに\"\u003eはじめに\u003c/a\u003e •\n  \u003ca href=\"#アーキテクチャ\"\u003eアーキテクチャ\u003c/a\u003e •\n  \u003ca href=\"#開発\"\u003e開発\u003c/a\u003e •\n  \u003ca href=\"#コントリビューション\"\u003eコントリビューション\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-MacOS%20%7C%20Windows%20%7C%20Linux-blue\" alt=\"Platform\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/electron-40+-47848F?logo=electron\" alt=\"Electron\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/react-19-61DAFB?logo=react\" alt=\"React\" /\u003e\n  \u003ca href=\"https://discord.com/invite/84Kex3GGAh\" target=\"_blank\"\u003e\n  \u003cimg src=\"https://img.shields.io/discord/1399603591471435907?logo=discord\u0026labelColor=%20%235462eb\u0026logoColor=%20%23f5f5f5\u0026color=%20%235462eb\" alt=\"chat on Discord\" /\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/downloads/ValueCell-ai/ClawX/total?color=%23027DEB\" alt=\"Downloads\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-green\" alt=\"License\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e | \u003ca href=\"README.zh-CN.md\"\u003e简体中文\u003c/a\u003e | 日本語 | \u003ca href=\"README.ru-RU.md\"\u003eРусский\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 概要\n\n**ClawX**は、強力なAIエージェントと日常のユーザーとの間のギャップを埋めます。[OpenClaw](https://github.com/OpenClaw)をベースに構築されており、コマンドラインによるAIオーケストレーションを、アクセスしやすく美しいデスクトップ体験に変換します。ターミナルは不要です。\n\nワークフローの自動化、AI搭載チャネルの管理、インテリジェントなタスクのスケジューリングなど、ClawXはAIエージェントを効果的に活用するために必要なインターフェースを提供します。\n\nClawXはベストプラクティスのモデルプロバイダーが事前設定されており、Windowsおよび多言語設定をネイティブにサポートしています。もちろん、**設定 → 詳細設定 → 開発者モード**から高度な設定を微調整することもできます。\n\n\u003cp align=\"center\"\u003e\u003cstrong style=\"font-size:1.1em; text-decoration: underline;\"\u003e完全なエンタープライズ版、専用のサービスサポート、または御社のビジネスシナリオに合わせた導入支援が必要な場合は、\u003ca href=\"mailto:public@valuecell.ai\"\u003epublic@valuecell.ai\u003c/a\u003e までお問い合わせください。\u003c/strong\u003e\u003c/p\u003e\n\n---\n## スクリーンショット\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/chat.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/cron.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/skills.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/channels.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/models.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"resources/screenshot/jp/settings.png\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n---\n\n## なぜClawXなのか\n\nAIエージェントの構築にコマンドラインの習得は不要であるべきです。ClawXはシンプルな哲学のもとに設計されました：**強力な技術には、あなたの時間を尊重するインターフェースがふさわしい。**\n\n| 課題 | ClawXのソリューション |\n|------|----------------------|\n| 複雑なCLIセットアップ | ワンクリックインストールとガイド付きセットアップウィザード |\n| 設定ファイル | リアルタイムバリデーション付きのビジュアル設定 |\n| プロセス管理 | ゲートウェイライフサイクルの自動管理 |\n| アプリ更新 | 起動時に更新を確認し、ダウンロードやインストール前に通知 |\n| 複数のAIプロバイダー | 統合プロバイダー設定パネル |\n| スキル/プラグインのインストール | 組み込みのスキルマーケットプレイスと管理機能 |\n\n### OpenClaw内蔵\n\nClawXは公式の**OpenClaw**コアを直接ベースに構築されています。別途インストールを必要とせず、アプリケーション内にランタイムを組み込むことで、シームレスな「バッテリー同梱」体験を提供します。\n\n私たちはアップストリームのOpenClawプロジェクトとの厳密な整合性を維持することにコミットしており、公式リリースが提供する最新の機能、安定性の改善、エコシステムの互換性に常にアクセスできることを保証します。\n\n開発者モードを有効にすると、サイドバーにはネイティブの Dreams ページも表示され、ClawX 内で OpenClaw の記憶レビュー、夢日記、基本メンテナンス操作を扱えます。詳細な診断が必要な場合は、そのページから完全版の OpenClaw Dreams UI も開けます。\n\n---\n\n## 機能\n\n### 🎯 ゼロ設定バリア\nインストールから最初のAIインタラクションまで、すべてのセットアップを直感的なグラフィカルインターフェースで完了できます。ターミナルコマンド不要、YAMLファイル不要、環境変数の探索も不要です。\n\n### 💬 インテリジェントチャットインターフェース\nモダンなチャット体験を通じてAIエージェントとコミュニケーションできます。複数の会話コンテキスト、メッセージ履歴、Markdownによるリッチコンテンツレンダリング（GitHub 風テーブルや KaTeX による LaTeX 数式 `$インライン$`、`$$ブロック$$`、`\\(インライン\\)`、`\\[ブロック\\]` を含む）に加え、マルチエージェント構成ではメイン入力欄の `@agent` から対象エージェントへ直接ルーティングできます。\nコンポーザーから挿入した Skill は `/skill-name` 形式のチップとして表示され、チップをクリックすると右側のプレビュー側欄でその Skill の `SKILL.md` を開けます。\n`@agent` で別のエージェントを選ぶと、ClawX はデフォルトエージェントを経由せず、そのエージェント自身の会話コンテキストへ直接切り替えます。各エージェントのワークスペースは既定で分離されていますが、より強い実行時分離は OpenClaw の sandbox 設定に依存します。\n各 Agent は `provider/model` の実行時設定を個別に上書きできます。上書きしていない Agent は引き続きグローバルの既定モデルを継承します。\n\n### 📡 マルチチャネル管理\n複数のAIチャネルを同時に設定・監視できます。各チャネルは独立して動作するため、異なるタスクに特化したエージェントを実行できます。\n現在は各チャンネルで複数アカウントを扱え、Channels ページでアカウントの Agent 紐付けやデフォルトアカウント切替を直接管理できます。\nカスタムのチャンネルアカウント ID には、ルーティング不一致を防ぐため OpenClaw 互換の正規形式（`[a-z0-9_-]`、英小文字、最大 64 文字、先頭は英小文字または数字）を必須にしています。\nClawX には Tencent 公式の個人 WeChat チャンネルプラグインも同梱されており、Channels ページからアプリ内 QR フローで直接 WeChat を連携できます。\n\n### ⏰ Cronベースの自動化\nAIタスクを自動的に実行するようスケジュール設定できます。トリガーを定義し、間隔を設定することで、手動介入なしにAIエージェントを24時間稼働させることができます。\n定期タスク画面では外部配信を「送信アカウント」と「受信先ターゲット」の 2 段階セレクターで設定できるようになりました。対応チャネルでは、受信先候補をチャネルのディレクトリ機能や既知セッション履歴から自動検出するため、`jobs.json` を手で編集する必要はありません。\n\n\n### 🧩 拡張可能なスキルシステム\n事前構築されたスキルでAIエージェントを拡張できます。統合スキルパネルからスキルの閲覧、インストール、管理が可能です。パッケージマネージャーは不要です。\nClawX はドキュメント処理スキル（`pdf`、`xlsx`、`docx`、`pptx`）もフル内容で同梱し、起動時に管理スキルディレクトリ（既定 `~/.openclaw/skills`）へ自動配備し、初回インストール時に既定で有効化します。追加の同梱スキル（`find-skills`、`self-improving-agent`、`tavily-search`）も既定で有効化されますが、必要な API キーが未設定の場合は OpenClaw が実行時に設定エラーを表示します。  \nSkills ページでは OpenClaw の複数ソース（管理ディレクトリ、workspace、追加スキルディレクトリ）から検出されたスキルを表示でき、各スキルの実際のパスを確認して実フォルダを直接開けます。\n\n主な検索スキルで必要な環境変数:\n- `TAVILY_API_KEY`: `tavily-search` 用（上流ランタイムで OAuth 対応の場合あり）\n\n### 🔐 セキュアなプロバイダー統合\n複数のAIプロバイダー（OpenAI、Anthropicなど）に接続でき、資格情報はシステムのネイティブキーチェーンに安全に保存されます。OpenAI は API キーとブラウザ OAuth（Codex サブスクリプション）の両方に対応しています。\nOpenAI-compatible ゲートウェイを **Custom プロバイダー** で使う場合、**設定 → AI Providers → Provider 編集** でカスタム `User-Agent` を設定でき、互換性が必要なエンドポイントで有効です。\n互換ゲートウェイで `/models` が認証以外の理由で使えない場合、ClawX は API キー検証時に軽量な `/chat/completions` または `/responses` プローブへ自動フォールバックします。\n\n### 🌙 アダプティブテーマ\nライトモード、ダークモード、またはシステム同期テーマ。ClawXはあなたの好みに自動的に適応します。\n\n### 🚀 自動起動設定\n**設定 → 通用** から **システム起動時に自動起動** を有効化すると、ログイン後に ClawX が自動的に起動します。\n\n### 🔔 更新通知\nClawX は起動時に新しいバージョンを自動確認できます。更新が見つかるとアプリ内通知を表示し、ダウンロードやインストールはユーザーが選択した後にのみ実行されます。\n\n---\n\n## はじめに\n\n### システム要件\n\n- **オペレーティングシステム**: macOS 11以上、Windows 10以上、またはLinux（Ubuntu 20.04以上）\n- **メモリ**: 最低4GB RAM（8GB推奨）\n- **ストレージ**: 1GBの空きディスク容量\n\n### インストール\n\n#### ビルド済みリリース（推奨）\n\n[Releases](https://github.com/ValueCell-ai/ClawX/releases)ページから、お使いのプラットフォーム向けの最新リリースをダウンロードしてください。\n\n#### ソースからビルド\n\n```bash\n# リポジトリをクローン\ngit clone https://github.com/ValueCell-ai/ClawX.git\ncd ClawX\n\n# プロジェクトの初期化\npnpm run init\n\n# 開発モードで起動\npnpm dev\n```\n### 初回起動\n\nClawXを初めて起動すると、**セットアップウィザード**が以下の手順をガイドします：\n\n1. **言語と地域** – 使用する言語・地域の設定\n2. **AIプロバイダー** – APIキーまたは OAuth（ブラウザ/デバイスログイン対応プロバイダー）で追加\n3. **スキルバンドル** – 一般的なユースケース向けの事前設定スキルを選択\n4. **検証** – メインインターフェースに入る前に設定をテスト\n\nサポート対象のシステム言語がある場合、ウィザードはその言語を初期選択し、未対応の場合は英語にフォールバックします。\n\n### プロキシ設定\n\nClawXには、Electron、OpenClaw Gateway、またはTelegramなどのチャネルがローカルプロキシクライアントを介してインターネットにアクセスする必要がある環境向けに、組み込みのプロキシ設定が含まれています。\n\n**設定 → ゲートウェイ → プロキシ**を開いて以下を設定します：\n\n- **プロキシサーバー**: すべてのリクエストのデフォルトプロキシ\n- **バイパスルール**: 直接接続すべきホスト（セミコロン、カンマ、または改行で区切る）\n- **開発者モード**では、オプションで以下をオーバーライドできます：\n  - **HTTP プロキシ**\n  - **HTTPS プロキシ**\n  - **ALL_PROXY / SOCKS**\n\n推奨されるローカル設定例：\n\n```text\nプロキシサーバー: http://127.0.0.1:7890\n```\n注意事項：\n\n- `host:port`のみの値はHTTPとして扱われます。\n- 高度なプロキシフィールドが空の場合、ClawXは`プロキシサーバー`にフォールバックします。\n- プロキシ設定を保存すると、Electronのネットワーク設定が即座に再適用され、ゲートウェイが自動的に再起動されます。\n- ClawXはTelegramが有効な場合、プロキシをOpenClawのTelegramチャネル設定にも同期します。\n- ClawXのプロキシが無効な状態では、Gatewayの通常再起動時に既存のTelegramチャネルプロキシ設定を保持します。\n- OpenClaw設定のTelegramプロキシを明示的に消したい場合は、プロキシ無効の状態で一度「保存」を実行してください。\n- **設定 → 詳細 → 開発者** では **OpenClaw Doctor** を実行でき、`openclaw doctor --json` の診断出力をアプリ内で確認できます。\n- Windows のパッケージ版では、同梱された `openclaw` CLI/TUI は端末入力を安定させるため、同梱の `node.exe` エントリーポイント経由で実行されます。\n\n---\n\n## アーキテクチャ\n\nClawXは、**デュアルプロセス + Host API 統一アクセス**構成を採用しています。Renderer は単一クライアント抽象を呼び出し、プロトコル選択とライフサイクルは Main が管理します：\n\n```\n┌────────────────────────────────────────────────────────────────────┐\n│                        ClawX デスクトップアプリ                       │\n│                                                                    │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │              Electron メインプロセス                            │  │\n│  │  • ウィンドウ＆アプリケーションライフサイクル管理                    │  │\n│  │  • ゲートウェイプロセスの監視                                     │  │\n│  │  • システム統合（トレイ、通知、キーチェーン）                       │  │\n│  │  • 自動アップデートオーケストレーション                            │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n│                              │                                     │\n│                              │ IPC（権威ある制御プレーン）             │\n│                              ▼                                     │\n│  ┌──────────────────────────────────────────────────────────────┐  │\n│  │              React レンダラープロセス                           │  │\n│  │  • モダンなコンポーネントベースUI（React 19）                      │  │\n│  │  • Zustandによるステート管理                                    │  │\n│  │  • 統一 host-api/api-client 呼び出し                           │  │\n│  │  • リッチなMarkdownレンダリング                                 │  │\n│  └──────────────────────────────────────────────────────────────┘  │\n└──────────────────────────────┬─────────────────────────────────────┘\n                               │\n                               │ Main管理のトランスポート戦略\n                               │（WS優先、HTTP次点、IPCフォールバック）\n                               ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                Host API と Main プロキシ層                        │\n│                                                                 │\n│  • hostapi:fetch（Mainプロキシ、CORS回避）                         │\n│  • gateway:httpProxy（RendererはGateway HTTPに直アクセスしない）    │\n│  • 統一エラーマッピングとリトライ/バックオフ                           │\n└──────────────────────────────┬──────────────────────────────────┘\n                               │\n                               │ WS / HTTP / IPC フォールバック\n                               ▼\n┌─────────────────────────────────────────────────────────────────┐\n│                     OpenClaw ゲートウェイ                         │\n│                                                                 │\n│  • AIエージェントランタイムとオーケストレーション                       │\n│  • メッセージチャネル管理                                           │\n│  • スキル/プラグイン実行環境                                        │\n│  • プロバイダー抽象化レイヤー                                       │\n└─────────────────────────────────────────────────────────────────┘\n```\n### 設計原則\n\n- **プロセス分離**: AIランタイムは別プロセスで動作し、重い計算処理中でもUIの応答性を確保します\n- **フロントエンド呼び出しの単一入口**: Renderer は host-api/api-client を通じて呼び出し、下位プロトコルに依存しません\n- **Mainによるトランスポート制御**: WS/HTTP の選択と IPC フォールバックを Main で一元管理します\n- **グレースフルリカバリ**: 再接続・タイムアウト・バックオフで一時的障害を自動処理します\n- **セキュアストレージ**: APIキーや機密データは、OSのネイティブセキュアストレージ機構を活用します\n- **CORSセーフ設計**: ローカルHTTPはMainプロキシ経由とし、Renderer側CORS問題を回避します\n\n### プロセスモデルと Gateway トラブルシューティング\n\n- ClawX は Electron アプリのため、**1つのアプリインスタンスでも複数プロセス（main/renderer/zygote/utility）が表示される**のが正常です。\n- 単一起動保護は Electron のロックに加え、ローカルのプロセスロックファイルも併用し、デスクトップ IPC / セッションバスが不安定な環境でも重複起動を防ぎます。\n- ローリングアップグレード中に旧版/新版が混在すると、単一起動保護の挙動が非対称になる場合があります。安定運用のため、デスクトップクライアントは可能な限り同一バージョンへ揃えてください。\n- ただし OpenClaw Gateway の待受は常に**単一**であるべきです。`127.0.0.1:18789` を Listen しているプロセスは1つだけです。\n- Gateway の readiness は `system-presence`、`health`、`status` などの OpenClaw コア信号を基準にし、memory、Dreams、チャネルの失敗はグローバルな Gateway 障害ではなく capability degradation として表示します。\n- Listen プロセスの確認例:\n  - macOS/Linux: `lsof -nP -iTCP:18789 -sTCP:LISTEN`\n  - Windows (PowerShell): `Get-NetTCPConnection -LocalPort 18789 -State Listen`\n- ウィンドウの閉じるボタン（`X`）は既定でトレイへ最小化する動作で、完全終了ではありません。完全終了する場合はトレイメニューの **Quit ClawX** を使用してください。\n\n---\n\n## ユースケース\n\n### 🤖 パーソナルAIアシスタント\n質問への回答、メールの下書き、ドキュメントの要約、日常タスクのサポートなど、汎用的なAIエージェントを設定できます。すべてクリーンなデスクトップインターフェースから操作できます。\n\n### 📊 自動モニタリング\nニュースフィード、価格追跡、特定イベントの監視などを行うスケジュールエージェントを設定できます。結果はお好みの通知チャネルに配信されます。\n\n### 💻 開発者の生産性向上\nAI を開発ワークフローに統合できます。エージェントを使用して、コードレビュー、ドキュメント生成、反復的なコーディングタスクの自動化が可能です。\n\n### 🔄 ワークフロー自動化\n複数のスキルを連鎖させて、高度な自動化パイプラインを作成できます。データの処理、コンテンツの変換、アクションのトリガーを、すべてビジュアルにオーケストレーションできます。\n\n---\n\n## 開発\n\n### 前提条件\n\n- **Node.js**: 22以上（LTS推奨）\n- **パッケージマネージャー**: pnpm 9以上（推奨）またはnpm\n\n### プロジェクト構成\n\n```ClawX/\n├── electron/                 # Electron メインプロセス\n│   ├── api/                 # メイン側 API ルーターとハンドラー\n│   │   └── routes/          # RPC/HTTP プロキシのルートモジュール\n│   ├── services/            # Provider/Secrets/ランタイムサービス\n│   │   ├── providers/       # provider/account モデル同期ロジック\n│   │   └── secrets/         # OS キーチェーンと秘密情報管理\n│   ├── shared/              # 共通 Provider スキーマ/定数\n│   │   └── providers/\n│   ├── main/                # アプリ入口、ウィンドウ、IPC 登録\n│   ├── gateway/             # OpenClaw ゲートウェイプロセスマネージャー\n│   ├── preload/             # セキュア IPC ブリッジ\n│   └── utils/               # ユーティリティ（ストレージ、認証、パス）\n├── src/                      # React レンダラープロセス\n│   ├── lib/                 # フロントエンド統一 API とエラーモデル\n│   ├── stores/              # Zustand ストア（settings/chat/gateway）\n│   ├── components/          # 再利用可能な UI コンポーネント\n│   ├── pages/               # Setup/Dashboard/Chat/Channels/Skills/Cron/Settings\n│   ├── i18n/                # ローカライズリソース\n│   └── types/               # TypeScript 型定義\n├── tests/\n│   ├── e2e/                 # Playwright による Electron E2E スモークテスト\n│   └── unit/                # Vitest ユニット/統合寄りテスト\n├── resources/                # 静的アセット（アイコン、画像）\n└── scripts/                  # ビルド/ユーティリティスクリプト\n```\n### 利用可能なコマンド\n\n```bash\n# 開発\npnpm run init             # 依存関係のインストール + uvのダウンロード\npnpm dev                  # ホットリロードで起動（不足時は同梱スキルを自動準備）\n\n# コード品質\npnpm lint                 # ESLintを実行\npnpm typecheck            # TypeScriptの型チェック\n\n# テスト\npnpm test                 # ユニットテストを実行\npnpm run test:e2e         # Electron E2E スモークテストを実行\npnpm run test:e2e:headed  # 表示付きウィンドウで Electron E2E を実行\npnpm run comms:replay     # 通信リプレイ指標を算出\npnpm run comms:baseline   # 通信ベースラインを更新\npnpm run comms:compare    # リプレイ指標をベースライン閾値と比較\n\n# ビルド＆パッケージ\npnpm run build:vite       # フロントエンドのみビルド\npnpm build                # フルプロダクションビルド（パッケージアセット含む）\npnpm package              # 現在のプラットフォーム向けにパッケージ化（同梱プリインストールスキルを含む）\npnpm package:mac          # macOS向けにパッケージ化\npnpm package:win          # Windows向けにパッケージ化\npnpm package:linux        # Linux向けにパッケージ化\n```\n\nヘッドレス Linux では Electron テストに表示サーバーが必要です。`xvfb-run -a pnpm run test:e2e` を利用してください。\n\n### 通信回帰チェック\n\nPR が通信経路（Gateway イベント、Chat 送受信フロー、Channel 配信、トランスポートのフォールバック）に触れる場合は、次を実行してください。\n\n```bash\npnpm run comms:replay\npnpm run comms:compare\n```\n\nCI の `comms-regression` が必須シナリオと閾値を検証します。\n### 技術スタック\n\n| レイヤー | 技術 |\n|---------|------|\n| ランタイム | Electron 40以上 |\n| UIフレームワーク | React 19 + TypeScript |\n| スタイリング | Tailwind CSS + shadcn/ui |\n| ステート管理 | Zustand |\n| ビルド | Vite + electron-builder |\n| テスト | Vitest + Playwright |\n| アニメーション | Framer Motion |\n| アイコン | Lucide React |\n\n---\n\n## コントリビューション\n\nコミュニティからのコントリビューションを歓迎します！バグ修正、新機能、ドキュメントの改善、翻訳など、あらゆる貢献がClawXをより良くするのに役立ちます。\n\n### コントリビューション方法\n\n1. リポジトリを**フォーク**する\n2. フィーチャーブランチを**作成**する（`git checkout -b feature/amazing-feature`）\n3. 明確なメッセージで変更を**コミット**する\n4. ブランチに**プッシュ**する\n5. **プルリクエスト**を作成する\n\n### ガイドライン\n\n- 既存のコードスタイルに従う（ESLint + Prettier）\n- 新機能にはテストを書く\n- 必要に応じてドキュメントを更新する\n- コミットはアトミックかつ説明的に保つ\n\n---\n\n## 謝辞\n\nClawXは優れたオープンソースプロジェクトの上に構築されています：\n\n- [OpenClaw](https://github.com/OpenClaw) – AIエージェントランタイム\n- [Electron](https://www.electronjs.org/) – クロスプラットフォームデスクトップフレームワーク\n- [React](https://react.dev/) – UIコンポーネントライブラリ\n- [shadcn/ui](https://ui.shadcn.com/) – 美しくデザインされたコンポーネント\n- [Zustand](https://github.com/pmndrs/zustand) – 軽量ステート管理\n\n---\n\n## コミュニティ\n\nコミュニティに参加して、他のユーザーとつながり、サポートを受け、体験を共有しましょう。\n\n| 企業微信 | Feishuグループ | Discord |\n| :---: | :---: | :---: |\n| \u003cimg src=\"src/assets/community/wecom-qr.png\" width=\"150\" alt=\"WeChat QRコード\" /\u003e | \u003cimg src=\"src/assets/community/feishu-qr.png\" width=\"150\" alt=\"Feishu QRコード\" /\u003e | \u003cimg src=\"src/assets/community/20260212-185822.png\" width=\"150\" alt=\"Discord QRコード\" /\u003e |\n\n### ClawX パートナープログラム 🚀\n\nClawX パートナープログラムを開始します。特に、カスタム AI エージェントや自動化ニーズを持つより多くの顧客に ClawX を紹介してくださるパートナーを募集しています。\n\nパートナーの皆さまには、見込みユーザーや案件との接点づくりを担っていただき、ClawX チームは技術サポート、カスタマイズ、統合を全面的に提供します。\n\nAI ツールや自動化に関心のある顧客とお仕事をされている方は、ぜひご一緒できればうれしいです。\n\n詳細は DM いただくか、[public@valuecell.ai](mailto:public@valuecell.ai) までメールでご連絡ください。\n\n---\n\n## スター履歴\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://api.star-history.com/svg?repos=ValueCell-ai/ClawX\u0026type=Date\" alt=\"スター履歴チャート\" /\u003e\n\u003c/p\u003e\n\n---\n\n## ライセンス\n\nClawXは[MITライセンス](LICENSE)の下でリリースされています。本ソフトウェアの使用、変更、配布は自由に行えます。\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eValueCell Teamが❤️を込めて開発\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaluecell-ai%2Fclawx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaluecell-ai%2Fclawx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaluecell-ai%2Fclawx/lists"}