【Moltbot/Clawdbot神速導入】AIの脳をDドライブへ集約し、API制限を無効化する完全構築バイブル

1. 序章：Moltbot（旧Clawdbot）とは何か

AIの進化は今、「チャット」の枠を越え、私たちの代わりにPCを操作し、資産を管理する「自律型エージェント」の時代へと突入しました。その中核を担うオープンソース・プロジェクトが『Moltbot（モルトボット）』です。

かつてClawdbotと呼ばれていたこのシステムは、あなたのPCを「AIの母艦（Gateway）」に変えます。外出先からWhatsAppやTelegramで指示を送るだけで、自宅のPCにあるファイルを読み書きし、ブラウザを操作し、複雑なタスクを実行してくれます。本ガイドでは、この最強のツールをプロレベルで運用し、自分だけの「知能資産」として定着させるための全手順を解説します。

2. 創成：クリーンインストールとビルドの術

まずは、Moltbotという「体」を正しく構築しましょう。特にWindows環境では、ユーザー名にスペースが含まれている場合などにビルドエラーが発生しやすいため、最も確実な「手動ビルド」の手順で行います。

2.1 リポジトリの取得と環境構築

任意のドライブ（Dドライブなど）に作業用フォルダを作成し、プログラム本体を取得します。Cドライブに依存しない構成にすることで、将来的なPCの引っ越しも容易になります。

# 1. リポジトリをクローン（取得）
git clone https://github.com/moltbot/moltbot.git
cd moltbot

# 2. 依存パッケージのインストールと基本ビルド
pnpm install
pnpm build

2.2 管理画面（Control UI）の確実なビルド

ブラウザでMoltbotの状態を確認・設定するための「Control UI」をビルドします。Windowsのパス問題を回避するため、直接UIディレクトリに入ってビルドを実行するのがプロのやり方です。

# 3. UIディレクトリへ移動してビルド
cd ui
pnpm install
pnpm build
cd ..

