# ClawManager
チーム規模からクラスタ規模まで、OpenClaw と Linux デスクトップランタイムを一元管理するための Kubernetes-first コントロールプレーンです。
言語:
English |
中文 |
日本語 |
한국어 |
Deutsch
## これは何か
ClawManager は、Kubernetes 上でデスクトップランタイムの配備、運用、アクセスを一か所で管理できるようにします。
次のような環境に向いています：
- 複数ユーザー向けにデスクトップインスタンスを作成したい
- quota、イメージ、ライフサイクルを集中管理したい
- デスクトップサービスをクラスタ内部に保持したい
- Pod を直接公開せず、安全なブラウザアクセスを提供したい
## 選ばれる理由
- ユーザー、quota、インスタンス、ランタイムイメージを一つの管理画面で運用
- OpenClaw の記憶や設定のインポート／エクスポートに対応
- サービスを直接公開せず、プラットフォーム経由で安全にデスクトップへアクセス
- Kubernetes に自然に合う配備・運用フロー
- 管理者による配布運用とユーザーのセルフサービス作成の両方に対応
## クイックスタート
### 前提条件
- 利用可能な Kubernetes クラスタ
- `kubectl get nodes` が正常に動作する
### デプロイ
同梱のマニフェストをそのまま適用します：
```bash
kubectl apply -f deployments/k8s/clawmanager.yaml
kubectl get pods -A
kubectl get svc -A
```
## ソースコードからビルド
同梱の Kubernetes マニフェストを使わず、ソースコードから ClawManager を実行またはパッケージしたい場合：
### フロントエンド
```bash
cd frontend
npm install
npm run build
```
### バックエンド
```bash
cd backend
go mod tidy
go build -o bin/clawreef cmd/server/main.go
```
### Docker イメージ
リポジトリのルートでアプリ全体のイメージをビルドします：
```bash
docker build -t clawmanager:latest .
```
### デフォルトアカウント
- デフォルトの管理者アカウント: `admin / admin123`
- インポートした管理者ユーザーのデフォルトパスワード: `admin123`
- インポートした一般ユーザーのデフォルトパスワード: `user123`
### 最初の利用手順
1. 管理者としてログインします。
2. ユーザーを作成またはインポートし、quota を割り当てます。
3. システム設定でランタイムイメージカードを確認または更新します。
4. 一般ユーザーとしてログインし、インスタンスを作成します。
5. Portal View または Desktop Access からデスクトップにアクセスします。
## 主な機能
- インスタンスのライフサイクル管理: 作成、起動、停止、再起動、削除、参照、同期
- 対応ランタイム: `openclaw`, `webtop`, `ubuntu`, `debian`, `centos`, `custom`
- 管理画面からのランタイムイメージカード管理
- CPU、メモリ、ストレージ、GPU、インスタンス数に対するユーザー単位の quota 制御
- ノード、CPU、メモリ、ストレージを対象にしたクラスタ資源概要
- トークンベースのデスクトップアクセスと WebSocket 転送
- CSV による一括ユーザー導入
- 多言語インターフェース
## 利用の流れ
1. 管理者がユーザー、quota、ランタイムイメージ方針を設定します。
2. ユーザーが OpenClaw または Linux デスクトップインスタンスを作成します。
3. ClawManager が Kubernetes リソースを作成し、状態を追跡します。
4. ユーザーがプラットフォーム経由でデスクトップにアクセスします。
5. 管理者がダッシュボードから健全性と容量を確認します。
## アーキテクチャ
```text
Browser
-> ClawManager Frontend
-> ClawManager Backend
-> MySQL
-> Kubernetes API
-> Pod / PVC / Service
-> OpenClaw / Webtop / Linux Desktop Runtime
```
## 設定メモ
- インスタンスサービスは Kubernetes の内部ネットワーク上で動作します
- デスクトップアクセスは認証済みバックエンドプロキシを経由します
- ランタイムイメージはシステム設定から上書きできます
- バックエンドはクラスタ内部に配置するのが最適です
主なバックエンド環境変数：
- `SERVER_ADDRESS`
- `SERVER_MODE`
- `DB_HOST`
- `DB_PORT`
- `DB_USER`
- `DB_PASSWORD`
- `DB_NAME`
- `JWT_SECRET`
### CSV インポートテンプレート
```csv
Username,Email,Role,Max Instances,Max CPU Cores,Max Memory (GB),Max Storage (GB),Max GPU Count (optional)
```
メモ：
- `Email` は任意です
- `Max GPU Count (optional)` は任意です
- それ以外の列は必須です
## ライセンス
本プロジェクトは MIT License の下で公開されています。
## オープンソース
issue と pull request を歓迎します。