MCPcopy Index your code
hub / github.com/GreenSheep01201/claw-empire

github.com/GreenSheep01201/claw-empire @v2.0.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.0.4 ↗ · + Follow
2,598 symbols 7,108 edges 451 files 15 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Claw-Empire

Claw-Empire

CEOデスクからAIエージェント帝国を指揮しよう

CLI、OAuth、API連携プロバイダー（Claude Code、Codex CLI、Gemini CLI、OpenCode、Kimi Code、GitHub Copilot、Antigravity など）を自律エージェントの仮想企業として統合運用するローカルファーストAIエージェントオフィスシミュレーター

Releases CI Node.js 22+ License Platform AI Agents

クイックスタート · AIインストール · リリースノート · OpenClaw連携 · 直接メッセンジャー · $ コマンド · 機能一覧 · スクリーンショット · 技術スタック · プロバイダー · Dockerデプロイ · セキュリティ

English | 한국어 | 日本語 | 中文

Office View

Claw-Empireとは？

Claw-Empireは CLI、OAuth、直接APIキー で接続されたAIコーディングアシスタントを、完全にシミュレートされた仮想ソフトウェア会社へと変革します。あなたがCEOです。AIエージェントたちが社員として働きます。部署をまたいで協力し、会議を開き、タスクを完遂し、レベルアップしていく様子を、魅力的なピクセルアートのオフィスインターフェースを通じてリアルタイムに観察できます。

なぜClaw-Empireなのか？

  • 一つのインターフェースで複数のAIエージェントを管理 — CLI/OAuth/API接続エージェントを単一のダッシュボードから一元管理
  • ローカルファースト＆プライバシー保護 — すべてのデータはローカルに保存。SQLiteデータベースを使用し、クラウド依存ゼロ
  • 直感的なビジュアル体験 — ピクセルアートのオフィスビューがAIオーケストレーションを楽しく、わかりやすく表現
  • 真の自律コラボレーション — エージェントは独立したgit worktreeで作業し、会議に参加して成果物を生み出す

AIでインストール

以下をAIコーディングエージェント（Claude Code、Codex、Gemini CLI等）に貼り付けるだけです：

Install Claw-Empire following the guide at: https://github.com/GreenSheep01201/claw-empire

AIがこのREADMEを読んで自動的にすべてを処理します。

最新リリース (v2.0.4)

  • Dockerデプロイが正式な運用パスとして追加されました - プロダクション向け Dockerfile、docker-compose.yml、.dockerignore、コンテナ環境向けランタイムパス整理が含まれます。
  • 中断後に working のまま残ったエージェントを自動復旧します - lifecycle の起動時/定期スイープが、生きた in_progress タスクを持たない working エージェントを idle に戻します。
  • Settings > API で公式 direct API プリセットが使えるようになりました - OpenCode Go と Bailian Coding Plan のプリセットが Base URL 固定、fallback モデル初期化、明示的な refresh/retry 動線を提供します。
  • Kimi Code が end-to-end でサポートされました - CLI 実行、プロバイダー表示、skills learn/unlearn、prompt skills、video-preprod bootstrap、既存 schema/runtime の provider チェックまで接続されています。
  • API モデル割り当ては development を起点に、初期セットアップ済みの office pack まで広がります - development を既定の基準線として保ちつつ、すでに hydrate 済みの office pack も割り当て対象に含まれます。

  • ローカル E2E 検証がより安全でクリーンになりました - pnpm run test:e2e は Playwright 実行の前後で隔離ランタイムを初期化し、既存の 8810 サーバー再利用も明示的に opt-in した場合のみ有効です。

  • 詳細: docs/releases/v2.0.4.md

  • APIドキュメント: docs/api.md, docs/openapi.json
  • セキュリティポリシー: SECURITY.md

オフィスパックプロファイル (v2.0.1)

各オフィスパックは、協業構造・命名シード・ワークフロー特性が異なるプロファイルとして動作します。

