コンテンツにスキップ

新しい Minion への乗り換え

以前に npm(@geekbeer/minion、Node.js 版)で用意したミニオンは、同じ機械・同じミニオンのまま 新しい Minion に乗り換えられます。ミニオンの名前・所属するワークスペースとプロジェクトのメンバー・チケットの担当・AI の利用の上限はそのままです。ミニオンのデータは機械の上で移り、Minion Workspace を通りません。

乗り換えは、ミニオンの持ち主が Minion Workspace で承認したときに切り替わります。

データ移り方
メモリーミニオンが入っているすべてのワークスペースへ。プロジェクトのメモリーは、そのプロジェクトのワークスペースへ
デイリーログ日付ごとに、そのワークスペースへ
ToDo終わってから 30 日を過ぎたものは移しません
ルーティン名前が新しい決まり(英小文字・数字・-)に合わないときは名前が変わります
チャットの履歴読めるように移します。会話の続きからは話しません
ファイルミニオンの files フォルダ
Minion Appsアプリのデータ。ミニオンの AI が作ったアプリはコードも移します
権限・振り返りの時刻自分で足した拒否のルールと、振り返りの時刻

ワークスペースの決まっていないルーティン・ToDo・チャットは、乗り換えるときに選んだワークスペースへ移ります。

  • シークレット — 値は移しません。乗り換えの報告に名前が出るので、入れ直してください
  • 変数 — 新しい Minion にはミニオンの変数がありません。報告に名前と値が出るので、ワークスペースの変数に入れ直してください
  • 実行の記録 と、Minion Workspace に無い 手元だけのスキル
  • 自分の Claude のサインイン — 以前のミニオンがユーザー minion で動いていたとき(macOS の案内どおりのとき)は、そのユーザーごと引き継ぐのでそのまま残ります。それ以外は、頭脳 タブからもう一度サインインします
  • Claude 以外の AI(Gemini・Codex)の設定

移さなかったものは、乗り換えの報告に理由と一緒に出ます。以前のミニオンのデータは、機械の上の控えに 30 日残ります(シークレットの値と API トークンは消します)。

  • 乗り換えのあいだ、ミニオンが動かしている仕事は止まります
  • 乗り換えを始めるのと承認するのは、ミニオンの持ち主 だけができます。2 段階認証を設定しているときは、最近入力したコードを求められます(既定は 10 分以内。ワークスペースの設定で変えられます)
  • 以前のミニオンが別の Minion Workspace(URL が違うもの)につながっているときは乗り換えられません

ミニオンの詳細画面の 概要 タブに 新しい Minion に乗り換える が出ます。機械の種類を選ぶと、手順が出ます。

乗り換えを始める を押します。Minion Workspace が以前のミニオンを Node.js 版の最後の版に更新し、その更新が新しい Minion を入れて引き継ぎます。10 分ほどかかり、承認は要りません。うまくいかなかったときは以前のミニオンのまま動き続け、理由が詳細画面に出ます。同じ VPS のままなので、料金は変わりません。

  1. Minion をダウンロード から新しい Minion のインストーラーを入れます(Windows・macOS)
  2. インストーラーが以前のミニオンを見つけると、引き継いでよいかを聞きます。Windows は OK を、macOS は 続ける を押します。インストールに失敗したときは、以前のミニオンが元どおり動き続けます
  3. Minion のウィンドウに、承認のコードと「引き継ぎとして承認」の文が出ます。リンクを開き、引き継いで承認する を押します

画面の無いインストール(msiexec /qn)では聞けないので、引き継ぐときは TAKEOVER_NODE=1 を付けます。付けなければ、以前のミニオンが入っている PC ではインストールは止まります。

引き継ぎの作業役の Windows・macOS のユーザーは、次のとおりです。

  • 以前のミニオンがユーザー minion で動いていたとき(macOS の案内どおりのとき)— そのユーザーを作業役として引き継ぎます。パスワード・自動ログイン・自分の Claude のサインインはそのまま残ります。管理者のグループに入っているときは、外してからインストールしてください
  • それ以外(自分のアカウントで動かしていたとき)— 新しく minion ユーザーを作り、files フォルダをそこへ写します。セットアップの手順どおりに、minion のパスワードを決めてサインインしてください
  1. Linux を選んで 乗り換えを始める を押すと、コマンドが出ます
  2. 以前のミニオンの機械で、30 分以内にそのコマンドを実行します(sudo が要ります)
Terminal window
curl -fsSL https://minionworkspace.com/setup/minion.sh | sudo sh -s -- --take-over-node --enroll-token mwe_…

コマンドにはこのミニオンの登録用トークンが入っています。ほかの人に見せないでください。インストールに失敗したときは、以前のミニオンが元どおり動き続けます。

  1. Docker のコンテナ を選び、今のコンテナの名前を入れて 乗り換えを始める を押すと、コマンドが出ます
  2. 以前のコンテナがある機械で、30 分以内にそのコマンドを実行します。以前のコンテナからデータを取り出し(./minion-takeover)、以前のコンテナを止めて、新しいコンテナを起こします
  3. 乗り換えが済んだら、以前のコンテナと ./minion-takeover は消してかまいません

詳細画面に 乗り換えの報告 が出ます。

  1. 移したもの・移さなかったもの を確かめます
  2. 入れ直すシークレット を 環境変数 タブで入れ直します。新しい Minion ではシークレットはワークスペースごとにあり、実行には、そのスキルが宣言したものだけが渡ります
  3. 変数 をワークスペースの変数に入れ直します
  4. 頭脳 タブで AI がつながっているか確かめます。ミニオンAI と自分の API キーは、乗り換えのときにつなぎ直します。自分の Claude のプランは、ユーザーを引き継いでいなければサインインし直します
  5. 機械に残したもの(以前のミニオンが入れた Node.js・Homebrew の道具・TightVNC など)は、ほかで使っていなければ消してかまいません

Minion Apps は、乗り換えのあとに Minion Workspace が入れ直します。

承認のページに「持ち主が承認してください」と出る

Section titled “承認のページに「持ち主が承認してください」と出る”

引き継ぎの承認は、そのミニオンの持ち主だけができます。ミニオンの持ち主のアカウントで開き直してください。

インストールが途中で失敗する

Section titled “インストールが途中で失敗する”

以前のミニオンは元どおり動き続けます。よくある原因は次のとおりです。

  • 以前のミニオンが、別の Minion Workspace(URL が違うもの)につながっている
  • 引き継ぐユーザー minion が管理者のグループに入っている
  • macOS で、以前のミニオンが 2 つ以上のユーザーで入っている(1 つを残して アンインストール します)

理由は、Windows ではインストーラーのメッセージに、macOS では /var/log/install.log の minion の行に出ます。

Linux のコマンドが「古い Minion が入っている」と止まる

Section titled “Linux のコマンドが「古い Minion が入っている」と止まる”

--take-over-node の無いコマンドは、以前のミニオンを見つけると止まります。ミニオンの詳細画面の 新しい Minion に乗り換える で出るコマンドを使ってください。

新しいミニオンとして一から始めたいときは、以前のミニオンをアンインストールしてから(Windows・macOS。Linux は sudo minion-cli uninstall のあと sudo npm uninstall -g @geekbeer/minion)、Minion を入れて新しいミニオンとして承認します。このときは、以前のミニオンのシークレット・変数・メモリー・デイリーログ・ToDo・ルーティン・実行の記録・チャットの履歴・ファイル・Minion Apps のデータは移りません。要るものは、アンインストールの前にノートやドライブに写しておいてください。