NanoClaw

最終更新日: 2026年5月21日

目次

テンプレート説明

NanoClawは、WhatsApp・Telegram・Discord・Slack などのメッセージングチャンネルから複数の Claude エージェントを利用できるオープンソースの AI エージェントフレームワークです。各エージェントは独立した Docker コンテナ内で動作するため、OS レベルのプロセス分離により高いセキュリティを実現しています。メッセージ履歴・スケジュールタスク・Web アクセスなどの機能を備えており、コードベースが小規模に保たれているため、ユーザー自身がカスタマイズを行いやすい設計となっています。

本テンプレートはスタートアップスクリプト完了後、NanoClaw のインタラクティブセットアップはサービスを停止した状態で待機します。SSH 接続後に管理スクリプト（nanoclaw-manage.sh setup）を実行して、表示名・Anthropic 認証・チャンネル設定を行ってください。

スタートアップスクリプトのテンプレートを利用してサーバー作成を行う手順はご利用ガイドを参照してください。

仕様

対応OSイメージ

Ubuntu 24.04 LTS

主要ソフトウェア

ソフトウェア名 バージョン ライセンス 用途
NanoClaw Latest MIT AI エージェントフレームワーク本体
Node.js 22.x MIT NanoClaw ホストプロセスの実行環境
pnpm Latest MIT パッケージマネージャー（corepack 経由）
Docker CE Latest Apache 2.0 エージェントコンテナの実行基盤
UFW Latest GPL-3.0 ファイアウォール管理

スタートアップスクリプト情報

項目 説明
アプリケーション利用ポート 22/tcp（SSH のみ。NanoClaw は外部公開ポートを持ちません）
インストールディレクトリ /home/nanoclaw/nanoclaw
管理スクリプト /root/nanoclaw-manage.sh、/root/nanoclaw-diagnose.sh
実行ユーザー nanoclaw（専用ユーザー、systemd linger 有効）
初期状態 依存関係インストール・リポジトリクローン済み、NanoClaw サービス未起動（セットアップ待ち）
インストールログ /var/log/nanoclaw-install.log

その他

最小システム要件

  • CPU: 1コア以上
  • メモリ: 最小 2GB、推奨 4GB 以上
  • ディスク容量: 最小 4GB、推奨 10GB 以上
  • ネットワーク: パブリック IP アドレス（SSH アクセス用）

利用手順

メモ

スタートアップスクリプトにてアプリケーションのインストールが完了するまで数分かかります。
インストール完了後、rootディレクトリに「nanoclaw-info.txt」というファイルが作成されますのでご確認ください。
ファイルが存在しない場合、作成されるまでしばらくお待ちください。
スタートアップスクリプトの実行状況は、SSH接続後に以下のコマンドで確認できます。

# tail -f /var/log/nanoclaw-install.log

重要

スタートアップスクリプト完了直後、NanoClaw はまだ動作していません。依存関係のインストールとリポジトリのクローンが完了した状態です。以下の手順に従い、SSH 接続後にインタラクティブセットアップを実行してください。

Step 1: VPS への接続

ConoHa コントロールパネルで確認した IP アドレスに SSH で接続します。

# ssh root@<IPアドレス>

Step 2: インストール状況の確認（任意）

スタートアップスクリプトのログや各種ツールのインストール状況を確認できます。

# /root/nanoclaw-diagnose.sh

Node.js・pnpm・Docker のバージョン、リポジトリの状態、UFW の設定状況などが表示されます。

Step 3: NanoClaw インタラクティブセットアップの実行

管理スクリプトの setup コマンドで、公式インストーラー（nanoclaw.sh）を起動します。

# /root/nanoclaw-manage.sh setup

以下の項目を対話形式で設定します。

  • 表示名（デフォルト: Andy）
  • Anthropic 認証方式（OAuth / API キー / スキップ）
  • 最初のチャンネル（Telegram / Discord / WhatsApp / ローカル CLI）
  • チャンネル固有の認証情報（ボットトークン、WhatsApp の QR コードなど）

メモ

OAuth 認証を選択した場合、claude setup-token ステップで SSH セッションに URL が表示されます。ローカルブラウザでその URL を開き、表示されたトークンを SSH セッションに貼り付けてください。

セットアップが完了すると、~/.config/systemd/user/nanoclaw-v2-<slug>.service が登録され、エージェントが自動起動します。

Step 4: サービスの操作

セットアップ完了後のサービス管理は nanoclaw-manage.sh で行います。

# /root/nanoclaw-manage.sh start    # サービス起動
# /root/nanoclaw-manage.sh stop     # サービス停止

再起動が必要な場合は stop → start の順に実行してください。

Step 5: アップデート

NanoClaw の公式アップデートスキル（/update-nanoclaw）を実行します。

# /root/nanoclaw-manage.sh update

アップデートフロー（プレビュー・マージ・ビルド・テスト）が対話的に進みます。完了後はサービスの再起動（stop → start）が必要です。

管理スクリプト一覧

スクリプト名 機能 使用例
nanoclaw-manage.sh setup NanoClaw インタラクティブセットアップ（初回のみ） # /root/nanoclaw-manage.sh setup
nanoclaw-manage.sh start NanoClaw サービス起動 # /root/nanoclaw-manage.sh start
nanoclaw-manage.sh stop NanoClaw サービス停止 # /root/nanoclaw-manage.sh stop
nanoclaw-manage.sh update 公式アップデートスキル（/update-nanoclaw）の実行 # /root/nanoclaw-manage.sh update
nanoclaw-diagnose.sh 各種ツールのバージョン・サービス状態・ログ末尾の表示 # /root/nanoclaw-diagnose.sh

セキュリティグループ設定

ポート番号 プロトコル 用途 必須/オプション
22 TCP SSH <任意

メモ

NanoClaw はメッセージングサービス（Telegram・Discord・WhatsApp など）へ外向きの HTTPS/WSS 接続を行います。インバウンドで公開するポートは SSH（22/tcp）のみです。

サイト名 URL 説明
NanoClaw 公式サイト https://nanoclaw.dev プロダクト情報・最新ニュース
NanoClaw 公式ドキュメント https://docs.nanoclaw.dev 技術ドキュメント・クイックスタート・アーキテクチャ解説
NanoClaw GitHub リポジトリ https://github.com/qwibitai/nanoclaw ソースコード・イシュートラッカー・CHANGELOG

おトクなキャンペーン情報