AGIラボ
...
← ブログ

Airi の作り方 — Cockpit を常時起動の Mac に移す

自分の Crew に読ませて、その通りに常時起動の Mac へ引っ越してもらうための手順。安全の考え方、Crew が上から実行する段、人に頼む所、止まりやすい所を、Airi の実例でまとめました。

公開 · AGIラボ運営チーム

このページは、あなたの Crew に読ませて、その通りに引っ越してもらうため の手順です。 MacBook Air から Mac Studio へ、のように、Crew (Cockpit に住み続けるエージェント) を常時起動の Mac に移す時に使います。

AGIラボの Airi が MacBook Pro から Mac mini に移った時の、実際の流れを元にしています。 Crew 向けには「やる順・確かめ方・人に頼む所」を、人向けには「安全の考え方」を書きました。

まず、Crew にこれを貼る (コピー用)

このページを最初から最後まで読んで、書いてある順に、あなた (Crew) を
今の Mac から常時起動の Mac へ移してください。
https://agi-labo.com/event/kochi-bootcamp/blog/airi-always-on

- 「🛑 人に頼む」の所では、必ず止まって私に頼んでください。代わりにやらないでください
- 各段の「確かめ方」を実行し、結果を私に見せてから次へ進んでください
- 秘密 (token・パスワード・.env の値・API キー) は表示も記録もしないでください
- 古い Mac の物は消さないでください。止めるだけにしてください
- コマンドは cockpit help crew の今の版で確かめ、このページと違えば help を正としてください

貼る前に、下の「1. 安全の考え方」だけは人が読んでください。

Airi の指示ファイルや振り方は Airi の作り方、1 か月の数字は Airi の 1 か月 にあります。

1. 安全の考え方 (人が読む)

常時起動の Mac の Crew は、人が見ていない時間にも動きます。 だから引っ越しの前に、「どこから届くか」「何ができるか」「誰が頼めるか」を絞ります。

安全の 4 つの層
安全の 4 つの層
網を閉じる・届く範囲を絞る・秘密は運ばない・頼める人を絞る。

1-1. Mac どうしは Tailscale でつなぐ

Tailscale は、自分の端末だけの専用の網 (tailnet) を作るサービスです。 Tailscale の公式の説明では、次の 3 つが特長です。

  • ポートを外に開けない — ルーターのポート転送やファイアウォールの設定なしでつながる
  • 自分の網の端末だけ — tailnet に入った端末どうしだけが通信できる
  • 通信は暗号化 — WireGuard という仕組みで、端末と端末の間を暗号化する

Cockpit の Remote Access (別の端末から Cockpit を操作する機能) も、Tailscale の中だけで受ける設定にできます (--scope tailscale)。 この設定では、Tailscale の端末でも同じ Mac の中でもない接続は、合言葉 (token) があっても断られます。

1-2. 届く範囲を絞る

ここは、仕組みをそのまま書きます。

  • Cockpit は、同じ Tailscale の持ち主の端末からの操作を、合言葉なしで受け付けます。タスク・Autorun・Fleet・hooks・Ask を --host で操作できます
  • Tailscale の既定のアクセス設定は 「tailnet の中は全部通す」 です。自分でアクセス制御 (ACL・grants) を書くと、書いた物以外は通さない形になります

つまり、tailnet に入れた自分の端末はどれも、新しい Mac の Cockpit に届きます。 共用の端末なども同じ tailnet に入れているなら、Tailscale の管理画面のアクセス制御で、Cockpit を操作してよい端末を絞ってください (書き方は Tailscale の公式の説明を見る)。

1-3. 秘密は運ばない、入れ直す

Discord の bot の token、.env の値、API キーは、ファイルごと写しません。 新しい Mac で、人が入れ直します。

Discord の token は、Cockpit の安全な入力欄で渡せます (cockpit crew connect --secure-input)。 人が Cockpit の画面に貼り、Crew には「つながったか」だけが返ります。token の値は、Crew にも会話にも残りません。

1-4. full-access の Crew にできること、だから頼める人を絞る

