Linuxミニオンのセットアップ
Linux の機械に 1 行のコマンドで Minion を入れると、その機械をミニオンとして使えます。Minion は systemd のサービスとして動き、Minion Workspace へ自分から接続し(ポートを開ける必要はありません)、自分で更新します。ミニオンは仮想のディスプレイの上で動くので、モニターも、誰かがログインしておくことも要りません。
- systemd の動く Linux(x86_64 / arm64)。 Ubuntu(22.04 以降)か Debian(12 以降)を推奨します。コマンドが
aptでパッケージを入れ(dnfのディストリビューションでも動きます)、OpenSSL 3 で署名を確かめます - root になれるユーザー(
sudo) - Minion Workspace のアカウント
方法は 2 つあります。どちらも、Minion に要るパッケージ(仮想のディスプレイ、ブラウザが使うライブラリ、日本語のフォントなど)を入れ、ダウンロードしたものの署名を確かめて、Minion Agent を起動します。
「ミニオンを追加」から(承認なし)
Section titled “「ミニオンを追加」から(承認なし)”サイドバーの ミニオン を開き、ミニオンを追加 で 自分の機械 を選び、Linux を選んでミニオンを作ります。Minion Workspace が、1 回だけ使える登録用トークン付きのコマンドを出すので、機械で実行します。
curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh -s -- --enroll-token mwe_…Minion が入るとすぐにミニオンがつながり、画面にも表示されます。トークンは 1 回だけ、30 分のあいだだけ使えます。切れたら、もう一度ミニオンを追加してください。
トークンなしで(コードを承認する)
Section titled “トークンなしで(コードを承認する)”curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh終わると、端末に承認のコードとリンクが出ます。Minion Workspace にサインインした状態でリンクを開き、ミニオンの名前と、所属するワークスペース (自分がオーナーか管理者のもの) を決めて 承認する を押します。minion status でもう一度コードとリンクが見られます。コードは 10 分で切れます。切れたら minion status が新しいコードを出します。
AI を使えるようにする
Section titled “AI を使えるようにする”Minion Workspace のミニオンのページで 頭脳 タブを開き、Claude Code を入れてから、ミニオンが使うものを選びます。ミニオンAI、自分の Anthropic の API キー(つなぎ方)、自分の Claude のプラン(タブからサインインします。Minion Workspace の中でミニオンのターミナルが開きます)のどれかです。
そのあと、ミニオンのページで、ミニオンが オンライン になっていること、ターミナル を開くと minion としてシェルが開くこと、画面共有 でデスクトップが見えることを確かめ、チャットからメッセージを送ってみてください。
- ユーザー 2 つ:
minion-agent(Minion Agent)とminion(AI が動くユーザー。パスワードが無く、ログインできません) - サービス:
minion-agent(Minion Agent)、minion-worker(AI の側)、minion-displayとminion-window(仮想のディスプレイ、1280×800)、minion-updater /usr/local/binのminionコマンド
Minion は自分で更新します。数時間ごとに新しい版を確かめ、ミニオンが仕事をしていないときに入れます。すぐに更新するときは、ミニオンのページの バージョン … に今すぐ更新する を押すか、sudo minion update --now を実行します。minion update で更新役の状態が見られます。
| したいこと | 方法 |
|---|---|
| Minion が動いていて、つながっているか | minion status |
| ログ | journalctl -u minion-agent(AI の側は journalctl -u minion-worker) |
| 再起動する | ミニオンのページの Agent を再起動、または sudo systemctl restart minion-agent |
アンインストール
Section titled “アンインストール”sudo minion uninstallMinion が機械に残したデータ(2 つのユーザーも含む)も一緒に消えます。ミニオンが要らなければ、ミニオン ページからも削除してください。
入れ直したとき
Section titled “入れ直したとき”同じ機械に Minion を入れ直したときは、元のミニオンにつなぎ直せます。名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当など、Minion Workspace にあるものはそのまま使えます。機械の上のデータ(メモリー・ルーティン・ToDo など)は、アンインストールしたときに消えています。
- Minion Workspace でミニオンの 概要 タブを開き、ペアリングを解除 を押します
- 「トークンなしで(コードを承認する)」の手順で入れ直し、承認のページの つなぎ方 で 既存のミニオンに付け直す を選んで、元のミニオンを選びます
トラブルシューティング
Section titled “トラブルシューティング”古い Minion が入っていると言われる
Section titled “古い Minion が入っていると言われる”npm で入れた以前のミニオン(Node.js 版)が機械に残っています。同じミニオンのまま乗り換えるときは、ミニオンの詳細画面の 新しい Minion に乗り換える で出るコマンドを使います(新しい Minion への乗り換え)。新しいミニオンとして一から入れるときは、以前のミニオンを外してから、もう一度コマンドを実行します。
sudo minion-cli uninstallsudo npm uninstall -g @geekbeer/minion「the release list’s signature does not check out」と出る
Section titled “「the release list’s signature does not check out」と出る”ダウンロードしたものが Minion Workspace の公開したものと一致しなかったため、何も入れていません。時間をおいてもう一度実行してください。続くときは お問い合わせ ください。
ミニオンがオフラインのまま
Section titled “ミニオンがオフラインのまま”minion status を実行します。waiting for approval とコード・リンクが出ていれば、リンクを開いて承認します。Minion Agent が動いていなければ、journalctl -u minion-agent を見てください。