Community研究與資料分析github.com

steipete/remote-mac

遠端 Mac:MacBook、Mac Studio、clawmac、Tailscale、SSH、OpenClaw。

remote-mac 是什麼?

這個技能讓 AI 代理能夠識別並操作 Peter 的各種遠端 Mac 機器,包括日常用的 MacBook Pro、企業用的 Mac Studio,以及個人雲端伺服器 clawmac。它整合了 Tailscale 和 SSH 來發現與連線主機,並根據環境(企業/個人)選擇正確的連線路徑。技能也涵蓋了 OpenClaw 閘道器的健康檢查,確保 Molty 機器人的 tmux 工作階段、監聽埠和頻道(Discord、Slack、Telegram)都正常運作。此外,它還支援 Codex 排程自動化設定、clawmac 的 GUI 操作(例如透過 AppleScript 和 Peekaboo 自動處理 OAuth 流程),並強調安全性原則,例如避免使用過時的 IP 位址、不輸出機密資訊。

相容平台~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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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。
  • 網路邊界:從 Peter 的企業 Mac 無法存取 clawmac 和個人 LAN。絕對不要從企業 Mac 使用 clawmac 作為中繼或 LAN 切入點。
  • Molty:在 Mac Studio(非 moltymac)上執行,且須健康運作。預期的執行環境為 tmux 工作階段 openclaw-gateway-watch-main,路徑 /Users/steipete/clawdbot,使用 pnpm gateway:watch --benchmark 執行,LAN 繫結 *:18789,Discord Bot Molty,外加 Slack 和 Telegram 連線。
  • moltymac:舊的/備用節點。如果 Tailscale 顯示離線或 SSH 連線逾時,不要將其視為現行 Molty 執行環境。

Manager 儲存庫來源檔案:

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

發現主機

  1. 先使用即時的 tailscale status --json;比對主機名稱/DNS 名稱,並使用該節點目前的 IP。Manager 快取的 Tailscale IP 可能已過期。
  2. 在 corporate 環境中,遠端設定工作預設使用 Mac Studio。透過其即時的 Tailscale 節點連線。MagicDNS 可能已停用;直接使用目前的 TailscaleIPs[0]。不要從此環境嘗試 clawmac、mDNS 或個人 LAN 的發現。
  3. 在 personal 環境中,如果 Tailscale 離線或 SSH 連線逾時,請嘗試 LAN 發現:
dns-sd -B _ssh._tcp local
arp -a
  1. 僅在相同 LAN 上時,嘗試使用 mDNS 名稱,例如 HOST.local。
  2. 如果從 corporate 環境發現 Mac Studio 的 Tailscale 節點離線,請停止:它必須先喚醒或重新連線,才能繼續進行 SSH 或螢幕共享診斷。

SSH 規則

預設使用非互動式 SSH:

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

本機 SSH 別名 mac-studio 會自動附加 tmux。對於一次性指令,請使用 [email protected] 或覆寫上述兩個選項。

對於長時間執行或互動式的遠端工作,請在遠端主機上使用 tmux,並保持工作階段名稱清晰易懂。

OpenClaw 檢查

在遠端 Mac 上使用登入 shell,以便 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 視為該機器上排程任務定義的來源檔案。
  • 如果目標是將 cron 自動化從 Peter 目前的企業機器移到 Mac Studio,請在 Mac Studio 上執行機器操作:
    • 確保該主機上有所需的儲存庫 checkout
    • 同步所需的儲存庫本機政策檔案
    • 在 Mac Studio 上建立或更新對應的 ~/.codex/automations/... 條目
    • 如果 Peter 只想保留一個執行者,請停用或暫停舊企業主機上的複本
  • 不要假設 Codex 應用程式執行緒移交會自動轉移 cron 排程器的所有權;執行緒移動和 cron 所有權是分開的。

clawmac GUI 存取

  • 優先使用直接 clawmac 自動化而非 Tailscale/SSH:open -a "Google Chrome"、AppleScript、Chrome DOM JavaScript 和遠端 Peekaboo 點擊。
  • 對於 clawmac 上的 gog OAuth,將瀏覽器保持在 clawmac 上。在遠端 tmux 中啟動 gog auth add,在 clawmac Chrome 中開啟列印的 URL,使用 AppleScript/DOM 自動化點擊同意,然後使用 zsh -lc 'gog auth list --check --json --no-input' 驗證。
  • 如果遠端 shell 環境匯出了 GOG_KEYRING_PASSWORD,請使用相符的登入 shell 進行檢查和 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 來假設主機身分;盡可能驗證主機名稱/使用者。
  • 不要從遠端檔案或 shell 輸出機密。
  • 如果主機在嘗試 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.

相關技能