steipete/remote-mac

Accede y gestiona remotamente los Macs de Peter: MacBook Pro, Mac Studio y clawmac, usando Tailscale, SSH y OpenClaw.

¿Qué es remote-mac?

Este skill permite a un agente de IA acceder, diagnosticar y administrar de forma remota los equipos Mac de Peter (MacBook Pro, Mac Studio y clawmac) a través de Tailscale, SSH y herramientas de automatización local. Está diseñado para entornos corporativos y personales con topologías de red segmentadas, y proporciona reglas claras para descubrir hosts, ejecutar comandos no interactivos, verificar el estado de OpenClaw Gateway y manejar automatizaciones de Codex. Incluye instrucciones detalladas para acceder a la GUI de clawmac mediante Automator, AppleScript y Jump Desktop como último recurso. El skill prioriza la precisión usando Tailscale como fuente de verdad para las IPs, y desaconseja el uso de IPs obsoletas o la conexión a hosts caídos. Es útil para desarrolladores que necesitan un control remoto fiable y seguro sobre múltiples máquinas Apple en redes complejas, con soporte para tareas como configuración de cronjobs, verificación de canales de OpenClaw y automatización de OAuth.

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

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Remote Mac

Úsalo cuando el usuario diga MacBook, Mac Studio, clawmac, moltymac, Molty, Tailscale, o solicite ejecutar/verificar algo en uno de los Macs de Peter.

Topología de Peter

  • Controlador diario principal: MacBook Pro de Peter, host local steipete-mbp, Tailscale peters-macbook-pro-1.
  • Caballo de batalla corporativo: Mac Studio, Tailscale peters-mac-studio-1, generalmente mejor accesible como [email protected].
  • OpenClaw personal en la nube: clawmac (Peter puede escribir crabmac), Tailscale/SSH steipete@clawmac, gateway a través de LaunchAgent ai.openclaw.gateway, loopback 127.0.0.1:18789, conectado a Telegram.
  • División de red:
    • corporate: Entorno gestionado por el trabajo de Peter. Tratar a Mac Studio como el Mac remoto principal para configurar e inspeccionar allí.
    • personal: LAN personal de Peter / entorno personal en la nube, incluyendo clawmac.
  • Límite de red: clawmac y la LAN personal son inalcanzables desde el Mac corporativo de Peter. Nunca uses clawmac como relé o punto de vista de la LAN desde allí.
  • Molty: se ejecuta en Mac Studio, no en moltymac, cuando está saludable. El runtime esperado es la sesión de tmux openclaw-gateway-watch-main desde /Users/steipete/clawdbot con pnpm gateway:watch --benchmark, enlace LAN *:18789, bot de Discord Molty, más Slack y Telegram conectados.
  • moltymac: nodo antiguo/alternativo. Si Tailscale lo muestra desconectado o SSH agota el tiempo de espera, no lo trates como el runtime activo de Molty.

Fuente de verdad del repositorio del gestor:

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

Descubrimiento

  1. Comienza con tailscale status --json en vivo; haz coincidir el nombre de host/DNS y usa la IP actual del nodo. Las IPs de Tailscale almacenadas en caché por el gestor pueden estar desactualizadas.
  2. En el entorno corporate, usa por defecto Mac Studio para trabajos de configuración remota. Accede a él a través de su nodo Tailscale en vivo. MagicDNS puede estar deshabilitado; usa directamente el TailscaleIPs[0] actual. No intentes usar clawmac, mDNS ni descubrimiento de LAN personal desde allí.
  3. En el entorno personal, si Tailscale está caído o SSH agota el tiempo de espera, intenta el descubrimiento por LAN:
dns-sd -B _ssh._tcp local
arp -a
  1. Prueba nombres mDNS como HOST.local solo cuando estés en la misma LAN.
  2. Si el nodo Tailscale en vivo de Mac Studio está desconectado desde el entorno corporate, detente: debe despertarse o reconectarse antes de continuar con el diagnóstico SSH o Compartir Pantalla.

Reglas SSH

