Dockerでミニオンを動かす
ミニオンは、公式のイメージ ghcr.io/geek-beer/minion-agent から Docker のコンテナとして動かせます。コンテナは Minion Workspace へ自分から接続し(ポートを公開する必要はありません)、コンテナの中の仮想のディスプレイの上で動きます。
- Docker を動かせて、電源を入れたままにできる機械 — サーバーか、Docker Desktop を入れた PC。イメージは x86_64 と arm64 に対応しています
- Minion Workspace のアカウント
ミニオンを起こす
Section titled “ミニオンを起こす”サイドバーの ミニオン を開き、ミニオンを追加 で Docker Container を選び、ミニオンを作ります。Minion Workspace が、1 回だけ使える登録用トークンとタイムゾーンを入れた、実行するコマンドを出します。
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 のプランのどれか)を選びます。
コンテナは自分では更新しません。新しい版にするときは、イメージを取り直し、同じ名前とボリュームでコンテナを起こし直します。ミニオンは登録済みなので、トークンは付けません。
docker pull ghcr.io/geek-beer/minion-agent:latestdocker rm -f minion-1a2b3c4ddocker 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 |
docker rm -f minion-1a2b3c4ddocker volume rm minion-1a2b3c4d-data minion-1a2b3c4d-homeボリュームを消すと、ミニオンが残したものも消えます。そのあと、ミニオン ページからミニオンを削除してください。
トラブルシューティング
Section titled “トラブルシューティング”ミニオンがつながらない
Section titled “ミニオンがつながらない”コンテナの docker logs を見ます。トークンが切れていた(または使い済みだった)ときは、もう一度ミニオンを追加して、新しいコマンドを使ってください。トークンなしでコンテナを起こしたときは、docker exec <名前> minion status が承認のコードとリンクを出します。Minion Workspace にサインインした状態でリンクを開いて承認します。