CommunityPesquisa e Análise de Dadosgithub.com

steipete/remote-mac

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

O que é remote-mac?

Este conjunto de habilidades permite que agentes de IA, como o Claude Code ou o Cursor, gerenciem e interajam com a frota de Macs de Peter: MacBook Pro, Mac Studio e clawmac, entre outros. Ele fornece instruções detalhadas sobre como descobrir esses hosts por meio do Tailscale (com fallback para descoberta LAN via mDNS/dns-sd), fazer SSH de forma não interativa e executar verificações de integridade em serviços como o OpenClaw Gateway. A habilidade define uma divisão de rede clara entre ambientes corporativos (onde o Mac Studio é o nó padrão) e pessoais (que inclui o clawmac), garantindo que o agente nunca use um nó da LAN pessoal como relay a partir do ambiente corporativo. A documentação também cobre verificações específicas de integridade de serviços do OpenClaw (verificando sessões tmux, listeners de porta e status de canais), automações do Codex (tratando-as como estado local do host) e procedimentos de acesso GUI para o clawmac, incluindo manipulação de navegador Chrome e automação de cliques via Peekaboo, sempre com foco em segurança: não imprimir segredos e verificar identidades de hosts.

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

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Mac Remoto

Use quando o usuário disser MacBook, Mac Studio, clawmac, moltymac, Molty, Tailscale, ou pedir para executar/verificar algo em um dos Macs do Peter.

Topologia do Peter

  • Motorista diário principal: MacBook Pro do Peter, host local steipete-mbp, Tailscale peters-macbook-pro-1.
  • Burro de carga corporativo: Mac Studio, Tailscale peters-mac-studio-1, geralmente melhor alcançado como [email protected].
  • OpenClaw pessoal na nuvem: clawmac (Peter pode digitar/dizer crabmac), Tailscale/SSH steipete@clawmac, gateway via LaunchAgent ai.openclaw.gateway, loopback 127.0.0.1:18789, conectado ao Telegram.
  • Divisão de rede:
    • corporate: Ambiente gerenciado de trabalho do Peter. Trate o Mac Studio como o Mac remoto principal para configurar e inspecionar lá.
    • personal: LAN pessoal do Peter / ambiente de nuvem pessoal, incluindo clawmac.
  • Limite de rede: clawmac e a LAN pessoal são inacessíveis a partir do Mac corporativo do Peter. Nunca use clawmac como relay ou ponto de vista da LAN a partir de lá.
  • Molty: executa no Mac Studio, não no moltymac, quando saudável. O runtime esperado é sessão tmux openclaw-gateway-watch-main de /Users/steipete/clawdbot com pnpm gateway:watch --benchmark, bind LAN *:18789, bot Discord Molty, mais Slack e Telegram conectados.
  • moltymac: nó antigo/alternativo. Se o Tailscale mostrar offline ou SSH der timeout, não o trate como o runtime ativo do Molty.

Fonte da verdade do repositório do gerenciador:

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

Descoberta

  1. Comece com tailscale status --json ao vivo; corresponda ao nome do host/nome DNS e use o IP atual do nó. IPs do Tailscale em cache no gerenciador podem estar desatualizados.
  2. No ambiente corporate, use o Mac Studio por padrão para trabalho de configuração remota. Alcance-o através do seu nó Tailscale ativo. O MagicDNS pode estar desabilitado; use o TailscaleIPs[0] atual diretamente. Não tente clawmac, mDNS ou descoberta LAN pessoal a partir de lá.
  3. No ambiente personal, se o Tailscale estiver inativo ou o SSH der timeout, tente a descoberta LAN:
dns-sd -B _ssh._tcp local
arp -a
  1. Tente nomes mDNS como HOST.local apenas quando estiver na mesma LAN.
  2. Se o nó Tailscale ativo do Mac Studio estiver offline a partir do ambiente corporate, pare: ele deve acordar ou reconectar antes que o diagnóstico via SSH ou Compartilhamento de Tela possa continuar.