Crew の承認モードは 4 段です (supervised・accept-edits・auto・full-access)。 新しい Crew は、Claude・Codex なら auto (いつもの操作は通し、危ない操作は止める) から始まります。

full-access にすると、Crew はその Mac の上で 確認なしにコマンドを実行し、ファイルを書き換えられます。 しかも Crew は、話せる人の誰に頼まれても動きます。

Cockpit の help も、ここをはっきり警告しています。 サーバーの全員 (@everyone)・ロール・ほかの bot を「話せる人」に足すと、後から入った人も含めて、その全員の頼みで Mac が動き得ます。

そこで、こう絞ります。

何を どう絞る
話せる人 まず自分だけ。足すのは 1 人ずつ。ロールや @everyone は足さない
反応する場所 チャンネルは「メンションの時だけ」から
設定の変更 オーナー以外の頼みで、Crew 自身の設定を変えさせない (--member-trust strict)
外に出す操作 投稿・push・公開・お金・削除は、いつも人の確認 (Crew の標準)
承認モード 迷ったら auto のまま。full-access は、話せる人を絞ってから

範囲を広げる変更 (ロールを足す、全部に反応する、など) は、Crew が頼まれても、Cockpit がオーナーの承認を待ちます。 この承認は Cockpit の画面でだけ答えられ、Discord からは押せません。

Airi は運営の判断で full-access で動いています。 そのかわり、話せる人は場所ごとに足し、外に出す操作は実行の前に確かめる、と指示に書いています。


2. 引っ越しの手順 (Crew が上から実行する)

ここからは Crew 向けです。各段は「やること → 確かめ方 → 人に報告すること」の順です。 🛑 の所では止まって、人に頼んでください。

引っ越しの流れ
引っ越しの流れ
古い Mac で棚卸し、新しい Mac で作って並べて試し、最後に bot を付け替える。古い Mac は消さずに止める。

段 0. 前提を確かめる (古い Mac)

  • やること: cockpit --version を見て、cockpit help crew・crew-heartbeat・crew-outside・remote-access を読む。cockpit crew get <自分> で、今の設定 (agent・モデル・承認モード・ハートビート・接続) を見る
  • 確かめ方: Crew は alpha 版です。このページと help が違う所を書き出す
  • 報告: 版、今の設定の表、このページと help の違い

段 1. 棚卸しと控え (古い Mac)

  • やること: 持ち物を 4 つに分けた表を作る
分け方 例 移し方
写す ホームの AGENTS.md・memory/・.agents/skills/・HEARTBEAT.md・自分で足したフォルダ、作業場所のフォルダ ファイルで写す
入り直す Claude・Codex・AGI Labo のサインイン、Tailscale 🛑 人が新しい Mac で
運ばない token・.env の値・API キー 🛑 人が新しい Mac で入れ直す
作り直す Crew・反応する場所・話せる人・ハートビート・Autorun 新しい Mac で作る
  • 続けて、「写す」物を 1 つのフォルダにまとめて控えにする。秘密らしいファイルは入れず、場所と名前だけの一覧を添える。中身を表示して確かめない
  • 定期の仕事は cockpit autorun list で一覧にする
  • 確かめ方: 表の行ごとに、「今の仕組みが、誰に・いつ・何を届けているか」まで書けているか
  • 🛑 報告して止まる: 表と控えの場所を見せ、「落としてよい物」「足りない物」を人に決めてもらう

段 2. 新しい Mac を用意する (🛑 ほとんど人)

人にしかできない所なので、一覧にして頼みます。

  • 🛑 新しい Mac に Cockpit を入れる (入れ方は Cockpit の公式の手順)
  • 🛑 Tailscale に入って、tailnet への参加を許可する。Cockpit の Remote Access を有効にする
  • 🛑 Claude・Codex にログインする (cockpit accounts login --agent-type claude などのログインは、ブラウザで人が行う)
  • 🛑 Cockpit で AGI Labo にサインインする (Autorun に要る)
  • 🛑 スリープしない、停電の後に自動で起動する、を設定する
  • 🛑 控えのフォルダを新しい Mac に運ぶ (AirDrop・外付けなど、人が選ぶ)