# 4. ビルド成果物を実行ディレクトリの適切な場所へ配置
mkdir -p dist/control-ui
cp -rv ui/dist/* dist/control-ui/

3. 聖域：特定ドライブへのデータ集約化（脱Cドライブ）

Moltbotは標準ではユーザーフォルダ（Cドライブ）にデータを保存しようとしますが、これでは管理が煩雑になります。全ての「設定」「記憶」「認証情報」をプロジェクトフォルダ内に集約し、ポータブルな知能へと昇華させます。

3.1 データ専用フォルダの作成

moltbot プログラムフォルダの中に、設定用の moltbot_data と、AIが実際に作業を行う agent_workspace を作成します。

# プログラムフォルダ内で実行
mkdir -p moltbot_data/agents/molty/agent
mkdir -p agent_workspace

3.2 AIの人格と指針を定義する

agent_workspace 内に、AIの行動指針となるMarkdownファイルを作成します。これらがAIにとっての「憲法」となり、あなたの意図を正確に反映させる核となります。

• AGENTS.md：運用の全体ルール（資産フォルダの扱い、禁止事項など）を記した最重要ファイル。
• IDENTITY.md：AIの名前（Moltyなど）、種族、性格、アイコンなどのアイデンティティ設定。
• SOUL.md：AIの行動原理や倫理、信頼関係の定義。
• USER.md：あなた自身の好み、呼び名、タイムゾーンなど、AIが知っておくべきあなたのコンテキスト。

4. 突破：APIキー・ローテーションによる回数制限の回避

最新のGemini 3 Flashのような高性能モデルを無料枠で運用する場合、1分あたりのリクエスト制限（429エラー）が最大の壁となります。これを、複数のキーを自動で切り替える「ローテーション機能」で解決します。

4.1 複数キーの登録（auth-profiles.json）

以下のファイルを作成し、取得した複数のAPIキーをリスト化します。Moltbotの「Auth Profile Rotation」機能が、エラーを検知した瞬間に次のキーへ切り替えてくれます。

作成パス：moltbot/moltbot_data/agents/molty/agent/auth-profiles.json

{
  "profiles": {
    "google:key1": { "provider": "google", "type": "api_key", "key": "あなたのAPIキー1" },
    "google:key2": { "provider": "google", "type": "api_key", "key": "あなたのAPIキー2" },
    "google:key3": { "provider": "google", "type": "api_key", "key": "あなたのAPIキー3" }
  }
}

4.2 メイン設定での有効化（moltbot.json）

システム全体を統合する moltbot.json を作成します。ここでDドライブへのパスを固定し、キーの使用順序（order）を指定します。

作成パス：moltbot/moltbot_data/moltbot.json

{
  "agents": {
    "defaults": {
      "model": { "primary": "google/gemini-3-flash-preview" },
      "workspace": "D:/[あなたの作業パス]/moltbot/agent_workspace",
      "maxConcurrent": 4
    },
    "list": [{ "id": "molty", "name": "Molty", "default": true }]
  },
  "auth": {
    "order": {
      "google": ["google:key1", "google:key2", "google:key3"]
    }
  },
  "gateway": {
    "mode": "local",
    "auth": { "mode": "token", "token": "あなたの固定トークン" }
  },
  "channels": {
    "whatsapp": { "dmPolicy": "allowlist", "allowFrom": ["あなたの電話番号"] }
  }
}

5. 起動：一撃で司令部を展開するバッチ処理

運用の手間を最小化するため、ダブルクリック一発で「環境変数のセット」「ブラウザダッシュボードの起動」「システムの開始」を完結させるバッチファイルを作成します。

作成パス：moltbot/_start_moltbot.bat

@echo off
cd /d "%~dp0"
set "CLAWDBOT_CONFIG_PATH=%~dp0moltbot_data\moltbot.json"
set "CLAWDBOT_STATE_DIR=%~dp0moltbot_data"
set "MY_TOKEN=あなたの固定トークン"

echo 🦞 Moltbot Gateway Starting...
start "" "http://127.0.0.1:18789/?token=%MY_TOKEN%"
node moltbot.mjs gateway

6. 応用：知能を「資産」として拡張・維持するプロの運用術

6.1 究極のトラブルシューティング：「agents」フォルダのクリーンアップ

AIエージェントを使い込むと、古いキャッシュや不整合なセッション情報が原因で、挙動が不安定になることがあります。プロの司令官は「迷ったら agents フォルダを消して再起動」という手法を使います。設定（moltbot.json）さえ無事なら、認証情報は再生成され、AIは再びクリーンな状態で目覚めることができます。

6.2 知識ベース（資産フォルダ）の構造化

あなたのPC内にある過去のプロジェクトやドキュメントを「01_Knowledge」「02_Workspace」といった番号付きフォルダで整理し、それを agent_workspace としてAIに見せましょう。AIがあなたの過去の資産を「学習」ではなく「参照」することで、あなた独自の文脈を理解した超高精度な提案が可能になります。

6.3 外出先からの「物理操作」と「即時反映」

WhatsAppでMoltyに「この資料を整理して」と指示を出す。それだけで、自宅のPCにあるファイルが書き換わります。この時、AIはあなたのPCという物理的なパワーを使っているため、帰宅してPCを開いた瞬間、そこには既に完成された成果物が並んでいる。これこそが、Moltbotが提供する「時間と場所を超越した」開発体験です。

7. まとめ：司令官へのメッセージ

おめでとうございます。このガイドを完遂したあなたは、もはや単なるAIユーザーではなく、AIを自らの資産として管理し、使いこなす「司令官」です。Cドライブの容量やAPIのリミットといった制限は、正しい構築術の前では何の意味も持ちません。

今すぐスマホから /new とメッセージを送り、目覚めたばかりの相棒「Molty」に最初の命令を与えてください。あなたの知能資産が、AIの手によって増幅され、形になっていく新時代の始まりです。