メインコンテンツへスキップ

VPSにClawdbotをインストールする方法

BlogsClawdbotAI AssistantVPS HostingInstallation GuideLightNode約5分

VPSにClawdbotをインストールする方法

Clawdbotはオープンソースのセルフホスト型パーソナルAIアシスタントで、お気に入りのメッセージングプラットフォームに接続します。ChatGPTのようなクラウドベースのAIアシスタントとは異なり、Clawdbotは完全にあなたのインフラ上で動作するため、データとプライバシーを完全にコントロールできます。本記事では、Node.jsを使ってVPSにClawdbotをインストールする手順を案内します。VPSプロバイダーとしてはLightNodeの利用を推奨します。

Clawdbotとは？

Clawdbotは、お気に入りのアプリやメッセージングプラットフォーム内で動作する強力なパーソナルAIアシスタントです。WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Microsoft Teams、Google Chatなどに接続し、大規模言語モデルを真にパーソナルで常時利用可能なパートナーに変えます。主な特徴は以下の通りです：

  • マルチプラットフォーム対応：10以上のメッセージングプラットフォームで動作
  • 永続的なメモリ：ユーザーの好みや過去の会話を記憶
  • プロアクティブなアクション：アクション実行、リマインダー設定、通知送信が可能
  • セルフホスト型：データ所有権とプライバシーを完全に管理
  • カスタマイズ可能：スキルやツールで拡張可能
  • 常時稼働：VPSやローカルマシンで24時間365日稼働

前提条件

始める前に以下を準備してください：

  1. VPSサーバー：様々なクラウドサービスプロバイダーから選べます。パフォーマンスとグローバルカバレッジに優れたLightNodeを推奨します。
  2. 基本的なコマンドライン知識：ターミナルコマンドに慣れていると便利です。
  3. Node.jsのインストール：サーバーにNode.js 22以上がインストールされていることを確認してください。
  4. 最低システム要件：2GB RAM、1 vCPU、10GBディスク容量（本番利用では4GB RAM推奨）。

なぜLightNode VPSを推奨するのか

LightNodeはClawdbotのホスティングに最適な理由がいくつかあります：

LightNodeの主な利点

  • 手頃な価格：プランは月額7.71ドルからで、時間単位の課金も可能。長期契約なしで試せます。
  • 40以上のグローバル拠点：米国、ヨーロッパ、アジア、中東、アフリカを含む6大陸にデータセンターがあり、世界中のユーザーに低遅延を提供。
  • 高性能：NVMe SSDストレージと高周波CPUによりAIワークロードに最適なパフォーマンス。
  • 99.95%の稼働保証：信頼性の高いインフラとローカルBGPアクセスで常時稼働を実現。
  • 柔軟な課金体系：使用した分だけ支払う時間単位課金で、テストやスケールに最適。
  • 開発者フレンドリー：フルルートアクセス、即時デプロイ、LinuxとWindowsの両方をサポート。
  • 無料スナップショット：VPSごとに1回無料でスナップショット取得可能。
  • 新規ユーザーボーナス：初回チャージ時に最大15ドルの無料クレジットを獲得。

Clawdbotに推奨するLightNode構成

コンポーネント仕様月額費用
プランAgency$14.70/月
CPU2 vCPU-
RAM4GB DDR4-
ストレージ50GB NVMe SSD-
帯域幅2TB-
ロケーションシンガポール、香港、またはシリコンバレー-

この構成はClawdbotの運用に十分なリソースを提供し、利用増加に伴う拡張も可能です。

LightNodeで始める

ステップ1：VPSのセットアップ

  1. インスタンスの起動：LightNodeにサインインし、新しいVPSインスタンスを作成します。主要ユーザーに近いロケーションを選ぶと最適な遅延が得られます。グローバルアクセスには、アジアユーザー向けにシンガポールや香港、北米ユーザー向けにシリコンバレーがおすすめです。

  2. OSの選択：Ubuntu 22.04 LTS（推奨）またはUbuntu 24.04を選択してください。これらはNode.jsのサポートが優れており、広くテストされています。

  3. SSHアクセス：SSHクライアントを使ってサーバーにアクセスします：

    ssh username@your_server_ip

ステップ2：Node.jsのインストール

ClawdbotはNode.js 22以上が必要です。Ubuntuでのインストール方法は以下の通りです：

# パッケージリストの更新
sudo apt update

