HappyClaw

概要

HappyClaw は、Claude Code エージェント（Anthropic の「Claude Agent SDK」）を長時間実行サービスとして運用できる、セルフホステッド・マルチユーザープラットフォームです。公式の Claude Code ランタイムを Node.js/TypeScript サーバーでラップし、Web UI と 8 つのインスタントメッセージングチャネル（Feishu、Telegram、QQ、DingTalk、WeChat、Enterprise WeChat、Discord、WhatsApp）を通じてエージェントを公開します。ユーザーはエージェントを作成し、分離されたワークスペースに割り当て、コードの実行、シェルコマンドの実行、Web ブラウジング、カスタム Skills/MCP の呼び出しを行うことができます。

主な機能

領域	提供内容
エージェントファーストワークフロー	Claude エージェントの作成、編集、バージョン管理、復元; カスタムプロンプト、Skills、MCP、プラグインを添付。
ワークスペース	分離されたファイルシステムディレクトリ; ホストマシン（管理者）または非 root Docker コンテナ（一般ユーザー）で実行可能。
マルチチャネルアクセス	Feishu、Telegram、QQ、DingTalk、WeChat、Enterprise WeChat、Discord、WhatsApp および Web PWA 向けの統合メッセージング。
プロバイダー管理	複数の Anthropic または互換性のある Claude エンドポイントを構成; ロードバランシング（ラウンドロビン、重み付け、フェイルオーバー）、ヘルスチェック、セッションスティッキーなルーティング。
スケジューリング	Cron 形式、固定間隔、または一回限りのタスクでエージェントまたはシェルスクリプトを実行。冪等な実行 ID と再試行可能な通知付き。
メモリとファイル処理	ワークスペーススコープのメモリストア、バージョン管理されたファイル編集、CAS スタイルの更新、検索、ターミナルアクセス。
使用量と請求	エージェント、ワークスペース、モデルごとのトークンレベルの会計; CSV エクスポート、クォータ、サブスクリプション、リデンプションコードサポート。
運用とセキュリティ	RBAC、招待制登録、監査ログ、Docker イメージ管理、バックアップ/リストア、シークレットの暗号化保存。
クライアントエクスペリエンス	リアルタイムストリーミング出力、ツールトレースの可視化、Markdown/Mermaid/KaTeX レンダリング、レスポンシブ UI と PWA サポート。

誰が使うか

公開チャット API ではなく、プライベートで制御可能な Claude Code 環境を希望するチーム。
内部チャットツールからトリガーできる AI 駆動の自動化（コードレビュー、CI 支援、データ抽出）を実行する必要がある企業。
Claude エージェントを試しながら、実行を Docker コンテナ内に分離しておきたい開発者。
きめ細かい権限制御、使用量追跡、スタック全体のオンプレミスホスティングを必要とする組織。

セットアップ（クイックステップ）

クローンと起動 – git clone https://github.com/riba2534/happyclaw.git && cd happyclaw && make start。
Web UI を http://localhost:3000 で開き、ウィザードに従って管理者アカウントを作成します。
設定 → モデルとプロバイダー で Anthropic（または互換性のある）Claude プロバイダーを追加します。
（オプション）設定 → メッセージチャネル で 1 つ以上の IM チャネルを接続します。
ワークスペース を作成し、ホスト（管理者）または コンテナ（一般ユーザー）の実行モードを選択します。
エージェント（Claude Code）を構築 – 名前、アバター、プロンプトを設定し、必要な Skills や MCP を添付します。
セッション を開く（またはチャネルをバインド）してチャットを開始 – エージェントはファイルの読み書き、シェルコマンドの実行、Web ブラウジングなどができます。

アーキテクチャ概要

Web/PWA  →  HappyClaw Node サービス (Hono, WebSocket, SQLite)
   │                │
   ├─ Auth/RBAC    ├─ Router & Scheduler
   │                │
   └─ Provider pool (Claude endpoints)
        │
        ├─ Host Runner (direct CLI)
        └─ Docker Agent Runner (isolated containers)
                │
                └─ Claude Agent SDK + Claude Code CLI

コアサービスは認証、メッセージルーティング、タスクスケジューリング、永続化を処理します。エージェントの実行は、ホストマシン（管理者承認済みディレクトリ）またはロックされたバージョンの Claude Code ランタイムを実行する Docker コンテナに委任されます。

ライセンスとコミュニティ

ライセンス: MIT（LICENSE を参照）。
スター: ⭐ — リポジトリには GitHub スターのバッジが表示されます。
コントリビューション: ガイドラインは README のコントリビューションセクションにあります; イシューやプルリクエストを歓迎します。
ドキュメント: API リファレンス、ランタイムアーキテクチャ、ACL マトリクス、デプロイガイドは docs/ フォルダおよび公式サイト https://happyclaw.cc/ にあります。

上記の情報はすべてプロジェクトの README から直接取得しています; 追加の機能は推測していません。

riba2534/happyclaw