- name
- cross-agent
- version
- 1.0.0
- description
- 跨机器Agent协作 - 通过SSH连接局域网内其他OpenClaw实例，实现多机任务分发
- author
- OpenClaw
- homepage
- https://docs.openclaw.ai/skills/cross-agent
- tags
- [ssh, network, agent, collaboration, remote]
- requirements
- bins
- [sshpass, ssh, scp, ping, nc]
- platforms
- [linux]
- commands
- scan
- description
- 扫描局域网内在线设备
- usage
- openclaw cross-agent scan [网段，如 192.168.3.0/24]
- example
- openclaw cross-agent scan 192.168.3.0/24
- test
- description
- 测试SSH连接到目标机器
- usage
- openclaw cross-agent test <IP> [用户名] [密码]
- example
- openclaw cross-agent test 192.168.3.54 admin 123456
- sessions
- description
- 查看目标机器的OpenClaw会话
- usage
- openclaw cross-agent sessions <IP> [用户名] [密码]
- example
- openclaw cross-agent sessions 192.168.3.54 admin 123456
- send
- description
- 发送任务指令给目标Agent
- usage
- openclaw cross-agent send <IP> <任务消息> [用户名] [密码]
- example
- openclaw cross-agent send 192.168.3.54 '请搜索Docker教程' admin 123456
- get
- description
- 从目标机器获取文件
- usage
- openclaw cross-agent get <IP> <远程路径> [本地路径] [用户名] [密码]
- example
- openclaw cross-agent get 192.168.3.54 ~/Desktop/doc.md ~/Desktop/ admin 123456
- put
- description
- 向目标机器发送文件
- usage
- openclaw cross-agent put <IP> <本地路径> [远程路径] [用户名] [密码]
- example
- openclaw cross-agent put 192.168.3.54 ~/file.txt ~/Desktop/ admin 123456
- exec
- description
- 在目标机器执行任意命令
- usage
- openclaw cross-agent exec <IP> <命令> [用户名] [密码]
- example
- openclaw cross-agent exec 192.168.3.54 'ls -la' admin 123456
- config
- description
- 配置默认连接参数
- usage
- openclaw cross-agent config [--default-user USER] [--default-pass PASS] [--default-ip IP]
- example
- openclaw cross-agent config --default-user admin --default-pass 123456
- wizard
- description
- 交互式向导，引导完成跨机器协作
- usage
- openclaw cross-agent wizard
🔌 Cross-Agent 跨机器Agent协作
通过SSH连接到局域网内其他运行OpenClaw的机器，向其Agent发送任务指令。
🚀 快速开始
1. 扫描局域网设备
openclaw cross-agent scan 192.168.3.0/242. 测试SSH连接
openclaw cross-agent test 192.168.3.54 admin 1234563. 发送任务
openclaw cross-agent send 192.168.3.54 "请搜索K230部署方案" admin 1234564. 获取结果文件
openclaw cross-agent get 192.168.3.54 ~/Desktop/K230_部署方案.md ~/Desktop/ admin 123456⚙️ 配置默认值
设置常用参数，后续命令可省略：
openclaw cross-agent config \
--default-user admin \
--default-pass 123456 \
--default-ip 192.168.3.54配置后简写：
openclaw cross-agent send "请搜索Docker教程"📋 前提条件
目标机器必须：
- ✅ 开启SSH服务（端口22）
- ✅ 运行OpenClaw Gateway
- ✅ 与本机在同一局域网
本机必须：
- ✅ 安装sshpass:
sudo apt install sshpass - ✅ 网络连通:
ping <目标IP>
🔧 完整工作流示例
# 1. 扫描找到目标机器
openclaw cross-agent scan
# 2. 配置默认参数
openclaw cross-agent config --default-ip 192.168.3.54
# 3. 测试连接
openclaw cross-agent test
# 4. 查看目标会话
openclaw cross-agent sessions
# 5. 发送任务
openclaw cross-agent send "请生成一份Python爬虫教程"
# 6. 等待几秒...
sleep 10
# 7. 获取生成的文件
openclaw cross-agent get ~/Desktop/*.md ~/Desktop/
# 8. 查看内容
cat ~/Desktop/*.md🐛 故障排除
| 问题 | 解决 |
|---|---|
| Permission denied | 检查用户名/密码 |
| Connection refused | 目标SSH未开启或防火墙阻挡 |
| Gateway token error | 使用scp/get/put传输文件 |
| Command not found | 目标机器未安装OpenClaw |
📚 更多帮助
openclaw cross-agent --help- 查看所有命令openclaw cross-agent <command> --help- 查看具体命令帮助