概要

Clawdbotは、ローカル実行型のパーソナルAIアシスタント。 主要なメッセージングサービスと連携し、高速かつ常時稼働。 セットアップはCLIウィザード推奨、Node.jsベースでクロスプラットフォーム対応。 モデル選択はAnthropic Pro/Max + Opus 4.5推奨。 セキュリティや拡張性にも配慮した設計。

Clawdbotの特徴と概要

• Clawdbot は自身のデバイス上で動作する パーソナルAIアシスタント。
• WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat など多様なチャネルに対応。
• BlueBubbles、Matrix、Zalo、Zalo Personal など拡張チャネルにも接続可能。
• macOS/iOS/Android で音声認識・応答機能、 ライブCanvas 操作機能を搭載。
• Gateway は制御プレーンであり、実際のプロダクトはAIアシスタント本体。
• ローカルファースト設計 で、 高速・常時稼働 を実現。
• CLIウィザード（clawdbot onboard） による簡単セットアップ。
• npm、pnpm、bun でインストール・管理が可能。
• Node.js v22以上 が必要条件。

インストールとセットアップ

• 推奨インストール方法：
  • npm install -g clawdbot@latest
  • または pnpm add -g clawdbot@latest
• ウィザード起動例：
  • clawdbot onboard --install-daemon
• Gatewayデーモンは launchd/systemd で常駐化。
• CLIウィザード は macOS、Linux、Windows（WSL2経由） で動作。
• 新規インストール 時は「Getting started」ガイド参照。

サブスクリプション・モデル

• Anthropic（Claude Pro/Max）、 OpenAI（ChatGPT/Codex） など主要モデルと連携。
• Anthropic Pro/Max + Opus 4.5 推奨（長文コンテキスト・プロンプトインジェクション耐性強化）。
• モデル認証プロファイルのローテーション ・フェイルオーバー機能。

クイックスタート

• Node.js v22以上 必須。
• 主要手順：
  • clawdbot onboard --install-daemon
  • clawdbot gateway --port 18789 --verbose
  • メッセージ送信例：clawdbot message send --to +1234567890 --message "Hello from Clawdbot"
  • アシスタント利用例：clawdbot agent --message "Ship checklist" --thinking high
• WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/Microsoft Teams/Matrix/Zalo/Zalo Personal/WebChat への返信も可能。

開発・アップデート

• 安定版・ベータ版・開発版 のチャンネル切替が可能。
  • 例：clawdbot update --channel stable|beta|dev
• pnpm推奨 でソースビルド対応。
• TypeScript のホットリロード開発ループ（pnpm gateway:watch）もサポート。

セキュリティ設計

• DM（ダイレクトメッセージ） はデフォルトでペアリングコード認証。
• 未承認送信者はメッセージ処理不可、明示的な承認が必要。
• 危険なDMポリシー はclawdbot doctorで検出。
• パブリックDM は明示的なオプトイン設定必須。

主要機能・ハイライト

• ローカルファーストGateway ：セッション・チャネル・ツール・イベントを一元管理。
• マルチチャネル受信箱 ：主要チャネルを一括管理。
• マルチエージェントルーティング ：チャネル・アカウントごとに独立エージェント割り当て。
• 音声起動・トークモード ：macOS/iOS/Androidで常時音声会話。
• ライブCanvas ：AIエージェントによるビジュアルワークスペース。
• 豊富なツール ：ブラウザ制御、ノード、cron、セッション、Discord/Slackアクション。
• macOS/iOS/Android用コンパニオンアプリ も提供。

コアプラットフォーム構成

• Gateway ：WebSocket制御プレーン、セッション・プレゼンス・設定・cron・Webhook・Canvasホスト。
• CLI ：gateway、agent、send、wizard、doctorコマンド。
• Piエージェント ：RPCモードでツールストリーミング対応。
• セッションモデル ：個別・グループチャット、アクティベーション・キュー・リプライバックなど多様な運用モード。
• メディアパイプライン ：画像・音声・動画処理、トランスクリプション、サイズ制限、テンポラリファイル管理。

チャネル・アプリ・ノード

• 主要チャネル ：WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、Microsoft Teams、Matrix、Zalo、WebChatなど。
• macOSアプリ ：メニューバー制御、音声起動、WebChat、デバッグ、リモートゲートウェイ制御。
• iOS/Androidノード ：Canvas、音声起動、カメラ、画面録画、Bonjourペアリング、SMS（Androidのみ）。
• ノード機能 ：カメラ撮影・録画、画面収録、位置情報取得、通知。

ツール・自動化・スキル

• ブラウザ制御 ：Chrome/ChromiumをCDP経由で操作、スナップショット・アップロード対応。
• Canvas ：A2UIによるビジュアルワークスペース。
• ノード ：カメラ・画面・位置・通知操作。
• cron・ウェイクアップ・Webhook・Gmail Pub/Sub 対応。
• スキルプラットフォーム ：バンドル、管理、ワークスペーススキルのインストール・UI制御。

運用・セキュリティ・リモートアクセス

• Tailscale Serve/Funnel やSSHトンネルでリモートアクセス対応。
• Nixモード・Dockerインストール もサポート。
• ノード経由でのローカルアクション 実行（system.run、カメラ、画面録画、通知など）。
• セッション間連携ツール ：sessions_list、sessions_history、sessions_sendでエージェント間連携。

チャットコマンド・管理

• 主要チャットコマンド （WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat対応）：
  • /status：セッション状態表示
  • /newまたは/reset：セッションリセット
  • /compact：セッションコンテキスト要約
  • /think <level>：思考レベル設定
  • /verbose on|off：詳細表示切替
  • /usage off|tokens|full：使用状況表示
  • /restart：ゲートウェイ再起動（グループではオーナーのみ）
  • /activation mention|always：グループでのアクティベーション切替

設定ファイル例

• 最小構成例 （~/.clawdbot/clawdbot.json）：

  {
    "agent": {
      "model": "anthropic/..."
    }
  }
  

---

必要に応じ、各セクションの詳細や運用ノウハウを追加可能です。