Regras SSH

Use SSH não interativo por padrão:

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

O alias SSH local mac-studio anexa tmux automaticamente. Para comandos únicos, use [email protected] ou substitua ambas as opções acima.

Para trabalho remoto de longa duração ou interativo, use tmux no host remoto e mantenha o nome da sessão óbvio.

Verificações do OpenClaw

Use shells de login nos Macs remotos para que Homebrew e pnpm estejam no PATH:

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

Forma saudável do Mac Studio / Molty:

  • tmux list-sessions inclui openclaw-gateway-watch-main.
  • ps axww inclui pnpm gateway:watch --benchmark.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN mostra um listener em *:18789.
  • openclaw channels status --json mostra Discord Molty, Slack e Telegram conectados.

Forma saudável do clawmac:

  • launchctl list inclui ai.openclaw.gateway.
  • lsof -nP -iTCP:18789 -sTCP:LISTEN mostra listeners em loopback.
  • openclaw channels status --json mostra Telegram conectado.

Automações do Codex

  • Automações cron do Codex são estado local do agendador do host, não jobs genéricos na nuvem.
  • No ambiente corporate, configure ou espelhe essas automações no Mac Studio, a menos que Peter diga o contrário.
  • Trate ~/.codex/automations/<automation-id>/automation.toml no host de destino como a fonte da verdade para a definição do job agendado naquela máquina.
  • Se o objetivo for mover uma automação cron da máquina corporativa atual do Peter para o Mac Studio, faça o trabalho de máquina no Mac Studio:
    • garanta que o checkout do repositório pretendido exista lá
    • sincronize os arquivos de política locais do repositório necessários
    • crie ou atualize a entrada ~/.codex/automations/... correspondente no Mac Studio
    • desabilite ou pause a cópia antiga no host corporativo se Peter quiser apenas um executor
  • Não assuma que a passagem de thread do app Codex transfere a propriedade do agendador cron; movimento de thread e propriedade cron são separados.

Acesso GUI do clawmac

  • Prefira automação direta do clawmac em vez de Tailscale/SSH primeiro: open -a "Google Chrome", AppleScript, JavaScript DOM do Chrome e cliques remotos do Peekaboo.
  • Para OAuth gog no clawmac, mantenha o navegador no clawmac. Inicie gog auth add no tmux remoto, abra a URL impressa no Chrome do clawmac, clique em consentir com AppleScript/automação DOM e, em seguida, verifique com zsh -lc 'gog auth list --check --json --no-input'.
  • Se GOG_KEYRING_PASSWORD for exportado pelo ambiente shell remoto, use o shell de login correspondente para verificações e alimentação de prompt tmux, e nunca imprima o valor.
  • Se SSH/cron encontrar prompts apenas GUI que a automação direta não consegue lidar, use o Peekaboo local através da janela clawmac do Jump Desktop como fallback.
  • Encontre com peekaboo list windows --app "Jump Desktop" --json;

capture por --window-title clawmac ou pelo --window-id reportado.

  • Cliques usam coordenadas globais locais através da janela do Jump Desktop; verifique com uma captura de tela da janela antes de clicar.
  • Problemas de cookie/keychain do Chrome: security pode solicitar Chrome Safe Storage; Peter deve inserir a senha do keychain de login e depois clicar em Always Allow.
  • Após aprovação, verifique via SSH com /Users/steipete/Projects/bird/bird check e /Users/steipete/.openclaw/bin/bird-gui check.

Segurança

  • Não presuma identidade do host a partir de um IP desatualizado; verifique hostname/usuário quando possível.
  • Não imprima segredos de arquivos remotos ou shells.
  • Se um host estiver indisponível após fallback Tailscale + LAN, diga o que foi tentado.
  • Para OpenClaw Gateway nas máquinas do Peter, siga docs/AGENTS do repositório; não instale/inicie/pare serviços a menos que solicitado.

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.

Habilidades Relacionadas