Community研究与数据分析github.com

steipete/remote-mac

远程 Mac 管理:MacBook、Mac Studio、clawmac、Tailscale、SSH、OpenClaw。

remote-mac 是什么?

该技能用于管理 Peter 的多台远程 Mac 机器,包括日常使用的 MacBook Pro、企业工作站 Mac Studio 以及个人云节点 clawmac。它通过 Tailscale 网络进行安全发现和连接,并支持在 corporate 和 personal 两种网络环境下工作。技能的核心能力包括:基于 Tailscale 状态进行动态节点发现、通过非交互式 SSH 执行远程命令、检查 OpenClaw 网关和频道状态,以及管理 Codex 自动化任务。还提供了 clawmac 的 GUI 访问方案(通过 Jump Desktop 和 Peekaboo 进行自动化点击)以及 gog 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 的个人局域网/个人云环境,包括 clawmac。
  • 网络边界:clawmac 和个人局域网无法从 Peter 的企业 Mac 访问。切勿将 clawmac 用作那里的中继或 LAN 观察点。
  • Molty:运行在 Mac Studio 上(非 moltymac),健康时运行。预期运行环境是 tmux 会话 openclaw-gateway-watch-main,目录 /Users/steipete/clawdbot,命令 pnpm gateway:watch --benchmark,绑定 *:18789,连接 Discord 机器人 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. 仅当在同一局域网时,才尝试 mDNS 名称如 HOST.local。
  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 上使用登录 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 上执行机器工作:
    • 确保所需的仓库检出已存在
    • 同步所需的仓库本地策略文件
    • 在 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,则在检查和 tmux 提示输入时使用匹配的登录 shell,切勿打印该值。
  • 如果 SSH/cron 遇到 GUI 专属提示且直接自动化无法处理,则使用本地 Peekaboo 通过 Jump Desktop 的 clawmac 窗口作为后备方案。
  • 通过 peekaboo list windows --app "Jump Desktop" --json 找到窗口;通过 --window-title clawmac 或报告的 --window-id 捕获。
  • 点击使用通过 Jump Desktop 窗口的本地全局坐标;在点击前用原始窗口截图验证。
  • Chrome cookie/钥匙串问题:security 可能提示输入 Chrome Safe Storage;Peter 必须输入登录钥匙串密码,然后点击“始终允许”。
  • 批准后,通过 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.

相关技能