Remote Connection Guide

⚠️ PREREQUISITE: This guide assumes you already have SSH access to your remote machine. If you don't, please set up SSH access manually before proceeding.

Step 1: Determine Connection Method

Ask the user:

How do you connect to your remote machine?

Tailscale (recommended — zero-config mesh VPN)

Direct SSH to a VPS (public IP)

Local network (same LAN)

Step 2: Connect via Tailscale

If the user has Tailscale installed on both machines:

# Check Tailscale is running
tailscale status

# SSH to remote using Tailscale hostname
ssh <user>@<hostname>.tail<tailnet>.ts.net

Note: If Tailscale is not installed, please install it manually following the official Tailscale documentation: https://tailscale.com/download

Step 2 (alt): Connect via Direct SSH

# Test connection (assumes SSH is already configured)
ssh <user>@<ip-address>

Note: This guide assumes SSH authentication is already configured on your system. We recommend using SSH key-based authentication for security, which you should set up manually outside of this skill.

Step 3: Start tmux Session on Remote

# SSH in and start tmux
ssh <user>@<remote-address>
tmux new-session -s openclaw

# Or attach to existing
ssh <user>@<remote-address> -t 'tmux attach-session -t openclaw || tmux new-session -s openclaw'

Step 4: Use tmux from Local Agent

Once the user has an SSH connection, interact via tmux from the local machine:

# If SSH session has tmux running locally that forwards to remote:
tmux send-keys -t <local-session> 'openclaw --version' Enter
sleep 2 && tmux capture-pane -t <local-session> -p -S -5

# If using SSH directly in tmux:
tmux send-keys -t <session> 'ssh <user>@<remote> "openclaw --version"' Enter

Step 5: Verify OpenClaw Installation

which openclaw && openclaw --version

If not installed:

# macOS (Homebrew)
brew install openclaw

# Linux (npm)
npm install -g openclaw

# Verify
openclaw --version

Troubleshooting

Problem	Solution
Connection refused	Check SSH is running: `sudo systemctl status sshd`
Permission denied	Check key permissions: `chmod 600 ~/.ssh/id_ed25519`
Tailscale not connecting	Run `tailscale up --reset` on both machines
tmux not found	Install: `brew install tmux` (mac) or `apt install tmux` (linux)
ENOENT uv_cwd in tmux	Run `cd ~` first — previous cwd was deleted

2.4 KiB Raw Blame History