- name
- Connect_to_another_openclaw
- description
- Connect to and manage another OpenClaw server remotely. Check status, sync skills, restart gateway, and monitor channels.
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
- 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
- SkillHub on both local and remote (for skill sync)
- Network connectivity (port 22 SSH)
Primary Workflow
1. Connect and Check Status
connect-openclaw --host <your-remote-host> --action statusImportant: Replace <your-remote-host> 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-portAutomatically:
- 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-remote4. 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
| Command | Description |
|---|---|
status | Full health check of remote OpenClaw |
fix-port | Auto-fix port 18790 conflicts |
diff | Compare local vs remote skills |
sync-to-local | Install remote-only skills to local |
sync-to-remote | Push local-only skills to remote |
list-skills | List all skills on remote |
list-channels | List configured channels |
list-sessions | Show active sessions |
tail-logs | Tail OpenClaw logs filtered by channel |
test-connection | Simple SSH test |
Configuration
The skill uses these environment variables (optional):
| Variable | Purpose | Default |
|---|---|---|
CONNECT_OPENCLAW_SSH_KEY | Path to SSH private key | ~/.ssh/id_rsa |
CONNECT_OPENCLAW_USER | Remote username | root |
CONNECT_OPENCLAW_PORT | SSH port | 22 |
CONNECT_OPENCLAW_GATEWAY_PORT | Remote OpenClaw port | 18790 |
You can also pass these as CLI flags:
connect-openclaw --host example.com --user admin --key ~/.ssh/mykey.pem --action statusExamples
Quick diagnostic
connect-openclaw --host <your-remote-host> --action statusFix port conflict and restart
connect-openclaw --host <your-remote-host> --action fix-portCompare skills before syncing
connect-openclaw --host <your-remote-host> --action diffOne-way sync (remote → local)
connect-openclaw --host <your-remote-host> --action sync-to-localInstallation
If not already installed, run:
skillhub install Connect_to_another_openclawOr 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 nativesshcommand- Access to remote shell
Troubleshooting
| Problem | Solution |
|---|---|
SSH connection failed | Check key permissions (chmod 600), network, and authorized_keys |
SkillHub not found on remote | Install SkillHub on remote first |
Permission denied | Ensure remote user has sudo/root and correct key |
Port still in use after fix | Manually check with lsof -i :18790 and kill processes |
Notes
- Always test with
--action test-connectionfirst fix-portwill kill processes matchingssh -N.*18790andvoice-bridge-light- Skill sync uses SkillHub CLI; ensure it's installed on both sides
- For safety,
sync-to-remoteprompts before each installation (use--yesto auto-confirm)
Version: 1.0.0 Author: 小李 (基于 2026-03-28 实践经验) License: MIT