🦞 ClawBridge ^Beta

OpenClaw を世界中の無料 / 低コスト AI モデルに接続する
非公式ブリッジサーバ

_{OpenAI 互換 API で、複数の AI プロバイダを 1 つに統合}

---

🧭 ClawBridge とは？

ClawBridge は
OpenClaw をフロントエンドとして利用し、
複数の 無料 / 低コスト AI プロバイダ を束ねる
OpenAI 互換 API ブリッジサーバです。

OpenClaw からのリクエストを受け取り、以下のバックエンドへ中継します：

• Pollinations AI
• G4F（GPT4Free）
• Gemini / Groq / Puter など

🔁 OpenClaw 側からは
**「1 つの OpenAI 互換サーバ」**として見えるため、
既存構成をほぼ変更せずに利用できます。

---

✨ 主な特徴

• 🦞 OpenClaw 特化設計
  OpenClaw との連携を前提に最適化されたブリッジ
• 💸 無料で即スタート
  Pollinations / G4F 対応、公式 API キー不要
• 🔁 OpenAI 互換 API
  /v1/chat/completions / /v1/models に対応
• 🔌 マルチプロバイダ統合
  複数 AI バックエンドを単一エンドポイントで管理
• 🛠 擬似ツールコール対応
  ツール非対応モデルにもプロンプト注入で対応
• 📊 Web 管理 UI 搭載
  ログ確認・疎通テスト・簡易デバッグが可能

---

📚 ドキュメント

詳細は docs/ 以下を参照してください：

• 📦 セットアップガイド
• 🤖 モデル & プロバイダ一覧
• 🧩 OpenClaw での使い方
• ⚙️ 仕組みとアーキテクチャ
• 🏗 内部アーキテクチャ詳細

---

🚀 インストール

1️⃣ リポジトリをクローン

git clone https://github.com/nezumi0627/ClawBridge.git
cd ClawBridge

2️⃣ セットアップ

依存関係のインストールと OpenClaw への自動登録を行います。

# 依存関係のインストール
npm install

# セットアップスクリプトの実行（OpenClaw への登録、Service 設定等）
node bin/install.js

3️⃣ 起動

新しく追加された統合コマンド clawbridge を利用するのが最も簡単です。

# 1. 本番モード (おすすめ / 高速)
clawbridge start

#| コマンド | モード | ホットリロード | 起動速度 | 内容 |
| :--- | :--- | :--- | :--- | :--- |
| `clawbridge start` | **Production** | ❌ なし | 🚀 最速 | サービス稼働用。ビルド済み UI を配信。 |
| `clawbridge dev --fast` | **Preview** | ❌ なし | ✅ 速い | 開発用ログ（DEBUG）を出力しつつ高速起動。 |
| `clawbridge dev` | **Development** | ✅ あり | ⚠️ 遅め | 開発者用。UI の変更を即座に反映（Next.js Turbo）。 |
詳細は [起動モードガイド](./docs/LAUNCH_MODES.md) を参照してください。


📖 旧来のスクリプト (`./start.sh`, `./dev.sh`) も引き続き利用可能ですが、パスの通った環境では `clawbridge` コマンドの使用を推奨します。
詳細は [起動モードガイド](./docs/LAUNCH_MODES.md) を参照してください。


---

## 📄 ライセンス

MIT License
詳細は [LICENSE](LICENSE) を参照してください。