Connect to Another OpenClaw

What This Skill Does

Provides a unified interface to connect to a remote OpenClaw server via SSH, perform health checks, manage skills, and troubleshoot common issues like port conflicts.

Prerequisites

1. SSH Access to the remote machine:
• SSH private key file (recommended) OR password access
• Remote user must have sudo/root privileges
• Remote machine must have OpenClaw installed
2. SkillHub on both local and remote (for skill sync)
3. Network connectivity (port 22 SSH)

Primary Workflow

1. Connect and Check Status

connect-openclaw --host <your-remote-host> --action status

Important: Replace with your actual remote server IP or domain (e.g., 192.168.1.100 or myserver.com). This is a required placeholder.

This will:

• Test SSH connectivity
• Check OpenClaw Gateway status
• List active channels (QQBot, etc.)
• Show recent sessions

2. Fix Common Issues

connect-openclaw --host <your-remote-host> --action fix-port

Automatically:

• Detect port conflicts on gateway port (default 18790)
• Kill conflicting processes (SSH tunnels, test services)
• Restart OpenClaw gateway
• Verify recovery

3. Sync Skills

# See differences
connect-openclaw --host <your-remote-host> --action diff

# Install remote's missing skills to local
connect-openclaw --host <your-remote-host> --action sync-to-local

# Install local's missing skills to remote (if remote has SkillHub)
connect-openclaw --host <your-remote-host> --action sync-to-remote

4. Send Message via Remote QQBot

connect-openclaw --host <your-remote-host> --action send-qqbot \
  --session "agent:main:qqbot:direct:..." \
  --message "Hello from local OpenClaw"

Commands Reference

Configuration

The skill uses these environment variables (optional):

You can also pass these as CLI flags:

connect-openclaw --host example.com --user admin --key ~/.ssh/mykey.pem --action status

Examples

Quick diagnostic

connect-openclaw --host <your-remote-host> --action status

Fix port conflict and restart

connect-openclaw --host <your-remote-host> --action fix-port

Compare skills before syncing

connect-openclaw --host <your-remote-host> --action diff

One-way sync (remote → local)

connect-openclaw --host <your-remote-host> --action sync-to-local

Installation

If not already installed, run:

skillhub install Connect_to_another_openclaw

Or clone this repository to ~/.openclaw/workspace/skills/Connect_to_another_openclaw/.

Requirements

• Python 3.9+ (or Node.js version if implemented in JS)
• paramiko (Python SSH library) or native ssh command
• Access to remote shell

Troubleshooting

Notes

• Always test with --action test-connection first
• fix-port will kill processes matching ssh -N.*18790 and voice-bridge-light
• Skill sync uses SkillHub CLI; ensure it's installed on both sides
• For safety, sync-to-remote prompts before each installation (use --yes to auto-confirm)

Version: 1.0.0

Author: 小李 (基于 2026-03-28 实践经验)

License: MIT