パック 中核フォーカス 代表的な組織構成
development (DEV) 後方互換を維持する標準開発ベースライン 企画 / 開発 / デザイン / QA-QC / DevSecOps / 運用
report (RPT) 構造化レポートと文書成果物の作成 編集企画室、リサーチエンジン、ドキュメントデザイン、レビュー班
web_research_report (WEB) 情報源収集と引用根拠検証を重視した調査 調査戦略室、クロール班、ファクトチェック
novel (NOV) 世界観・物語・文体トーンの一貫性重視 世界観室、物語エンジン、キャラアート、トーン検証
video_preprod (VID) コンセプト/台本/ショットリスト/編集ノートのプリプロ品質 プリプロ班、シーン設計、アート撮影、カット検証
roleplay (RPG) キャラになりきる会話没入と設定一貫性 キャラ企画室、会話エンジン、演出アート、キャラ検証

スクリーンショット

**ダッシュボード** — リアルタイムKPIメトリクス、エージェントランキング、各部署のステータスを一目で把握 Dashboard **カンバンボード** — 部署・エージェントフィルター付きのドラッグ＆ドロップによるタスク管理 Kanban Board
**スキルライブラリ** — カテゴリ別に整理された600以上のエージェントスキルを閲覧・割り当て Skills Library **マルチプロバイダーCLI** — Claude Code、Codex、Gemini CLI、OpenCode、Kimi Code をモデル選択付きで設定 CLI Tools Settings
**OAuth連携** — 暗号化トークンストレージによる安全なGitHub・Google OAuth OAuth Settings **議事録** — AIが生成する会議サマリーと複数ラウンドのレビュー承認フロー Meeting Minutes
**メッセンジャー連携** — Telegram、WhatsApp、Discord、Google Chat、Slack、Signal、iMessage セッションを設定して `$` CEOディレクティブを送信 Messenger Integration **設定** — 会社名、CEO名、デフォルトプロバイダー設定（CLI/OAuth/API）、言語などの環境設定 Settings
**詳細レポート** — リクエスト完了時のレポートポップアップ、履歴、詳細表示のサンプル Detailed Report **PPT生成例** — レポート依頼から生成されたPPT出力のサンプル PPT Generation Example 0 PPT Generation Example 1

映像出力サンプル

イントロ映像の出力サンプル:

PPT サンプルソース

レポートからPPTを生成する機能を確認・拡張するためのサンプルを参照できます。 利用手順: チャット画面 > Report Request ボタン を押して依頼内容を入力してください。

機能一覧

機能 説明
ピクセルアートオフィス 6つの部署でエージェントが歩き回り、作業し、会議に参加するアニメーション付きオフィスビュー
ワークフローパックプロファイル development / report / web_research_report / novel / video_preprod / roleplay の6種で、ルーティングスキーマ・QAルール・出力テンプレートを切り替え可能
オフィスパックプロファイル パック単位で部署トポロジー、命名/テーマシード、社員・部署データを分離運用（開発パックは既存DB基準線を維持）
カンバンタスクボード 受信箱、計画中、協議中、進行中、レビュー中、完了 — ドラッグ＆ドロップ対応の完全なタスクライフサイクル管理
CEOチャット＆ディレクティブ チームリーダーへの直接コミュニケーション；$ ディレクティブで会議選択と作業パス/コンテキスト（project_path、project_context）を指定可能
マルチプロバイダー対応 Claude Code、Codex CLI、Gemini CLI、OpenCode、Kimi Code、Antigravity — すべて一つのダッシュボードから管理
外部APIプロバイダー 設定 > APIタブからエージェントを外部LLM API（OpenAI、Anthropic、Google、Ollama、OpenRouter、Together、Groq、Cerebras、カスタム）に接続し、OpenCode Go / Bailian の公式プリセットも利用可能
OAuth連携 ローカルSQLiteへのAES暗号化トークンストレージによるGitHub・Google OAuth
リアルタイムWebSocket ライブステータス更新、アクティビティフィード、エージェント状態のリアルタイム同期
アクティブエージェント制御 作業中エージェントのプロセス/活動/アイドル情報を可視化し、スタックしたタスクを強制停止
タスクレポートシステム 完了ポップアップ、レポート履歴、チーム別詳細、企画リード統合アーカイブ
社員管理 社員の採用・編集・削除、多言語名、部署・役職・プロバイダー選択および性格設定に対応
エージェントランキング＆XP タスク完了でXPを獲得するエージェント；上位パフォーマーを追跡するランキングボード
スキルライブラリ Frontend、Backend、Design、AI、DevOps、Securityなど600以上のカテゴリ別スキル、カスタムスキルアップロード対応
ミーティングシステム 予定・臨時ミーティング対応；AIによる議事録自動生成と複数ラウンドレビュー機能
Git Worktree分離 各エージェントは独立したgitブランチで作業し、CEO承認後にのみマージ
多言語UI 英語、韓国語、日本語、中国語 — 自動検出または手動設定
メッセンジャー連携 Telegram、Discord、Slack等 — 内蔵の直接チャネルセッション経由で $ CEOディレクティブ送信＆更新受信（OpenClawは任意）
PowerPointエクスポート 議事録やレポートからプレゼンテーションスライドを自動生成
通信QAスクリプト test:comm:* スクリプトでCLI/OAuth/API疎通を再試行・証跡ログ付きで検証
インアプリ更新通知 GitHub 最新リリースを確認し、新バージョンがある場合にOS別 git pull 手順とリリースノートリンクを上部バナー表示
部署管理 企画、開発、デザイン、QA/QC、DevSecOps、オペレーション — 専用管理タブで矢印/ドラッグ＆ドロップ並び順編集が可能
社員手動割り当て プロジェクトに特定社員を指定すると、会議やタスク委任で指定社員のみを対象に運用
スプライト登録安全装置 重複スプライト番号ファイルの上書きを 409 sprite_number_exists レスポンスで防止
カスタムスキルアップロード UIから .md スキルファイルをアップロードしてCLI代表にカスタムスキルを学習させる。黒板教室アニメーションと管理画面付き

