Community研究&データ分析github.com

steipete/remote-mac

Peter の Mac(MacBook、Mac Studio、clawmac)に Tailscale と SSH でリモートアクセスし、管理・確認を行うためのスキルです。

remote-mac とは?

このスキルは、Peter が所有する複数の Mac をリモートから操作・管理するための手順とルールを提供します。対象となるマシンは、日常使用の MacBook Pro(steipete-mbp)、業務用の Mac Studio、個人用クラウドの clawmac です。ネットワークは corporate(業務環境)と personal(個人 LAN/クラウド)に分割されており、それぞれの環境に適した発見方法や SSH 接続ルールが定義されています。接続には Tailscale を優先し、フォールバックとして LAN 内の mDNS も利用可能です。OpenClaw ゲートウェイや Codex 自動化の管理、clawmac の GUI 自動化、セキュリティ上の注意点についても詳細に記述されています。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/remote-mac

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Remote Mac

ユーザーが MacBook、Mac Studio、clawmac、moltymac、Molty、Tailscale と言及したとき、または Peter の Mac のいずれかで何かを実行・確認するよう依頼したときに使用します。

Peter のトポロジー

  • プライマリ日常使用: Peter の MacBook Pro、ローカルホスト steipete-mbp、Tailscale peters-macbook-pro-1。
  • 業務用ワークホース: Mac Studio、Tailscale peters-mac-studio-1、通常は [email protected] で最良到達可能。
  • 個人用クラウド OpenClaw: clawmac(Peter は crabmac とタイポ/言う場合あり)、Tailscale/SSH steipete@clawmac、LaunchAgent ai.openclaw.gateway 経由のゲートウェイ、ループバック 127.0.0.1:18789、Telegram 接続済み。
  • ネットワーク分割:
    • corporate: Peter の業務管理環境。Mac Studio をリモート Mac として設定・検査の主対象とみなす。
    • personal: Peter の個人 LAN / 個人クラウド環境。clawmac を含む。
  • ネットワーク境界: clawmac と個人 LAN は Peter の業務用 Mac から到達不可。そこから clawmac を中継や LAN 視点として使用しないこと。
  • Molty: 正常時は Mac Studio で動作(moltymac ではない)。想定ランタイムは tmux セッション openclaw-gateway-watch-main、/Users/steipete/clawdbot で pnpm gateway:watch --benchmark を実行、LAN バインド *:18789、Discord ボット Molty、さらに Slack と Telegram に接続。
  • moltymac: 旧/代替ノード。Tailscale でオフライン表示または SSH がタイムアウトした場合、稼働中の Molty ランタイムとして扱わないこと。

マネージャリポジトリの信頼できる情報源:

  • /Users/steipete/Projects/manager/computers.yaml
  • /Users/steipete/Projects/manager/agents.yaml

発見方法

  1. まずは live の tailscale status --json を使用。ホスト名/DNS 名と一致させ、ノードの現在の IP を使用。マネージャにキャッシュされた Tailscale IP は古い可能性あり。
  2. corporate 環境では、リモート設定作業のデフォルトとして Mac Studio を使用。その live Tailscale ノード経由で到達。MagicDNS は無効の可能性があるため、現在の TailscaleIPs[0] を直接使用。そこから clawmac、mDNS、個人 LAN 発見を試みない。
  3. personal 環境で Tailscale がダウンしているか SSH がタイムアウトした場合、LAN 発見を試行:
dns-sd -B _ssh._tcp local
arp -a
  1. mDNS 名(HOST.local など)は同じ LAN 上でのみ試行。
  2. Mac Studio の live Tailscale ノードが corporate 環境からオフラインの場合、停止: SSH または画面共有の診断を続行する前に、マシンが起動するか再接続する必要あり。

SSH ルール

デフォルトでは非対話型 SSH を使用:

ssh -o RequestTTY=no -o RemoteCommand=none HOST 'COMMAND'

ローカル SSH エイリアス mac-studio は自動的に tmux にアタッチ。単発コマンドの場合は、[email protected] を使用するか、上記両方のオプションを上書き。

