Community연구 & 데이터 분석github.com

steipete/remote-mac

원격 Mac(MacBook, Mac Studio, clawmac, Tailscale, SSH, OpenClaw)에 대한 지식과 명령을 제공합니다.

remote-mac란 무엇인가요?

이 스킬은 Peter의 원격 Mac(MacBook Pro, Mac Studio, clawmac 등)에 접속하고 관리하는 데 필요한 모든 정보를 제공합니다. Tailscale 상태 확인, SSH 연결 규칙, OpenClaw 게이트웨이 상태 점검, Codex 자동화 구성 방법 등을 상세히 안내합니다. 'corporate'와 'personal' 네트워크 분할 환경에서 각각 적절한 호스트를 선택하고 명령을 실행하는 방법을 명시하며, Mac Studio가 주 업무용 원격 머신인 반면 clawmac은 개인 클라우드 환경에서 관리됩니다. 또한 GUI 접근이 필요한 경우 Peekaboo를 통한 클릭 자동화, tmux 세션 관리, 그리고 안전한 비밀번호 처리를 포함한 다양한 운영 팁을 제공합니다.

지원 대상~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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

원격 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이 아닙니다. 예상 런타임은 /Users/steipete/clawdbot에서 pnpm gateway:watch --benchmark로 실행되는 tmux 세션 openclaw-gateway-watch-main이며, LAN 바인드 *:18789, Discord 봇 Molty, Slack 및 Telegram이 연결됩니다.
  • moltymac: 이전/대체 노드. Tailscale에 오프라인으로 표시되거나 SSH 시간 초과가 발생하면 이를 활성 Molty 런타임으로 취급하지 마십시오.

매니저 저장소 정보 출처:

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

탐색

  1. 실시간 tailscale status --json으로 시작하고, 호스트명/DNS 이름을 일치시킨 후 노드의 현재 IP를 사용합니다. 매니저에 캐시된 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에 있을 때만 HOST.local과 같은 mDNS 이름을 시도합니다.
  2. Mac Studio의 실시간 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가 실행기를 하나만 원하는 경우 이전 업무용 호스트 복사본을 비활성화하거나 일시 중지합니다.
  • 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 쿠키/키체인 문제: security가 Chrome Safe Storage에 대해 프롬프트를 표시할 수 있습니다. Peter가 로그인 키체인 암호를 입력한 다음 Always Allow를 클릭해야 합니다.
  • 승인 후 /Users/steipete/Projects/bird/bird check 및 /Users/steipete/.openclaw/bin/bird-gui check로 SSH를 통해 확인합니다.

안전

  • 오래된 IP에서 호스트 ID를 가정하지 마십시오. 가능하면 호스트명/사용자를 확인합니다.
  • 원격 파일이나 셸에서 비밀을 출력하지 마십시오.
  • 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.

관련 스킬