Mac miniにnanobotをインストールする方法

nanobotとは

nanobotは、GitHub上のHKUDSグループによるオープンソースの個人向けAIエージェントです。Pythonで書かれ、MITライセンスです。OpenClawと同じく、記憶を保ち、ツールを実行し、チャットアプリから応答します。コアは小さく、読みやすく保たれています（github.com/HKUDS/nanobot、2026年10月2日に確認）。PyPIの最新リリースは、2026年9月15日の0.3.5でした。

ブラウザのWebUI、ターミナル、またはTelegram、Discord、Slack、メールなどのチャネルから使えます。ファイルの操作、シェルコマンドの実行、Web検索、MCPサーバーの利用、定期ジョブの実行ができます。名前についてもう1点。これはobot-platform/nanobotではありません。そちらは、MCPエージェントを作るためのGoのフレームワークです。

必要なもの

• Python 3.11以降。python3 --versionで確認します。見つからないとインストーラーは止まるので、必要なら先にPythonをインストールしてください。
• macOS 13以降。Apple silicon搭載MacとIntel Mac向けのビルド済みパッケージには、WebUIとターミナルUIが含まれています。
• モデルのプロバイダー。Anthropic、OpenAI、OpenRouter、Ollamaなどのローカルサーバーは、すべてプロバイダーのドキュメントで扱われています。選んだプロバイダーのAPIキーを使います。
• GitとBun。ただし、ソースからインストールする場合だけです。通常のインストールでは不要です。

インストールする

READMEにある、公式の1コマンドのインストーラーを実行します。

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

PyPIからnanobot-aiパッケージをインストールします。システム全体へのpipでのインストールは避けます。有効になっている仮想環境、uv、pipx、またはホームの.nanobotフォルダにある専用の環境を使います。最後に、実際に使ったコマンドを表示します。何も変更せずに計画だけを見るには、dry runのフラグを付けます。

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

すでにuvを使っているなら、次のコマンドでも同じです。そのあとバージョンを確認します。

uv tool install nanobot-ai
nanobot --version

初回の起動とモデルの設定

READMEでは、初回はWebUIを勧めています。127.0.0.1のポート8765で開き、このMacからの接続だけを待ち受けます。

nanobot webui

「Settings」を開き、次に「Models」を開きます。プロバイダーを選び、APIキーを貼り付け、モデルを選びます。次に新しいトピックを始めて、Helloと送ります。普通の返信が来れば、プロバイダー、モデル、ゲートウェイが連携して動いています。ターミナルからなら、1回きりのメッセージで同じ確認ができます。

nanobot -m "Hello!"

設定は、ホームの.nanobotフォルダにあるconfig.jsonに保存されます。このインストールは、まだ当社のテストマシンでは実行していません。ここにあるコマンドは、2026年10月2日時点のnanobotのREADMEとドキュメントからコピーしたものです。

24時間動かし続ける

オンラインのまま動き続けるのはゲートウェイです。チャットアプリ、定期ジョブ、記憶の処理を動かし続けます。次のコマンドを使うと、ターミナルを閉じてもゲートウェイは動き続けます。

nanobot gateway --background

ただし、これは再起動を越えられません。そのために、デプロイのドキュメントではLaunchAgentをインストールします。まずWebUIでモデルの設定を済ませます。次に、サービスのファイルを事前に確認し、インストールします。

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

ホームのLibrary内のLaunchAgentsフォルダに、ai.nanobot.gateway.plistを書き込みます。ゲートウェイは、nanobotをインストールしたのと同じPythonで起動します。ログは.nanobot内のlogsフォルダに出力されます。address already in useで失敗した場合は、先に手動で起動したゲートウェイを止めてください。

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

ゲートウェイがconfig.jsonを読むのは起動時だけです。設定を変えるたびに再起動してください。

LaunchAgentが動くのは、ユーザーがログインしている間だけです。無人のMacでは、nanobotを動かすアカウントの自動ログインをオンにします。次に、Macがスリープしないようにします。スリープするとゲートウェイと定期ジョブが一時停止するからです。

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

詳しくはMacがスリープすると何が起きるかと常時稼働Macのガイドをご覧ください。

セキュリティについて

• 本番環境向けに、ドキュメントは2つの設定を組み合わせるよう勧めています。restrictToWorkspaceをtrueにし、macOSではtools.exec.sandboxをseatbeltにします。Seatbeltは、シェルコマンドをワークスペースのフォルダ内に制限します。
• どちらの設定も、ネットワークアクセスは制限しません。秘密情報はワークスペースの外に置いてください。
• WebUIとゲートウェイのヘルスチェックは、デフォルトで127.0.0.1で待ち受けます。このMacからだけ使える状態のままにしてください。
• チャットアプリで知らない相手から連絡があると、応答ではなくペアリングコードが返ります。/pairing approveとそのコードで承認します。
• ドキュメントでは、config.jsonに生のAPIキーを書くのではなく、環境変数の参照を使うよう勧めています。どちらにしても、.nanobotフォルダはパスワードのファイルと同じように扱ってください。

最も簡単な防御は、ほかに自分のものを何も置いていないMacを使うことです。エージェントがおかしなことをしても、被害はそのマシンで止まります。

MacRunのMacで動かす

当社のエージェントプランは、スリープしない専用のMac miniです。ニュージャージー州にある自社の専用施設に設置しています。再起動後はログインセッションが自動で戻るので、nanobotのLaunchAgentも再び起動します。Claude CodeとCodexはプリインストール済みです。nanobotは入っていません。完全な管理者権限があるので、必要ならPythonも含めて、ご自身でインストールしてください。

当社のブラウザ用デスクトップを通じて、Mac本体のブラウザでWebUIを開けます。エージェントプランは月額$169です。MacRunはAPIキーを販売していません。モデルのプロバイダーのAPIキーを使ってください。利用料は、そのプロバイダーが自社の規約に基づいて請求します。

MacRunが不要な場合

nanobotは小さく、ほぼどこでも動きます。ドキュメントでは、Linuxのサービス、Docker、ワンクリックのRenderへのデプロイを扱っています。macOSが何も必要ないなら、どれを選んでもMacより安く済みます。また、電源が入ったままログインしているMacをすでに持っているなら、それを使ってください。

MacRunは、当社の利用規定の範囲内での開発作業のためのサービスです。issueを仕分ける、毎晩リポジトリの雑務をこなすnanobotなら合っています。個人の受信トレイを管理するnanobotは対象外です。プランの比較はエージェント用Macのページをご覧ください。