長時間実行または対話型のリモート作業には、リモートホストで tmux を使用し、セッション名を明確に保つ。

OpenClaw チェック

リモート Mac でログインシェルを使用し、Homebrew と pnpm が PATH に含まれるようにする:

ssh -o RequestTTY=no -o RemoteCommand=none [email protected] \
  'zsh -lc "openclaw gateway status --json; openclaw channels status --json"'

Mac Studio / Molty 正常状態:

  • tmux list-sessions に openclaw-gateway-watch-main が含まれている。
  • ps axww に pnpm gateway:watch --benchmark が含まれている。
  • lsof -nP -iTCP:18789 -sTCP:LISTEN で *:18789 のリスナーが表示される。
  • openclaw channels status --json で Discord Molty、Slack、Telegram が接続済みと表示される。

clawmac 正常状態:

  • launchctl list に ai.openclaw.gateway が含まれている。
  • lsof -nP -iTCP:18789 -sTCP:LISTEN でループバックリスナーが表示される。
  • openclaw channels status --json で Telegram が接続済みと表示される。

Codex 自動化

  • Codex cron 自動化はホストローカルのスケジューラ状態であり、汎用クラウドジョブではない。
  • corporate 環境では、Peter が別途指示しない限り、自動化を Mac Studio で設定またはミラーリングする。
  • ターゲットホスト上の ~/.codex/automations/<automation-id>/automation.toml を、そのマシン上のスケジュールジョブ定義の信頼できる情報源として扱う。
  • 目的が Peter の現在の業務用マシンから Mac Studio に cron 自動化を移行することである場合、Mac Studio 上でマシン作業を実行:
    • 意図したリポジトリのチェックアウトがそこに存在することを確認
    • 必要なリポジトリローカルポリシーファイルを同期
    • Mac Studio 上で対応する ~/.codex/automations/... エントリを作成または更新
    • Peter がランナーを 1 つだけ希望する場合は、古い業務用ホスト側のコピーを無効化または一時停止
  • Codex アプリのスレッド引き継ぎが cron スケジューラの所有権を移すと想定しない。スレッド移動と cron 所有権は別物。

clawmac GUI アクセス

  • Tailscale/SSH より先に、直接 clawmac 自動化を優先: open -a "Google Chrome"、AppleScript、Chrome DOM JavaScript、およびリモート Peekaboo クリック。
  • clawmac 上の gog OAuth の場合、ブラウザは clawmac 上に保持。リモート tmux で gog auth add を開始し、表示された URL を clawmac Chrome で開き、AppleScript/DOM 自動化で同意ボタンをクリックし、その後 zsh -lc 'gog auth list --check --json --no-input' で確認。
  • GOG_KEYRING_PASSWORD がリモートシェル環境でエクスポートされている場合、チェックおよび tmux プロンプト供給には対応するログインシェルを使用し、値を決して表示しない。
  • SSH/cron が直接自動化で処理できない GUI のみのプロンプトに遭遇した場合、Jump Desktop の clawmac ウィンドウを通じてローカルの Peekaboo をフォールバックとして使用。
  • peekaboo list windows --app "Jump Desktop" --json で検出。--window-title clawmac または報告された --window-id でキャプチャ。
  • クリックは Jump Desktop ウィンドウを通したローカルグローバル座標を使用。クリック前に生のウィンドウスクリーンショットで確認。
  • Chrome の Cookie/キーチェーン問題: security が Chrome Safe Storage を要求する場合がある。Peter がログインキーチェーンパスワードを入力し、Always Allow をクリックする必要あり。
  • 承認後、SSH 経由で /Users/steipete/Projects/bird/bird check および /Users/steipete/.openclaw/bin/bird-gui check で確認。

安全性

  • 古い IP からホストの同一性を推測しない。可能な場合はホスト名/ユーザーを確認。
  • リモートファイルやシェルからシークレットを出力しない。
  • Tailscale + LAN フォールバック後もホストが利用不可の場合、試行した内容を報告。
  • Peter のマシン上の OpenClaw Gateway については、リポジトリの docs/AGENTS に従う。明示的に依頼されない限り、サービスのインストール/起動/停止を行わない。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル