连接至另一台 OpenClaw

该技能的作用

提供统一接口，通过 SSH 连接远程 OpenClaw 服务器，执行健康检查、技能管理，并排查端口冲突等常见问题。

前提条件

1. SSH 访问权限（需可访问远程主机）：
   • SSH 私钥文件（推荐）或密码登录方式
   • 远程用户需具备 sudo/root 权限
   • 远程主机必须已安装 OpenClaw
2. 本地与远程均需安装 SkillHub（用于技能同步）
3. 网络连通性（确保 SSH 端口 22 可达）

主要工作流

1. 连接并检查状态

connect-openclaw --host  --action status

重要提示：请将 替换为实际的远程服务器 IP 或域名（例如 192.168.1.100 或 myserver.com）。此为必填占位符。

该命令将执行以下操作：

• 测试 SSH 连通性
• 检查 OpenClaw Gateway 运行状态
• 列出当前活跃通道（如 QQBot 等）
• 显示最近会话记录

2. 修复常见问题

connect-openclaw --host  --action fix-port

自动执行以下操作：

• 检测网关端口（默认为 18790）上的端口冲突
• 终止造成冲突的进程（如 SSH 隧道、测试服务等）
• 重启 OpenClaw Gateway
• 验证恢复是否成功

3. 同步技能

# 查看本地与远程技能差异
connect-openclaw --host  --action diff

# 将远程存在但本地缺失的技能安装至本地
connect-openclaw --host  --action sync-to-local

# 将本地存在但远程缺失的技能推送至远程（要求远程已安装 SkillHub）
connect-openclaw --host  --action sync-to-remote

4. 通过远程 QQBot 发送消息

connect-openclaw --host  --action send-qqbot 
  --session "agent:main:qqbot:direct:..." 
  --message "Hello from local OpenClaw"

命令参考

配置

该技能支持以下环境变量（均为可选）：

也可通过 CLI 参数传入：

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

示例

快速诊断

connect-openclaw --host  --action status

修复端口冲突并重启服务

connect-openclaw --host  --action fix-port

同步前比对技能差异

connect-openclaw --host  --action diff

单向同步（远程 → 本地）

connect-openclaw --host  --action sync-to-local

安装

若尚未安装，请运行：

skillhub install Connect_to_another_openclaw

或克隆本仓库至 ~/.openclaw/workspace/skills/Connect_to_another_openclaw/ 目录。

依赖要求

• Python 3.9+（若以 JavaScript 实现，则需 Node.js）
• paramiko（Python SSH 库）或系统原生 ssh 命令
• 具备远程 Shell 访问权限

故障排查

注意事项

• 首次使用建议先运行 --action test-connection 进行连通性测试
• fix-port 会终止匹配正则 ssh -N.*18790 和进程名 voice-bridge-light 的所有进程
• 技能同步依赖 SkillHub CLI，请确保本地与远程均已安装
• 出于安全性考虑，sync-to-remote 在每次安装前均会交互式确认；如需跳过确认，请添加 --yes 参数

版本: 1.0.0
作者: 小李（基于 2026-03-28 实践经验）
许可证: MIT