ssh-guide.mdx

title	SSH Remote Access
description	Connect to your Android OpenClaw server from your PC, laptop, or any device.

Overview

OCA sets up OpenSSH on port 8022 during installation. Start it with:

sshd

---

Connect from your PC

Find your Android IP:

ip addr show | grep 'inet ' | grep -v 127

Connect:

ssh -p 8022 user@192.168.1.x

Default password set by OCA is `1234` — **change this immediately** with `passwd`.

---

SSH Key Authentication (Recommended)

# On your PC — generate key (skip if you have one)
ssh-keygen -t ed25519 -C "android-openclaw"

# Copy to Android
ssh-copy-id -p 8022 user@192.168.1.x

SSH config shortcut (~/.ssh/config on PC):

Host android-openclaw
  HostName 192.168.1.x
  Port 8022
  IdentityFile ~/.ssh/id_ed25519

Then: ssh android-openclaw

---

Remote Access (Outside Home Network)

Option 1: ngrok

pkg install ngrok
ngrok tcp 8022

Option 2: Tailscale (Recommended)

pkg install tailscale
tailscale up

---

Auto-start SSH on Boot

echo "sshd" >> ~/.termux/boot/start-openclaw.sh

---

Common Issues

SSH not running: `sshd` Check Android IP: `ip addr show`. Both devices must be on same WiFi. Fix authorized_keys permissions: `chmod 600 ~/.ssh/authorized_keys` Remove old entry: `ssh-keygen -R "[old-ip]:8022"`