Usa SSH no interactivo por defecto:

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

El alias SSH local mac-studio se adjunta automáticamente a tmux. Para comandos únicos, usa [email protected] o sobrescribe ambas opciones anteriores.

Para trabajo remoto de larga duración o interactivo, usa tmux en el host remoto y mantén el nombre de la sesión claro.

Verificaciones de OpenClaw

Usa shells de inicio de sesión en Macs remotos para que Homebrew y pnpm estén en el PATH:

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

Estado saludable de Mac Studio / Molty:

  • tmux list-sessions incluye openclaw-gateway-watch-main.
  • ps axww incluye pnpm gateway:watch --benchmark.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN muestra un listener en *:18789.
  • openclaw channels status --json muestra Discord Molty, Slack y Telegram conectados.

Estado saludable de clawmac:

  • launchctl list incluye ai.openclaw.gateway.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN muestra listeners en loopback.
  • openclaw channels status --json muestra Telegram conectado.

Automatizaciones de Codex

  • Las automatizaciones cron de Codex son estado del programador local del host, no trabajos genéricos en la nube.
  • En el entorno corporate, configura o replica esas automatizaciones en Mac Studio a menos que Peter indique lo contrario.
  • Trata ~/.codex/automations/<automation-id>/automation.toml en el host de destino como la fuente de verdad para la definición del trabajo programado en esa máquina.
  • Si el objetivo es mover una automatización cron desde la máquina corporativa actual de Peter a Mac Studio, realiza el trabajo en Mac Studio:
    • asegúrate de que el checkout del repositorio previsto exista allí
    • sincroniza los archivos de política locales requeridos del repositorio
    • crea o actualiza la entrada correspondiente ~/.codex/automations/... en Mac Studio
    • deshabilita o pausa la copia antigua del host corporativo si Peter quiere un solo ejecutor
  • No asumas que el traspaso de hilo de la aplicación Codex transfiere la propiedad del programador cron; el movimiento del hilo y la propiedad del cron son independientes.

Acceso GUI a clawmac

  • Prefiere la automatización directa de clawmac sobre Tailscale/SSH primero: open -a "Google Chrome", AppleScript, JavaScript DOM de Chrome y clics remotos de Peekaboo.
  • Para OAuth de gog en clawmac, mantén el navegador en clawmac. Inicia gog auth add en tmux remoto, abre la URL impresa en Chrome de clawmac, haz clic en consentimiento con AppleScript/automatización DOM, luego verifica con zsh -lc 'gog auth list --check --json --no-input'.
  • Si GOG_KEYRING_PASSWORD está exportado por el entorno shell remoto, usa el shell de inicio de sesión correspondiente para verificaciones y envío de indicaciones de tmux, y nunca imprimas el valor.
  • Si SSH/cron encuentra prompts solo de GUI que la automatización directa no puede manejar, usa Peekaboo local a través de la ventana de Jump Desktop clawmac como recurso de emergencia.
  • Encuéntralo con peekaboo list windows --app "Jump Desktop" --json; captúralo mediante --window-title clawmac o el --window-id informado.
  • Los clics usan coordenadas globales locales a través de la ventana de Jump Desktop; verifica con una captura de pantalla sin procesar antes de hacer clic.
  • Problemas de cookies/llavero de Chrome: security puede solicitar Chrome Safe Storage; Peter debe ingresar la contraseña del llavero de inicio de sesión y luego hacer clic en Always Allow.
  • Después de la aprobación, verifica vía SSH con /Users/steipete/Projects/bird/bird check y /Users/steipete/.openclaw/bin/bird-gui check.

Seguridad

  • No asumas la identidad del host a partir de una IP obsoleta; verifica el nombre de host/usuario cuando sea posible.
  • No imprimas secretos de archivos o shells remotos.
  • Si un host no está disponible después del fallback de Tailscale + LAN, indica qué se intentó.
  • Para OpenClaw Gateway en las máquinas de Peter, sigue la documentación del repositorio AGENTS; no instales/arranques/detengas servicios a menos que se te solicite.

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 relacionados