steipete/mac-distant

Macs distants : MacBook, Mac Studio, clawmac, Tailscale, SSH, OpenClaw.

Qu'est-ce que mac-distant ?

Ce skill permet d'interagir avec les Macs distants de Peter, notamment son MacBook Pro personnel, son Mac Studio professionnel et son nœud cloud personnel clawmac (OpenClaw). Il gère la découverte dynamique des machines via Tailscale et le réseau local, l'exécution de commandes SSH non interactives, les vérifications d'état des passerelles OpenClaw et les automatisations Codex. Utile pour les développeurs et ingénieurs DevOps qui administrent un parc hétérogène de Macs avec des contraintes de réseau (environnements corporate/personnel) et des services critiques comme Molty, Slack, Telegram. Le skill fournit des règles précises pour éviter les confusions d'hôtes, les fuites de secrets et les suppositions erronées sur l'identité des nœuds.

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

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Mac distant

À utiliser lorsque l'utilisateur mentionne MacBook, Mac Studio, clawmac, moltymac, Molty, Tailscale, ou demande d'exécuter/vérifier quelque chose sur l'un des Macs de Peter.

Topologie de Peter

  • Pilote quotidien principal : MacBook Pro de Peter, hôte local steipete-mbp, Tailscale peters-macbook-pro-1.
  • Cheval de bataille professionnel : Mac Studio, Tailscale peters-mac-studio-1, généralement mieux accessible via [email protected].
  • Cloud personnel OpenClaw : clawmac (Peter peut faire une faute de frappe/dire crabmac), Tailscale/SSH steipete@clawmac, passerelle via LaunchAgent ai.openclaw.gateway, boucle locale 127.0.0.1:18789, connecté à Telegram.
  • Réseau divisé :
    • corporate : environnement géré par le travail de Peter. Considérer le Mac Studio comme le Mac distant principal pour la configuration et l'inspection.
    • personal : réseau local personnel de Peter / environnement cloud personnel, y compris clawmac.
  • Limite réseau : clawmac et le réseau local personnel sont inaccessibles depuis le Mac professionnel de Peter. Ne jamais utiliser clawmac comme relais ou point d'accès depuis cet environnement.
  • Molty : s'exécute sur le Mac Studio, pas sur moltymac, lorsqu'il est en bonne santé. L'exécution attendue est la session tmux openclaw-gateway-watch-main depuis /Users/steipete/clawdbot avec pnpm gateway:watch --benchmark, liaison LAN *:18789, bot Discord Molty, et connecté à Slack et Telegram.
  • moltymac : nœud ancien/alternatif. Si Tailscale le montre hors ligne ou que le SSH expire, ne pas le considérer comme l'exécution active de Molty.

Dépôt manager source de vérité :

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

Découverte

  1. Commencer par tailscale status --json en direct ; faire correspondre le nom d'hôte/nom DNS et utiliser l'IP actuelle du nœud. Les IP Tailscale mises en cache par le manager peuvent être obsolètes.
  2. Dans l'environnement corporate, utiliser par défaut le Mac Studio pour le travail de configuration à distance. L'atteindre via son nœud Tailscale en direct. MagicDNS peut être désactivé ; utiliser directement le TailscaleIPs[0] actuel. Ne pas essayer clawmac, mDNS ou la découverte sur le réseau local personnel depuis cet environnement.
  3. Dans l'environnement personal, si Tailscale est hors ligne ou que le SSH expire, essayer la découverte sur le réseau local :
dns-sd -B _ssh._tcp local
arp -a
  1. Essayer les noms mDNS comme HOST.local uniquement lorsqu'on est sur le même réseau local.
  2. Si le nœud Tailscale en direct du Mac Studio est hors ligne depuis l'environnement corporate, s'arrêter : il doit se réveiller ou se reconnecter avant de pouvoir continuer un diagnostic par SSH ou par Partage d'écran.

Règles SSH

Utiliser SSH non interactif par défaut :

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

L'alias SSH local mac-studio attache automatiquement tmux. Pour des commandes uniques, utiliser [email protected] ou remplacer les deux options ci-dessus.

