xianyu110/clawbot

Clawdbot完整配置指南：从安装到Claude Code中转

Clawdbot とは何ですか？

Clawdbot はオープンソースで、ローカルに実行される AI アシスタントであり、Web ダッシュボードや Telegram、WhatsApp、Discord などの人気のあるメッセージングアプリを通じて、大規模言語モデルバックエンド（Anthropic Claude、OpenAI GPT、Google Gemini など）とチャットできます。すべての会話データはあなたのマシン上に保持され、任意の互換性のある API エンドポイント（オリジナルプロバイダーにリダイレクトするカスタム「プロキシ」サービスを含む）に接続できます。

コア機能

機能 あなたにとっての意味
マルチプラットフォームチャット ブラウザ UI、ターミナル UI、または Telegram/WhatsApp/Discord などの 12 以上のチャネルのボットで対話できます。
プラグイン可能なモデルバックエンド ~/.clawdbot/clawdbot.json にプロバイダーのエントリを追加するだけで、Claude、GPT‑4o、Gemini 3 Pro、またはサポートされている OpenAI/Anthropic/Google API を使用する他のモデルを選択できます。
ローカルデータストレージ 会話、セッションファイル、資格情報は ~/.clawdbot/ に保存され、第三者のサーバーに送信されません。
セルフホステッドゲートウェイ 軽量な Node.js ゲートウェイ（clawdbot gateway）が localhost:18789 で実行され、WebSocket と HTTP UI を公開しながら、インターネットからサービスを隔離します。
カスタマイズ可能なセキュリティ ゲートウェイは UI アクセス用のトークンを使用し、clawdbot security audit コマンドで危険な設定を検出できます。
CLI/TUI ツール 設定の管理、サービスの再起動、ログの表示、clawdbot tui を使ってターミナルからチャットできます。

だれが使うべきですか？

  • クラウドにコードを送信せずに、個人用の AI コーディングアシスタントを使いたい 開発者。
  • 既存のチャットツールに接続できる、共有でオンプレミスのアシスタントが必要な チーム。
  • API キーと会話ログの完全な制御を求める プライバシー志向のユーザー。

クイックスタートのスナップショット（README から）

  1. Node 22+ をインストール（nvm を使って）。
  2. Clawdbot をインストール – npm install -g clawdbot（またはワンクリックスクリプトを使用）。
  3. オンボーディングウィザードを実行 – clawdbot onboard で以下の手順を実行します：
    • セキュリティに関する免責事項に同意。
    • Anthropic モデルを選択し、setup‑token（Claude Max）または API キーを入力。
    • メッセージングチャネル（例：Telegram ボットトークン）を追加。
  4. ゲートウェイを起動 – clawdbot gateway restart。
  5. UI を開く – http://127.0.0.1:18789/ にアクセス（トークンを生成した場合は ?token=… を追加）。
  6. チャット開始！ Web UI または選択したメッセンジャーでメッセージを送信。

複数モデルでの拡張（「プロキシ」モード）

README には、3 つのプロバイダー（api‑proxy‑gpt、api‑proxy‑claude、api‑proxy‑google）を追加する具体的な JSON スニペットが示されています。各プロバイダーは以下の項目を定義します：

  • baseUrl – あなたが支払いを行うプロキシエンドポイント。
  • apiKey – そのエンドポイント用のシークレット。
  • api – 使用するベンダーのリクエストフォーマット（openai‑completions、anthropic‑messages、google‑generative‑ai）。
  • models – 各モデル（ID、名前、コンテキスト窓、トークン制限など）を記述する配列。

~/.clawdbot/clawdbot.json を編集した後、auth‑profiles.json にも対応するエントリを追加し、ゲートウェイを再起動する必要があります。

一般的な落とし穴と解決策（要約）

  • Node バージョンが低すぎる – Clawdbot は Node ≥ 22 を必要とします。nvm を使ってアップグレードしてください。
  • 環境変数が無視される – カスタム API URL は ANTHROPIC_BASE_URL ではなく、JSON 設定ファイルで設定する必要があります。
  • models 配列が欠落している – 設定検証は models フィールドのないプロバイダーを拒否します。まだモデルがない場合は空の配列を追加してください。
  • Telegram ボットがクラッシュする – 調査中はチャネルを無効化（clawdbot config set channels.telegram.enabled false）してください。
  • User-Agent が必要 – 一部のプロキシサービスは、モデル定義内で User-Agent ヘッダーを追加しないとリクエストを拒否します。
  • 変更が反映されない – 設定ファイルを編集した後は、必ず clawdbot gateway restart を実行してください。

一般的に使うコマンド

# サービス制御
clawdbot gateway restart          # 設定変更を適用
clawdbot channels status          # ヘルスチェック

# 設定
clawdbot configure                # インタラクティブエディタ
clawdbot config set gateway.mode local
clawdbot config set channels.telegram.enabled false

# ディアグノスティクスとログ
clawdbot doctor                   # 自動チェックを実行
clawdbot doctor --fix            # 自動修復を試みる
tail -f ~/.clawdbot/logs/gateway.log

# UI ショートカット
clawdbot dashboard                # ブラウザ UI を開く
clawdbot tui                      # ターミナルチャット UI

ファイルの配置場所

~/.clawdbot/
├─ clawdbot.json          # 主要設定
├─ credentials/           # API キー（Git にコミットしない）
├─ sessions/              # 会話履歴
├─ logs/
│  ├─ gateway.log
│  └─ gateway.err.log
└─ agents/main/...        # エージェントごとのワークスペース

セキュリティのベストプラクティス（ガイドから）

  • API キーをバージョン管理に含めない。
  • 定期的にキーをローテーションする。
  • UI アクセスにはゲートウェイトークンを使用し、定期的に変更する。
  • VPN/Tailscale を明示的に使用しない限り、ゲートウェイを localhost にバインドして実行する。
  • tar -czf backup‑$(date +%F).tar.gz ~/.clawdbot/ で ~/.clawdbot/（設定 + セッション）をバックアップする。

まとめ

Clawdbot は、一元化されたローカル保存設定を通じて、Claude、GPT、Gemini などの主要 LLM プロバイダーを接続できる、完全機能のセルフホステッド AI アシスタントプラットフォームです。README には、ステップバイステップのインストール手順、詳細な JSON ベースのモデルプロキシ設定、徹底的なトラブルシューティングガイドが含まれており、プライベートで拡張可能な AI チャットインターフェースを求める開発者にとって実用的なツールです。

関連

  • プロジェクト
    crabwise-ai/crabwalk

    Crabwalk は、WhatsApp、Telegram、Discord、Slack 上での OpenClaw AI エージェントの活動を可視化するリアルタイム Web UI です。OpenClaw ゲートウェイから WebSocket でイベントをストリーミングし、ライブのセッションノードグラフを表示し、ツール呼び出しを検査でき、Docker、CLI、ソースインストールでのデプロイをサポートします。

  • プロジェクト
    Spr-Aachen/Easy-Voice-Toolkit

    Easy Voice Toolkit は、オープンソースの音声モデル（Whisper、GPT-SoVITS）を GUI/Colab ワークフローに統合し、音声のクリーニング、文字起こし、音声変換データセットの構築、カスタム音声モデルのトレーニング、変換音声の生成を行います。すぐに実行できる Windows ポータブルパッケージと Colab ノートブックを提供し、開発者向けのインストールガイドも備えています。このプロジェクトは学術利用のみを目的としており、将来の LLM チャットボット統合と Linux サポートを計画しています。

  • プロジェクト
    Aethena-Lab/Z3r0

    Z3r0は、React UI、FastAPIコントロールプレーン、LightRAGリトリーバルを備えたマルチエージェントランタイム、およびDockerサンドボックス実行を統合したAIネイティブ赤チームワークベンチです。すべての操作は改ざん不可能な証拠として記録され、再実行可能なタイムラインを提供するため、承認されたペネトレーションテストは監査可能かつ共同作業が可能になります。

  • プロジェクト
    Deng-m1/MaliangAINovalWriter

    Maliang AI Novel Writer (AINoval) は、中国のWeb小説作家がAIの支援を受けて長編小説を書けるオープンソースのウェブプラットフォームです。Flutter-Webによる豊富なテキストエディタ、階層的なコンテンツ管理、AI駆動のアウトライン/シーン生成、構造化された世界観ツリー、プロンプト/プリセット管理、ユーザー、モデル、コスト、コンテンツモデレーションを管理するフル機能の管理コンソールを統合しています。バックエンドは、LangChain4jを用いたLLMオーケストレーションのためのSpring Boot 3（Java 21）、MongoDBによるストレージ、Chromaによるベクトル埋め込みを採用。1つのDocker-Composeファイルでデプロイ可能。その後、提供されたスクリプトで管理者アカウントを作成します。個人作家、執筆チーム、プラットフォーム運営者にとって、AI強化された小説作成と堅牢な運用ツールを必要とする方に最適です。