開始する前に:構築するものを理解する
ほとんどのAIインストールガイドは、ソフトウェアをブラックボックスとして扱います:ダウンロード、インストール、忘れる。clawbotは異なります。なぜなら、アプリをインストールするのではなく、インフラを確立するからです。これを、メッセージを管理する代わりにデジタル環境を真にコントロールできるAIを調整する、独自のプライベートメールサーバーのセットアップと考えてください。
このガイドでは、各ステップが何をするか、そしてなぜそれが重要なのかを説明します。アーキテクチャを理解することで、トラブルシューティングが直感的になり、カスタマイズが簡単になります。
30分後に得られるもの
- デバイス上で永続的に動作し、すべてのAIアクティビティを調整するGatewayサービス
- 選択したAIモデル(Claude、GPT-4、または無料のローカルOllama)への接続
- AIにリンクされた少なくとも1つのメッセージングチャネル(WhatsApp、Telegramなど)
- 真のシステムコントロールを実証する機能的な自動化
- セットアップの拡張、カスタマイズ、トラブルシューティング方法の理解
前提条件:実際に必要なもの
何かをダウンロードする前に、システムがこれらの要件を満たしていることを確認してください。それぞれが特定の目的を果たします:
ハードウェア要件
- オペレーティングシステム: macOS 11+、Linux (Ubuntu 20.04+、Debian 11+)、またはWSL2搭載のWindows 10+
- RAM: 最小2GB利用可能(よりスムーズな動作には4GB推奨)
- ディスク容量: コアインストール用に500MB、AIモデルキャッシュ用のスペース
- ネットワーク: AI API呼び出し用の安定したインターネット接続(ローカルOllamaを使用しない限り)
ソフトウェア依存関係
clawbotはNode.js 22以上が必要です。なぜこの特定のバージョン? 新しいNode.jsバージョンには、clawbotのリアルタイム通信が依存する重要なパフォーマンス改善とセキュリティパッチが含まれています。インストーラーは通常これを処理しますが、手動インストールではプレインストールが必要です。
AIモデルアクセス(いずれか1つを選択)
コスト対効果分析:どのAIモデルを選ぶべきか?
オプション1: Anthropic Claude (ほとんどのユーザーに推奨)
- コスト:典型的な個人使用で月額約20-40ドル
- 利点:優れた推論、強力なセキュリティ意識、長いコンテキストウィンドウ
- APIキー取得: console.anthropic.com
オプション2: OpenAI GPT-4
- コスト:使用パターンに応じて月額約25-50ドル
- 利点:広範な知識ベース、クリエイティブタスクに優れている
- APIキー取得: platform.openai.com
オプション3: ローカルOllamaモデル (完全無料)
- コスト:0ドル(完全にハードウェア上で実行)
- 利点:継続的なコストなし、完全なプライバシー、オフライン動作
- 欠点:応答が遅い、より強力なハードウェアが必要(8GB以上のRAM推奨)
- セットアップ: ollama.ai
ステップ1:プラットフォームに適したパッケージをダウンロード
clawbotは、必要なすべてをバンドルしたプラットフォーム固有のインストーラーを配布しています。なぜ複数の形式? オペレーティングシステムごとにバックグラウンドサービスの処理方法が異なるため、インストーラーがこれらを正しく設定します。
macOSインストール
最もシンプルな体験のためにDMGインストーラーをダウンロードします:
curl -fsSL https://github.com/steipete/clawbot/releases/download/v2026.1.23/clawbot-2026.1.23.dmg -o clawbot.dmg
またはGitHub Releasesから直接ダウンロードします。
インストーラーが実行する内容:
- Gatewayサービスを
/Applications/clawbot.appにインストール ~/.clawbot/に設定ディレクトリを作成- 自動化機能のためのシステム権限を設定
- オプションでスタートアップ時の起動を設定(推奨)
Linuxインストール
npm経由でインストール(推奨)またはDocker:
npm install -g clawbot@latest
次に設定を初期化:
clawbot init
systemdサービスとしてセットアップ(オプションですが推奨):
clawbot install-service
これにより、clawbotが起動時に自動的に開始され、クラッシュした場合は再起動されます。
Windowsインストール(WSL2)
WindowsにはWSL2(Windows Subsystem for Linux)が必要です。インストールされていない場合:
wsl --install
次に、WSL2 Ubuntu環境内でLinuxの手順に従います。
⚠️ Windowsネイティブサポート
ネイティブWindowsサポート(WSL2なし)は実験的です。WSL2は、Node.jsシステム統合とシェルコマンド実行との互換性が優れています。
Dockerデプロイメント
クロスプラットフォーム互換性またはサーバーデプロイメントの場合:
docker pull ghcr.io/steipete/clawbot:latest
永続的な設定で実行:
docker run -d \
--name clawbot \
-v ~/.clawbot:/root/.clawbot \
-p 18789:18789 \
ghcr.io/steipete/clawbot:latest
Dockerフラグの理解:
-d: コンテナをバックグラウンドで実行(デーモンモード)-v ~/.clawbot:/root/.clawbot: 再起動間で設定を永続化-p 18789:18789: ローカルクライアント用にGateway WebSocketポートを公開
ステップ2:Gatewayをインストールして起動
Gatewayはclawbotのコアです—メッセージングプラットフォーム、AIモデル、システム間のすべての通信を管理する永続的なサービスです。中枢神経系と考えてください:チャネルがGatewayにメッセージを送信し、適切なAIモデルにルーティングし、応答を受け取り、配信します。
インストーラーを実行
macOS: ダウンロードしたDMGを開き、clawbotをアプリケーションにドラッグします。起動します。
Linux/WSL: npmインストール後、Gatewayを開始します:
clawbot gateway start
実行中であることを確認:
clawbot gateway status
次のように表示されるはずです: Gateway is running on ws://127.0.0.1:18789
🔍 舞台裏で何が起こっているか
Gatewayは、ポート18789(カスタマイズ可能)にWebSocketサーバーを作成します。このローカル専用サーバーは次のものからの接続を受け入れます:
- チャネルプラグイン (WhatsApp、Telegramなど)がユーザーメッセージを転送
- ノードクライアント (モバイルアプリ、Webインターフェース)が直接インタラクション
- スキルとツール が機能を拡張
すべての通信は、明示的にリモートアクセスを設定しない限り(高度なガイドで説明)、マシン上にとどまります。
ステップ3:AIブレインを接続
Gatewayが実行されている状態で、応答を生成するAIモデルが必要です。このステップでは、使用するモデルを設定し、APIアクセスを認証します。
AIプロバイダーを設定
設定ファイルを開きます:
clawbot config edit
または手動で~/.clawbot/clawbot.jsonを編集します。API資格情報を追加:
{
"aiProviders": {
"anthropic": {
"apiKey": "sk-ant-your-api-key-here",
"model": "claude-3-5-sonnet-20250219",
"enabled": true
}
},
"defaultProvider": "anthropic"
}
代わりにローカルOllamaの場合:
{
"aiProviders": {
"ollama": {
"baseURL": "http://localhost:11434",
"model": "llama3.1:8b",
"enabled": true
}
},
"defaultProvider": "ollama"
}
セキュリティベストプラクティス: APIキー管理
APIキーを含むclawbot.jsonをバージョン管理にコミットしないでください。本番環境デプロイメントには環境変数の使用を検討してください:
export ANTHROPIC_API_KEY="your-key-here"
clawbotは、存在する場合は環境変数から自動的に読み取ります。
ステップ4:通信チャネルをリンク
チャネルはAIとやり取りする方法です—モバイル用のWhatsApp、デスクトップ用のTelegram、チームコラボレーション用のDiscord。各チャネルはGatewayに独立して接続し、clawbotはそれらすべてにわたって統一された会話履歴を維持します。
最初のチャネルを接続:WhatsAppの例
WhatsAppチャネルプラグインをインストール:
clawbot channel add whatsapp
これにより対話型セットアップが起動します:
- ターミナルにQRコードが表示されます
- 携帯電話でWhatsAppを開く → 設定 → リンク済みデバイス → デバイスをリンク
- QRコードをスキャン
- clawbotが接続を確認し、セッション資格情報を保存します
仕組み: clawbotはWhatsApp Webプロトコル(Baileysライブラリ経由)を使用して永続的な接続を確立します。携帯電話は「プライマリ」デバイスのままで、clawbotはリンクされたセカンダリデバイスとして機能します—ブラウザのWhatsApp Webと同じです。
⚠️ WhatsAppアカウントの安全性
WhatsAppの利用規約はボット使用を禁止しています。clawbotはレート制限と人間のような動作パターンを実装していますが、プライマリの個人WhatsAppアカウントではなく、セカンダリ電話番号の使用をお勧めします。検討してください:
- Google Voiceまたは類似の仮想番号を取得
- 積極的に使用していない古いSIMカードを使用
- 代わりにTelegramを試す(公式にボットをサポート)
代替チャネル
各チャネルには独自のセットアップ要件があります。人気のオプション:
Telegram (初心者に推奨):
clawbot channel add telegram
プロンプトに従って電話番号で認証します。Telegramは公式にボットをサポートしているため、これが最も安全なオプションです。
Discord (チームに最適):
clawbot channel add discord
discord.com/developersでDiscordボットアプリケーションを作成する必要があります。プロンプトが表示されたらボットトークンをコピーします。
完全なチャネルドキュメント: docs.clawd.bot/channels
ステップ5:最初の自律タスクを実行
すべてが設定されたら、clawbotがシステムを真にコントロールできることを確認しましょう—単にテキストで応答するだけではありません。
システム統合をテスト
接続したメッセージングチャネル(WhatsApp、Telegramなど)を開き、次のメッセージを送信します:
「Documents フォルダに今日の日付と励ましの言葉を含む test.txt というテキストファイルを作成してください。」
何が起こるべきか:
- clawbotがチャネル経由でメッセージを受信
- Gatewayが設定されたAIモデルにルーティング
- AIがシェルコマンドを含む応答計画を生成
- clawbotが実行:
echo "..." > ~/Documents/test.txt - 確認を受信:「test.txtを作成しました...」
- Documentsフォルダを確認—ファイルが存在します
🎉 真のAI自動化を実証しました
clawbotをChatGPTやSiriと区別するもの:ファイルの作成方法を教えるだけでなく、実際に作成しました。この同じ能力は次のように拡張されます:
- カレンダーの管理と会議の招待送信
- ログファイルの監視とエラーのアラート
- APIからのデータ取得とレポート生成
- Home Assistantを介したスマートホームデバイスの制御
- 開発ワークフロー(テスト、ビルド、デプロイ)の実行
次に構築するもの
あなたのAIインフラは稼働中です。能力を拡張する方法は次のとおりです:
1. ClawdHubからスキルをインストール
スキルは事前構築された自動化モジュールです。マーケットプレイスを閲覧:
clawbot skills browse
人気のスタータースキル:
- google-calendar:自然言語カレンダー管理
- home-assistant:スマートホームコントロール統合
- github-assistant:リポジトリ管理とPRレビュー
- daily-briefing:カレンダー、天気、ニュースの朝のサマリー
2. カスタム自動化を作成
スキルはSKILL.mdファイルを含むフォルダです。独自のものを作成:
mkdir -p ~/.clawbot/skills/my-automation
echo "# My Custom Skill" > ~/.clawbot/skills/my-automation/SKILL.md
完全ガイド: docs.clawd.bot/skills/creating
3. プロアクティブな動作を設定
従来のAIとは異なり、clawbotは連絡を開始できます。ハートビート監視を有効化:
clawbot config set heartbeat.enabled true
clawbot config set heartbeat.interval "every day at 8am"
これで、clawbotは尋ねられなくてもプロアクティブに朝のブリーフィングを送信します。
4. クラウドへのデプロイ(オプション)
ラップトップでclawbotを実行することは機能しますが、クラウドデプロイメントは24時間365日の可用性を保証します。利用可能なガイド:
- DigitalOcean Droplets(月額6ドル)
- AWS EC2無料利用枠(12か月無料)
- Hetzner Cloud(月額4ユーロ)
- ホームRaspberry Pi(一回限りのハードウェアコスト)
よくある問題と解決策
Gatewayが起動しない
症状: Error: EADDRINUSE: address already in use
原因: 別のプロセスがポート18789を使用しています。
解決策: 競合するプロセスを見つけて終了します:
lsof -ti:18789 | xargs kill -9
または、clawbot.jsonでclawbotが別のポートを使用するように設定します。
AIモデルがエラーを返す
症状: 「API authentication failed」または「Invalid model specified」
原因: 設定のAPIキーまたはモデル名が正しくありません。
解決策: APIキーが有効であることを確認します:
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: YOUR_KEY" \
-H "anthropic-version: 2023-06-01"
プロバイダーのドキュメント(Anthropic、OpenAI)でモデル名を確認してください。
WhatsAppが頻繁に切断される
症状: 数日ごとにQRコード認証が必要です。
原因: セッション資格情報が正しく永続化されていません。
解決策: ~/.clawbot/channels/whatsapp/に書き込み権限があることを確認します:
chmod 700 ~/.clawbot/channels/whatsapp/
また、携帯電話がインターネットに接続されたままであることを確認してください—WhatsAppはプライマリデバイスがオンラインである必要があります。
独自のAIインフラを運用中
構築したものは単なるチャットボットではありません—最前線のAIモデルの知性とローカルシステムコントロールの能力を組み合わせたパーソナル自動化プラットフォームです。AIができることを制約するクラウドサービスとは異なり、clawbotインストールはあなたがデジタル環境に対して持つのと同じアクセス権を持っています。
この力には責任が伴います:clawbotはあなたが承認する任意のコマンドを実行できます。サンドボックスと権限システムは偶発的な損害から保護しますが、最終的にはAIに有意義なコントロールを付与しています。シンプルな自動化から始めて、決定がどのように行われるかを理解し、信頼を築きながら徐々に機能を拡張してください。