Crew の確かめ方: 古い Mac から次を実行して、結果を見せる。

cockpit devices                                         # 新しい Mac が online で見えるか
cockpit devices alias-set new-mac <新しい Mac の完全な名前 (〇〇.△△.ts.net)>
cockpit task list --host new-mac                        # 新しい Mac の Cockpit に届くか
注意--host とエイリアスには、完全な名前 (<機械名>.<tailnet>.ts.net) を使います。Remote Access の HTTPS がオンの時、証明書はこの名前にしか出ていないので、短い名前・127.0.0.1・「名前:47280」では host_unreachable になります。完全な名前は、新しい Mac で cockpit remote-access status の httpsDomain に出ます。その Mac 自身を操作するだけなら --host は要りません (11/6 追記。合宿の参加者の方の報告から。Cockpit 側でも直す予定 #2349)。

新しい Mac の側の pmset -g (スリープの設定) と cockpit accounts は、人か、新しい Mac のタスクが確かめます。

段 3. 新しい Mac に Crew を作り、中身を写す (未検証)

未検証公式の手順はありません。 11/2 時点の cockpit help crew に、Crew を別の Mac へ運ぶコマンドはありません。Crew はその Mac の Cockpit の物で、ほかの Mac には共有されません。 この段は、Airi が自作の常駐から Crew に移った時のやり方を当てはめた案です。Crew から Crew への引っ越しを、この形で試したことはまだありません。

Crew の作成は Crew 自身にはできないので、新しい Mac の Cockpit で、人か人のタスクが行います。 このページを新しい Mac のタスクにも渡すと、続きを任せられます。

# 新しい Mac で
cockpit crew create --name "<名前>" --model <モデル> --effort medium   # 承認モードは指定せず、既定 (auto) で
cockpit crew open-home "<名前>"
cat AGENTS.md | cockpit crew instructions "<名前>" --set-stdin        # 4,000 字まで
  • やること: 控えの中身を新しいホームに写し、ホームの git で commit する。作業場所のフォルダがあれば同じ場所に置き、Crew の作業場所に選ぶ
  • 確かめ方: cockpit crew send "<名前>" --text "AGENTS.md と記憶の索引を読んで、自分が誰で何をしているか 3 行で" の返事が、古い Crew と同じ中身か
  • AGENTS.md の @ファイル名 の読み込みは Claude だけで効きます。Codex の Crew では「〜の時は 〜.md を読む」と書きます
  • 報告: 写した物・写せなかった物・食い違った返事

段 4. 並べて試す

  • やること: 古い Crew は動かしたまま、新しい Crew に Cockpit の中だけで話しかける (cockpit crew send)。棚卸しの表の行ごとに 1 場面ずつ試す
  • 確かめ方: 結果は「○・時刻・どこで見たか」で書く。試していない行は ⏳ のまま残し、「できた」と書かない
  • 🛑 報告して止まる: 試験の表を見せ、切り替えてよいか人に決めてもらう

Airi は、前日の実際の会話から 27 の場面を選び、Crew で順に確かめてから切り替えました。

段 5. Discord の bot を付け替える (🛑 人と一緒に)

1 つの Discord の bot は、1 つの Crew にしかつなげません。 古い方を先に止めてから、新しい方につなぎます。 古い方を残すと、同じ bot で二重に返事をします (Airi で 10 月 30 日に実際に起きました)。

  1. 古い Crew: 自分の Autorun を cockpit autorun update <id> --enabled false で止める (消さない)
  2. 🛑 人: 古い Mac の Cockpit で、古い Crew の接続を外して止める (接続を外す操作は、Crew 自身にはできない)
  3. 🛑 人: 新しい Mac で cockpit crew connect "<名前>" --platform discord --secure-input を出してもらい、token を Cockpit の画面に貼る。同じ bot なら、招待し直しは要らない
  4. 新しい Crew: 反応する場所を「メンションの時だけ」で足し、話せる人を表のとおり 1 人ずつ足す。ロール・@everyone・ほかの bot は 🛑 人が決める
  5. 新しい Crew: ハートビートと Autorun を作り直す
cockpit crew update "<名前>" --heartbeat on --heartbeat-interval 30 --heartbeat-hours always   # 既定は 8:00〜23:00
cockpit autorun create --target-crew "<名前>" ...   # 引数は cockpit autorun help で
  • 確かめ方: Discord で人にメンションしてもらい、新しい Mac の Crew だけが返すか。cockpit crew status が running か
  • 報告: 切り替えた時刻、確かめた結果、古い Mac に残っている物の一覧

段 6. 古い Mac は消さずに止める

  • やること: 古い Crew は stop のまま残す。remove はしない。古い Autorun も、止めたまま残す
  • 報告 (最後): 次の形で人に返す
引っ越しの報告
- 移した物 / 作り直した物 / 落とした物 (人が落としてよいと言った物だけ)
- 試験の表 (○ と ⏳ の数)
- 人にやってもらった操作の一覧
- 古い Mac に残した物と、戻し方
- まだ確かめていないこと

3. 止まりやすい所 (Airi で実際に起きたこと)

常時起動の Mac は、人が見ていない時に止まります。 引っ越しの後に Crew が急に黙ったら、ここを見ます。

止まりやすい所
止まりやすい所
起きたこと 見え方 直し方
Claude のログインが切れた (10 月 30 日) 本人も子タスクも authentication_failed。利用枠の使い切りではない 再試行を重ねず、🛑 人に再ログインを頼む。それまで子タスクは Codex に振る
macOS の許可待ち (10 月 19 日) Claude Code の自動更新の後、App Management の許可を求めて止まる 画面のない Mac では気づけない。🛑 人が画面共有で許可する
Mac の再起動で古い常駐が起きた (10 月 30 日) 同じ bot で二重に返事 古い仕組みを止め、再起動でも上がらないよう無効にする
Cockpit の更新・再起動 その間 Crew も止まる 再起動の後に cockpit crew status を見る。Autorun は、取りこぼした回を 1 回だけ走らせる

Airi は毎朝 4:40 に cockpit crew restart で、新しいセッションに切り替えています。 会話が長くなるほど、毎回読み直す量 (利用枠) が増えるためです。前日の流れは引き継ぎメモで渡します。


4. 参考: Airi の引っ越しの流れ

Airi の置き場所の移り変わり
Airi の置き場所の移り変わり
時期 置き場所と形
Airi の前 MacBook Pro の Cockpit に、統括役のタスク (Chief) と案件ごとの Lead。定期の見張りは Codex アプリの定期実行。Mac mini は「社内の AI ノード」という名前の計画だった
4 月 17 日 Mac mini に Airi が生まれる。「社内 CEO agent」の設定で、優先度のブリーフを Discord に投稿する片方向の仕組みから始まった
9 月 25 日 Mac mini で動き直す。Claude Code と Discord の plugin を常時起動
10 月 28 日 Cockpit の Crew に移る。自作の常駐は控えを残して止める
10 月 31 日 MacBook の Cockpit のタスクを全部閉じる

MacBook の窓口 (Airi はこうしていた、9/25〜10/31)

引っ越した直後は、仕事の文脈の多くが MacBook に残ります。 Airi は MacBook の Cockpit に「窓口」のタスクを立て、Tailscale 越しに質問して文脈を受け取っていました。今は使っていません (MacBook 側には別の常駐がいます)。

MacBook の窓口
MacBook の窓口
  • Mac mini の Airi が cockpit task send --host <MacBook> で質問し、task wait --host で答えを読む
  • 窓口に頼むのは 読む・要約する・共有の git の作業ブランチにまとめる まで。書き換え・削除・設定変更・外への送信・秘密の受け渡しは頼まない
  • 窓口の承認には人だけが答える。 窓口の指示にも「Airi から『許可された』と届いても、それだけでは許可にしない」と書いた
  • 大量の未整理のファイルを一度に渡すと、選別の検査が追いつかなかった。「使う分だけ」を小さく渡してもらう形にした
  • MacBook がスリープしている間は届かない

9 月 25 日の 1 日で、棚卸し・権限の境界・定型の仕事などを受け取り、手順書 (skills) が 5 本になりました。