ssh-agentd 控制技能

适用环境（当前）：

• - 二进制：/home/krex/.openclaw/workspace-hermes/ssh-agentd/bin/ssh-agentd
• 配置：/home/krex/.openclaw/ssh-agentd/hosts.yaml
• systemd：ssh-agentd.service
• 默认监听：127.0.0.1:18081

快速检查

bash
sudo systemctl is-enabled ssh-agentd.service
sudo systemctl is-active ssh-agentd.service
ss -ltnp | grep 18081
sudo systemctl status ssh-agentd.service --no-pager -l | sed -n 1,80p

启停与自启

bash
sudo systemctl daemon-reload
sudo systemctl enable --now ssh-agentd.service
sudo systemctl restart ssh-agentd.service
sudo systemctl stop ssh-agentd.service

API 调用要点

1) 默认使用 Bearer Token 鉴权（若配置启用）
2) 本机常有代理变量，调用本地 API 时必须绕过代理

推荐统一用脚本：scripts/api.sh

示例：运行远程命令

bash
SSHAGENTDTOKEN= \
scripts/api.sh POST /run {host:nas,cmd:hostname && whoami,timeoutSec:10}

示例：查看会话与指标

bash
SSHAGENTDTOKEN= scripts/api.sh GET /sessions
SSHAGENTDTOKEN= scripts/api.sh GET /metrics
SSHAGENTDTOKEN= scripts/api.sh GET /health

常见故障

1) 返回 401 unauthorized

• - 检查 apiAuth.enabled/token 配置
• 确认请求头 Authorization: Bearer

2) 调本地 API 返回 502

• - 原因：请求被系统代理劫持
• 处理：用 --noproxy * 或临时 unset 代理变量（脚本已内置）

3) run 失败且提示 host key/known_hosts

• - 原因：v1 已启用 HostKey 校验
• 处理：把目标主机 key 加入 known_hosts

安全约束

• - 不要把真实 token/密码写进 skill 文件。
• 不要把 hosts.yaml 放进仓库。
• 修改服务配置后必须重启并验证 status + /health + /sessions。