技術スタック

レイヤー 技術
フロントエンド React 19 + Vite 7 + Tailwind CSS 4 + TypeScript 5.9
ピクセルアートエンジン PixiJS 8
バックエンド Express 5 + SQLite（設定不要の組み込みDB）
リアルタイム通信 WebSocket (ws)
バリデーション Zod 4
アイコン Lucide React
ルーティング React Router 7
エクスポート PptxGenJS（PowerPoint生成）

AIインストールガイド

このセクションはAIコーディングエージェント向けです。各ステップで検証コマンドを実行してから次に進んでください。

ステップ0: 前提条件の確認

# Node.js 22+
node -v

# pnpm（未導入ならcorepackを有効化）
pnpm -v || corepack enable

# git
git --version

ステップ1: クローンしてワンクリックセットアップ

```bash

Extension points exported contracts — how you extend this code

ThemeContextValue (Interface)
(no doc)
src/ThemeContext.tsx
I18nContextValue (Interface)
(no doc)
src/i18n.ts
Department (Interface)
(no doc)
src/types/index.ts
DashboardProps (Interface)
(no doc)
src/components/Dashboard.tsx
UseAppActionsParams (Interface)
(no doc)
src/app/useAppActions.ts
ApiProvider (Interface)
(no doc)
src/api/providers-reports-github.ts
BaseRuntimeContext (Interface)
(no doc)
server/types/runtime-context.ts
RegisterGracefulShutdownHandlersOptions (Interface)
(no doc)
server/modules/lifecycle/register-graceful-shutdown.ts

Core symbols most depended-on inside this repo

broadcast
called by 151
server/ws/hub.ts
l
called by 128
server/modules/routes/collab/language-policy.ts
pickL
called by 128
server/modules/routes/collab/language-policy.ts
normalizeTextField
called by 108
server/modules/routes/collab/coordination.ts
appendTaskLog
called by 102
server/modules/workflow/agents/providers/process-tools.ts
t
called by 99
src/components/ReportHistory.tsx
l
called by 94
server/modules/workflow/core.ts
pickL
called by 90
server/modules/workflow/core.ts

Shape

Function 2,238
Interface 303
Method 47
Class 10

Languages

TypeScript100%

Modules by API surface

server/gateway/client.ts47 symbols
server/modules/workflow/orchestration.ts44 symbols
src/api/workflow-skills-subtasks.ts42 symbols
src/api/organization-projects.ts42 symbols
server/modules/routes/ops/messages/decision-inbox/types.ts41 symbols
src/api/messaging-runtime-oauth.ts37 symbols
src/api/providers-reports-github.ts32 symbols
src/api/core.ts29 symbols
server/modules/workflow/core.ts28 symbols
scripts/generate-architecture-report.mjs28 symbols
server/modules/workflow/core/reply-core-tools.ts27 symbols
server/modules/routes/collab/direct-chat-project-binding.ts27 symbols

For agents

$ claude mcp add claw-empire \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page