# NodeSourceリポジトリからNode.js 22をインストール
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# インストール確認
node --version
# v22.x.x と表示されるはずです

または、NVM（Node Version Manager）を使う方法もあります：

# NVMのインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Node.js 22のインストールと使用
nvm install 22
nvm use 22

# インストール確認
node --version

ステップ3：Clawdbotのインストール

複数のインストール方法があります。用途に合わせて選択してください。

方法1：公式インストーラースクリプト（初心者向け推奨）

インストーラースクリプトは最も簡単で依存関係も自動処理します：

# インストーラーのダウンロードと実行
curl -fsSL https://clawd.bot/install.sh | bash

このコマンドは以下を実行します：

  • OSの検出
  • Node.js 22+のインストール確認
  • npm経由でClawdbotをグローバルインストール
  • 必要なパス設定
  • doctorコマンドでインストール検証

方法2：npmグローバルインストール

npmに慣れている方はこちら：

# Clawdbotをグローバルインストール
npm install -g clawdbot@latest

# またはpnpm（高速）
pnpm add -g clawdbot@latest

# インストール確認
clawdbot --version

方法3：ソースからインストール（開発者向け）

# リポジトリをクローン
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

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

# UIのビルド
pnpm ui:build

# プロジェクトのビルド
pnpm build

# オンボーディングウィザードの実行
./dist/entry.js onboard --install-daemon

方法4：Dockerインストール（オプション）

コンテナ化したい場合：

# リポジトリをクローン
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Dockerセットアップスクリプトの実行
./docker-setup.sh

ステップ4：オンボーディングウィザードの実行

インストール後、Clawdbotの設定を行うためにオンボーディングウィザードを起動します：

# 対話式オンボーディングウィザードの開始
clawdbot onboard --install-daemon

ウィザードでは以下を案内します：

  1. ゲートウェイ設定：ローカルまたはリモートゲートウェイモードの選択とポート設定（デフォルト：18789）
  2. 認証設定：AIモデルプロバイダーの設定
    • Anthropic (Claude)：APIキーまたはOAuth（推奨）
    • OpenAI (ChatGPT/Codex)：APIキー
    • その他プロバイダー：カスタムエンドポイントとAPIキー
  3. チャネル設定：メッセージングプラットフォームの設定
    • WhatsApp：QRコードログイン
    • Telegram：@BotFatherからのボットトークン
    • Discord：Discord Developer Portalからのボットトークン
    • Slack：OAuthまたはボットトークン
  4. サービスインストール：ゲートウェイをバックグラウンドサービス（Linuxのsystemd）としてインストール
  5. エージェントのアイデンティティ：アシスタントの性格やデフォルト動作の設定

ステップ5：ゲートウェイの起動

オンボーディング完了後、ゲートウェイは自動的に起動します。状態確認は以下で行えます：

# ゲートウェイの状態確認
clawdbot gateway status

# ログの表示
clawdbot logs --follow

# ヘルスチェック
clawdbot health

サービスが起動していない場合の手動起動

# フォアグラウンドでゲートウェイ起動
clawdbot gateway --port 18789 --verbose

サービス管理

# サービス開始
systemctl --user start clawdbot-gateway.service

# サービス停止
systemctl --user stop clawdbot-gateway.service

# サービス再起動
systemctl --user restart clawdbot-gateway.service

# 起動時に自動開始設定
systemctl --user enable clawdbot-gateway.service

# サービスログの確認
journalctl --user -u clawdbot-gateway -f

ステップ6：ダッシュボードへのアクセス

ClawdbotのコントロールUIはウェブブラウザからアクセス可能です：

http://your_server_ip:18789/

オンボーディング時に認証設定を行った場合は、ゲートウェイトークンの入力が必要です。

SSHトンネル経由のリモートアクセス

安全にリモートアクセスするには：

# ローカルマシンからSSHトンネルを設定
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# ローカルでアクセス
http://localhost:18789/

ステップ7：最初のチャネルを接続する

WhatsApp

WhatsAppを接続するには：

# QRコードを生成・表示
clawdbot channels login

# WhatsAppでスキャン：
# 設定 → 「リンク済みデバイス」 → 「デバイスをリンク」

スキャン後、WhatsAppがClawdbotに接続されます。

Telegram

  1. Telegramで@BotFatherにメッセージを送信しボットを作成
  2. 指示に従い新しいボットを作成
  3. 発行されたボットトークンをコピー
  4. Clawdbotにボットを追加：
clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

  1. Discord Developer Portalにアクセス
  2. 新しいアプリケーションを作成
  3. 「Bot」タブでボットを有効化
  4. ボットトークンをコピー
  5. 適切な権限を付与してDiscordサーバーに招待
  6. Clawdbotに追加：
clawdbot channels add --channel discord --token "your_discord_bot_token"

ステップ8：DMセーフティの設定

デフォルトではClawdbotはダイレクトメッセージに対してペアリングモードを使用し、未知の送信者にはペアリングコードを送り、承認されるまでメッセージを処理しません。

# 保留中のペアリングリクエスト一覧表示
clawdbot pairing list whatsapp

# ペアリングリクエストを承認
clawdbot pairing approve whatsapp <pairing_code>

# 承認済みペアリングの一覧表示
clawdbot pairing list whatsapp --approved

この動作は設定ファイル~/.clawdbot/clawdbot.jsonで変更可能です。

ステップ9：セットアップのテスト

動作確認のためテストメッセージを送信します：

# テストメッセージ送信
clawdbot message send --to +15555550123 --message "Hello from Clawdbot!"

# またはTelegramでテスト
clawdbot message send --to @your_telegram_username --message "Hello!"

あるいは、接続済みのWhatsApp/Telegram/Discordに直接メッセージを送ると、Clawdbotアシスタントが応答します。

ステップ10：Nginxの設定（任意）

本番環境ではNginxでリバースプロキシを設定し、セキュリティ強化やSSL証明書管理を推奨します。

Nginxのインストール

sudo apt install -y nginx

Nginxの設定

設定ファイルを編集：

sudo nano /etc/nginx/sites-available/clawdbot

以下の設定を追加：

server {
    listen 80;
    server_name your-domain.com;  # ご自身のドメインに置き換えてください

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

設定の有効化

# シンボリックリンク作成
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Nginx設定のテスト
sudo nginx -t

# Nginxの再起動
sudo systemctl restart nginx

CertbotでSSLを追加（推奨）

# Certbotのインストール
sudo apt install -y certbot python3-certbot-nginx

# SSL証明書の取得
sudo certbot --nginx -d your-domain.com

# Certbotが自動的にNginxをSSL対応に設定します

これでClawdbotは以下でアクセス可能になります：

https://your-domain.com/

よくあるトラブルシューティング

ゲートウェイが起動しない

ゲートウェイが起動しない場合：

# 設定エラーのチェック
clawdbot doctor

# 詳細ログの確認
journalctl --user -u clawdbot-gateway -n 50

メモリ不足エラー

2GB RAMのVPSで更新時にメモリ不足が発生する場合、スワップファイルを追加します：

# 2GBのスワップファイル作成
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# スワップを永続化
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

ポートが既に使用中

ポート18789が使用中の場合：

# ポートを使用しているプロセスを確認
sudo lsof -i :18789

# または別のポートを使用
clawdbot gateway --port 18889

ボットが応答しない

ボットが応答しない場合は以下を確認：

  1. ゲートウェイの状態確認：clawdbot gateway status
  2. チャネル設定の確認：トークンが正しく、チャネルが有効か
  3. 認証情報の確認：APIキーが有効か
  4. ログの確認：clawdbot logs --followでエラーメッセージを探す

Clawdbotのアップデート

最新バージョンにアップデートするには：

# インストーラーを再実行
curl -fsSL https://clawd.bot/install.sh | bash

# またはnpm経由で更新
npm update -g clawdbot@latest

# ゲートウェイを再起動
clawdbot gateway restart

# ヘルスチェック
clawdbot health

まとめ

VPSにClawdbotをインストールするのはシンプルなプロセスで、複数のメッセージングプラットフォームに対応した強力なセルフホスト型AIアシスタントを手に入れられます。LightNodeの手頃な価格、グローバルカバレッジ、高性能インフラにより、安心してパーソナルAIアシスタントを展開できます。

本ガイドに従えば、約20〜30分でVPS上にClawdbotを稼働させ、プライバシーを尊重しつつデータを完全にコントロールできる常時利用可能なAIパートナーを手に入れられます。

さらなるカスタマイズや高度な機能については、Clawdbot GitHubページの公式ドキュメントやコミュニティディスカッションを参照してください。

追加リソース

節約するVPSホスティング