コンテンツにスキップ

Dockerでミニオンを動かす

ミニオンは、公式のイメージ ghcr.io/geek-beer/minion-agent から Docker のコンテナとして動かせます。コンテナは Minion Workspace へ自分から接続し(ポートを公開する必要はありません)、コンテナの中の仮想のディスプレイの上で動きます。

  • Docker を動かせて、電源を入れたままにできる機械 — サーバーか、Docker Desktop を入れた PC。イメージは x86_64 と arm64 に対応しています
  • Minion Workspace のアカウント

サイドバーの ミニオン を開き、ミニオンを追加 で Docker Container を選び、ミニオンを作ります。Minion Workspace が、1 回だけ使える登録用トークンとタイムゾーンを入れた、実行するコマンドを出します。

Terminal window
docker run -d \
--name minion-1a2b3c4d \
--restart unless-stopped \
--pull always \
-e TZ=Asia/Tokyo \
-e MINION_ENROLL_TOKEN=mwe_… \
-v minion-1a2b3c4d-data:/var/lib/minion \
-v minion-1a2b3c4d-home:/home/minion \
ghcr.io/geek-beer/minion-agent:latest

機械で実行すると、数秒でミニオンがつながり、画面にも表示されます。トークンは 1 回だけ、30 分のあいだだけ使えます。切れたら、もう一度ミニオンを追加してください。

ミニオンのデータは 2 つのボリュームに入ります。…-data は Minion Agent のもの(機械がつながるための鍵を含む)、…-home は AI が動くユーザー minion のホームフォルダです。ミニオンが同じミニオンとして戻るには両方が要るので、残しておいてください。

そのあと、ミニオンのページで 頭脳 タブを開き、Claude Code を入れて、ミニオンが使うもの(ミニオンAI、自分の Anthropic の API キー(つなぎ方)、自分の Claude のプランのどれか)を選びます。

コンテナは自分では更新しません。新しい版にするときは、イメージを取り直し、同じ名前とボリュームでコンテナを起こし直します。ミニオンは登録済みなので、トークンは付けません。

Terminal window
docker pull ghcr.io/geek-beer/minion-agent:latest
docker rm -f minion-1a2b3c4d
docker run -d \
--name minion-1a2b3c4d \
--restart unless-stopped \
-e TZ=Asia/Tokyo \
-v minion-1a2b3c4d-data:/var/lib/minion \
-v minion-1a2b3c4d-home:/home/minion \
ghcr.io/geek-beer/minion-agent:latest
したいこと方法
Minion が動いていて、つながっているかdocker exec minion-1a2b3c4d minion status
ログdocker logs minion-1a2b3c4d
再起動するミニオンのページの Agent を再起動、または docker restart minion-1a2b3c4d
Terminal window
docker rm -f minion-1a2b3c4d
docker volume rm minion-1a2b3c4d-data minion-1a2b3c4d-home

ボリュームを消すと、ミニオンが残したものも消えます。そのあと、ミニオン ページからミニオンを削除してください。

コンテナの docker logs を見ます。トークンが切れていた(または使い済みだった)ときは、もう一度ミニオンを追加して、新しいコマンドを使ってください。トークンなしでコンテナを起こしたときは、docker exec <名前> minion status が承認のコードとリンクを出します。Minion Workspace にサインインした状態でリンクを開いて承認します。