openclaw调用超时需先确认是否走ssh跳板链路：若命令含-j/--jump-host或日志有ssh -j，则90%卡在跳板机认证环节；否则为http api超时，应排查网络、模型响应或配置参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw调用工具提示超时，说明工具在等待远程服务响应时超过了预设时限，常见于SSH跳转链路卡在认证环节、目标服务未就绪或网络路径存在静默丢包。这不是单纯调大timeout参数就能解决的问题，必须定位阻塞点。
确认OpenClaw底层是否依赖SSH连接
查看OpenClaw文档或执行openclaw --help，若命令中明确出现-J、--jump-host、via等关键词，或日志里有ssh -J字样，则判定其走的是SSH跳板链路。此时超时90%源于跳板机认证阶段卡住，而非目标服务慢。
这一步必须先做——如果OpenClaw实际走HTTP API调用，后续所有SSH排查都白费功夫。
手动复现SSH跳转链路并加-v观察
把OpenClaw内部拼出的完整SSH命令（如ssh -J jump-user@10.1.1.100 target-user@172.16.5.200 'openclaw-ctl status'）复制出来，在终端里直接执行，并追加-v参数：
ssh -v -J jump-user@10.1.1.100 target-user@172.16.5.200 'openclaw-ctl status'
重点盯三处日志：
• 出现debug1: Authentications that can continue: publickey,password且无后续 → 卡在密码输入，说明定时任务环境无TTY，必须改用免密；
• 卡在debug1: Next authentication method: publickey后超过10秒无响应 → 跳板机上私钥未加载，或~/.ssh/authorized_keys里对应公钥被no-pty限制；
【跳板机若启用了Google Authenticator等OTP，ssh -J绝对无法自动通过，必须换用ssh-agent + 预注册令牌方案】
检查跳板机SSH服务配置兼容性
登录跳板机，运行：
sudo grep -E "^(PasswordAuthentication|AuthenticationMethods|MaxAuthTries|LoginGraceTime)" /etc/ssh/sshd_config
逐项核对：
• 若PasswordAuthentication no，则客户端必须提供有效公钥，且跳板机~/.ssh/authorized_keys中该公钥不能被注释或加no-pty；
• 若AuthenticationMethods publickey,keyboard-interactive，说明强制双因素，sshpass、expect等脚本化工具全部失效；
• 若MaxAuthTries 2且之前失败过，当前连接会因限速等待超时，需清空/var/log/secure中近期失败记录并重启sshd。
验证目标服务端口与服务状态
方法一：绕过跳板机直连目标机（仅限内网可达场景）
ssh target-user@172.16.5.200 -p 22 'systemctl is-active openclawd' → 若返回active，说明服务正常，问题锁定在跳转链路；
方法二：从跳板机内部telnet目标机端口
ssh jump-user@10.1.1.100 → 执行telnet 172.16.5.200 22 → 若卡住，说明跳板机到目标机的TCP通路不通，查路由或目标机防火墙；
方法三：检查目标机SSH服务是否监听非22端口
目标机上执行ss -tlnp | grep :22，若无输出，说明SSH服务未监听22端口，OpenClaw配置里的端口需同步调整。
强制启用客户端保活避免空闲断连
第一步：编辑本地~/.ssh/config
第二步：添加以下内容（注意缩进必须为Tab或空格，不能混用）
Host 10.1.1.100
ServerAliveInterval 30
ServerAliveCountMax 2
ConnectTimeout 10
第三步：再添加目标主机段
Host 172.16.5.200
ProxyJump 10.1.1.100
ServerAliveInterval 30
ServerAliveCountMax 2
第四步：设置文件权限
chmod 600 ~/.ssh/config
第五步：测试新配置是否生效
ssh -F ~/.ssh/config target-user@172.16.5.200 'openclaw-ctl ping'
