コンテンツにスキップ

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 回だけ使える登録用トークン付きのコマンドを出すので、機械で実行します。

Terminal window
curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh -s -- --enroll-token mwe_…

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

トークンなしで(コードを承認する)

Section titled “トークンなしで(コードを承認する)”
Terminal window
curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh

終わると、端末に承認のコードとリンクが出ます。Minion Workspace にサインインした状態でリンクを開き、ミニオンの名前と、所属するワークスペース (自分がオーナーか管理者のもの) を決めて 承認する を押します。minion status でもう一度コードとリンクが見られます。コードは 10 分で切れます。切れたら minion status が新しいコードを出します。

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
Terminal window
sudo minion uninstall

Minion が機械に残したデータ(2 つのユーザーも含む)も一緒に消えます。ミニオンが要らなければ、ミニオン ページからも削除してください。

同じ機械に Minion を入れ直したときは、元のミニオンにつなぎ直せます。名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当など、Minion Workspace にあるものはそのまま使えます。機械の上のデータ(メモリー・ルーティン・ToDo など)は、アンインストールしたときに消えています。

  1. Minion Workspace でミニオンの 概要 タブを開き、ペアリングを解除 を押します
  2. 「トークンなしで(コードを承認する)」の手順で入れ直し、承認のページの つなぎ方 で 既存のミニオンに付け直す を選んで、元のミニオンを選びます

古い Minion が入っていると言われる

Section titled “古い Minion が入っていると言われる”

npm で入れた以前のミニオン(Node.js 版)が機械に残っています。同じミニオンのまま乗り換えるときは、ミニオンの詳細画面の 新しい Minion に乗り換える で出るコマンドを使います(新しい Minion への乗り換え)。新しいミニオンとして一から入れるときは、以前のミニオンを外してから、もう一度コマンドを実行します。

Terminal window
sudo minion-cli uninstall
sudo 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 の公開したものと一致しなかったため、何も入れていません。時間をおいてもう一度実行してください。続くときは お問い合わせ ください。

minion status を実行します。waiting for approval とコード・リンクが出ていれば、リンクを開いて承認します。Minion Agent が動いていなければ、journalctl -u minion-agent を見てください。