Files
openclaw-skill/openclaw-knowhow-skill/docs/infrastructure/platforms/mac/remote.md
Selig 4c966a3ad2 Initial commit: OpenClaw Skill Collection
6 custom skills (assign-task, dispatch-webhook, daily-briefing,
task-capture, qmd-brain, tts-voice) with technical documentation.
Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
2026-03-13 10:58:30 +08:00

1.6 KiB

Remote Control

Overview

OpenClaw's remote control capabilities allow a macOS app to function as a controller for an OpenClaw gateway on another host via SSH.

Key Operational Modes

The system supports three operational approaches:

  1. Local execution on the macOS device
  2. Remote over SSH (default) with port forwarding
  3. Remote direct using WebSocket connections without SSH tunneling

Transport Options

Two transport mechanisms are available:

  • SSH tunneling: Masks the client as localhost
  • Direct WebSocket: Exposes the actual client IP

Setup Requirements

Remote Host Requirements

  • Node.js, pnpm, and the OpenClaw CLI installed
  • Accessible on the system PATH
  • SSH should use key-based authentication
  • Tailscale IPs recommended for reliable off-network access

macOS App Configuration

  1. Select transport type
  2. Specify the SSH target
  3. Optionally provide gateway URLs and identity file paths
  4. Use "Test remote" feature to validate connectivity

Web Chat Integration

Web Chat operates through the same SSH tunnel or direct gateway connection depending on the selected transport method.

Security Considerations

  • Use loopback bindings with either SSH or Tailscale for secure connections
  • Implement token/password authentication when binding to non-loopback interfaces

Troubleshooting

Common issues include:

  • Exit code 127: PATH configuration problems
  • SSH connectivity failures: Check key authentication and host accessibility
  • Port forwarding mismatches: Verify WebSocket connection ports match configuration