Pour un travail à distance long ou interactif, utiliser tmux sur l'hôte distant et garder le nom de session évident.

Vérifications OpenClaw

Utiliser des shells de connexion sur les Macs distants pour que Homebrew et pnpm soient dans le PATH :

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

État de santé du Mac Studio / Molty :

  • tmux list-sessions inclut openclaw-gateway-watch-main.
  • ps axww inclut pnpm gateway:watch --benchmark.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN montre un écouteur sur *:18789.
  • openclaw channels status --json montre Discord Molty, Slack et Telegram connectés.

État de santé de clawmac :

  • launchctl list inclut ai.openclaw.gateway.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN montre des écouteurs en boucle locale.
  • openclaw channels status --json montre Telegram connecté.

Automatisations Codex

  • Les automatisations cron Codex sont un état de planificateur local à l'hôte, et non des tâches cloud génériques.
  • Dans l'environnement corporate, configurer ou refléter ces automatisations sur le Mac Studio sauf indication contraire de Peter.
  • Considérer ~/.codex/automations/<automation-id>/automation.toml sur l'hôte cible comme la source de vérité pour la définition de la tâche planifiée sur cette machine.
  • Si l'objectif est de déplacer une automatisation cron de la machine corporate actuelle de Peter vers le Mac Studio, effectuer le travail machine sur le Mac Studio :
    • s'assurer que le dépôt prévu y est présent
    • synchroniser les fichiers de politique locaux requis par le dépôt
    • créer ou mettre à jour l'entrée ~/.codex/automations/... correspondante sur le Mac Studio
    • désactiver ou mettre en pause l'ancienne copie sur l'hôte corporate si Peter ne souhaite qu'un seul exécuteur
  • Ne pas supposer que le transfert de fil de discussion Codex transfère la propriété du planificateur cron ; le transfert de fil et la propriété cron sont distincts.

Accès GUI à clawmac

  • Privilégier l'automatisation directe de clawmac via Tailscale/SSH en premier : open -a "Google Chrome", AppleScript, JavaScript DOM Chrome et clics Peekaboo distants.
  • Pour l'authentification OAuth gog sur clawmac, garder le navigateur sur clawmac. Lancer gog auth add dans un tmux distant, ouvrir l'URL imprimée dans Chrome sur clawmac, cliquer sur consentement avec AppleScript/automatisation DOM, puis vérifier avec zsh -lc 'gog auth list --check --json --no-input'.
  • Si GOG_KEYRING_PASSWORD est exportée par l'environnement du shell distant, utiliser le shell de connexion correspondant pour les vérifications et l'alimentation de l'invite tmux, et ne jamais imprimer la valeur.
  • Si le SSH/cron rencontre des invites exclusivement GUI que l'automatisation directe ne peut pas gérer, utiliser Peekaboo en local via la fenêtre clawmac de Jump Desktop comme solution de repli.
  • La trouver avec peekaboo list windows --app "Jump Desktop" --json ; capturer par --window-title clawmac ou le --window-id rapporté.
  • Les clics utilisent des coordonnées globales locales à travers la fenêtre Jump Desktop ; vérifier avec une capture d'écran brute de la fenêtre avant de cliquer.
  • Problèmes de cookies/keychain Chrome : security peut demander Chrome Safe Storage ; Peter doit entrer le mot de passe du keychain de connexion, puis cliquer sur Toujours autoriser.
  • Après approbation, vérifier via SSH avec /Users/steipete/Projects/bird/bird check et /Users/steipete/.openclaw/bin/bird-gui check.

Sécurité

  • Ne pas supposer l'identité d'un hôte à partir d'une IP obsolète ; vérifier le nom d'hôte/utilisateur lorsque c'est possible.
  • Ne pas imprimer de secrets depuis des fichiers ou shells distants.
  • Si un hôte est indisponible après la solution de repli Tailscale + LAN, indiquer ce qui a été tenté.
  • Pour la passerelle OpenClaw sur les machines de Peter, suivre la documentation du dépôt/AGENTS ; ne pas installer/démarrer/arrêter les services sauf demande explicite.

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.

Skills associés