📦 Hope — 希望
v1.0.0ClientHope Server Max API 客户端技能，用于向 Hope Server Max 服务端发起 API 请求。
0· 18·0 当前·0 累计
by 下载技能包
最后更新
2026/4/20
安全扫描
OpenClaw
可疑
high confidence该技能看起来像一个 API 客户端，但存在多处不一致（未记录的环境/二进制依赖、硬编码凭据、使用 sshpass），与其注册元信息不符，并引发安全问题。
评估建议
该技能本质上是一个内部服务的 API 客户端，但存在多处警示，安装或使用前请务必注意：
- 元数据不匹配：注册表未声明所需 env 或二进制文件，而 SKILL.md 与脚本却依赖 HOPE_API_KEY、HOPE_HOST、HOPE_PORT，并调用 ssh/sshpass/curl。请作者更新 manifest。
- 硬编码默认值：SKILL.md 与脚本内含默认 API key 与 SSH 密码，可能是泄露的凭据或带来未授权访问。勿依赖默认值，要求维护者移除硬编码凭据。
- sshpass 与明文密码：脚本使用 sshpass 并明文写入默认密码 ‘hope’。优先使用 SSH 密钥，避免明文密码自动化。确认 sshpass 是否必需，能否改用 SSH 密钥。
- 未声明的二进制依赖：确保运行环境已安装 ssh、curl（及可能需要的 sshpass）。技能应声明这些依赖。
- 作用域检查：脚本会 SSH 到某主机并在该主机上 curl 127.0.0.1（横向访问）。若确为管理工具需确认信任目标主机与网络。
建议操作：
1. 要求技能作者修正 m...详细分析 ▾
⚠ 用途与能力
声明用途仅为一个简单的 Hope Server Max API 客户端，理应需要 HOPE_HOST/HOPE_PORT 和 API key。然而 registry 元数据未列出任何必需的环境变量或二进制文件，而 SKILL.md 和脚本却明显依赖 HOPE_API_KEY、HOPE_HOST、HOPE_PORT，并使用远程 SSH + curl。脚本还默认使用特定主机（hope05）和 API key 值——这些硬编码默认值与 registry 清单不符且出乎意料。
⚠ 指令范围
SKILL.md 及其附带脚本指示 agent 使用 sshpass SSH 登录主机，并在远程主机上对 127.0.0.1 执行 curl。说明中既要求从 ~/.openclaw/.env 加载环境变量，又在示例和脚本里直接写死了凭据。运行时指令引用了 HOPE_SSH_PASS（sshpass 使用），但该变量在 registry 元数据中并未记录。用 sshpass 传递明文密码（默认 'hope'）并远程执行 curl，超出了最小 API 客户端范畴，扩大了技能的操作范围。
ℹ 安装机制
没有安装规范（仅含指令与附带 helper 脚本），因此安装时不会下载任何内容，降低了安装器风险；但提供的脚本依赖外部二进制文件（sshpass、ssh、curl）却未声明——该 skill 假定主机环境具备这些能力，却未在依赖中声明。
⚠ 凭证需求
注册表未列出必需的环境变量，但 SKILL.md 元数据与脚本却使用了 HOPE_API_KEY、HOPE_HOST、HOPE_PORT 和 HOPE_SSH_PASS；脚本还嵌入了默认的 HOPE_API_KEY 和默认 SSH 密码。在未声明的情况下请求或嵌入凭据（即使是默认值）既不恰当又存在风险：默认值可能敏感或导致非预期访问，且使用 sshpass 意味着明文处理密码。
✓ 持久化与权限
该 skill 未设置 always:true，不修改其他 skill 的配置，安装时无持久化。仅在调用时运行，不申请高系统权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/20
hope-client 初始版本发布。 - 提供与 Hope Server Max API 交互的 client skill。 - 支持频道、上传、下载、账户及引擎管理等核心 API。 - 包含详尽的认证与服务器连接环境变量配置。 - 提供即用 bash 函数，便于常见查询与自动化。 - 附带清晰使用场景及标准化状态码说明。 - 专为内网（SSH）环境设计，所有请求须携带 API key。
● 可疑
安装命令
点击复制官方npx clawhub@latest install hope-client
镜像加速npx clawhub@latest install hope-client --registry https://cn.longxiaskill.com镜像同步中
技能文档
Hope Server Max API 客户端技能。用于发起对 Hope Server Max 服务端的 API 请求。
环境变量配置
OpenClaw 自动加载~/.openclaw/.env 文件中的环境变量：
``bash
# ~/.openclaw/.env
HOPE_API_KEY=hope-openclaw-apikey-2026-0411
HOPE_HOST=hope05
HOPE_PORT=8088
`
加载优先级（官方文档）：
- 进程已存在的环境变量（不会被覆盖）
CWD.env文件~/.openclaw/.env文件
技能脚本通过环境变量读取配置：
| 环境变量 | 说明 | 默认值 |
|----------|------|--------|
| HOPE_API_KEY | Hope Server Max API Key | - |
| HOPE_HOST | 服务器地址 | hope05 |
| HOPE_PORT | 服务端口 | 8088 |
认证方式
所有请求必须携带 X-OpenClaw-Key 请求头：
`bash
# 使用环境变量
curl -H "X-OpenClaw-Key: $HOPE_API_KEY" \
http://$HOPE_HOST:$HOPE_PORT/system/channel/list
`
从本地通过 SSH 调用：
`bash
sshpass -p 'hope' ssh $HOPE_HOST \
"curl -s -H 'X-OpenClaw-Key: $HOPE_API_KEY' http://127.0.0.1:$HOPE_PORT/system/channel/list"
` ---
API 接口文档
1. 频道管理 (Channel)
1.1 查询频道列表
`
GET /system/channel/list
`
查询参数：
channelName- 频道名称（可选）channelType- 频道类型：bili、youtube、xigua（可选）channelOffOn- 启用状态：on、off（可选）pageNum- 页码（默认 1）pageSize- 每页数量（默认 10）
响应示例：
`json
{
"total": 88,
"rows": [
{
"channelId": 267,
"channelName": "CopyCat-bili",
"channelType": "bili",
"channelOffOn": "on",
"cookieEnable": "true",
"engineId": 3,
"engineName": "hope03"
}
],
"code": 200,
"msg": "查询成功"
}
`
1.2 获取所有频道名称
`
GET /system/channel/listAllNames
` 1.3 搜索频道名称
`
GET /system/channel/searchNames?channelName=Copy
` 1.4 获取频道详情
`
GET /system/channel/{channelId}
` 1.5 频道统计信息
`
GET /system/channel/statistics
` 1.6 刷新频道 Cookie
`
POST /system/channel/refresh/{channelId}
` ---
2. 上传实例 (Upload Instance)
2.1 查询上传实例列表
`
GET /system/instance/list
` 2.2 获取上传实例详情
`
GET /system/instance/{instanceId}
` 2.3 查询上传趋势数据
`
GET /system/instance/queryTrend
` 2.4 查询失败排行列表
`
GET /system/instance/failList
` 2.5 查询失败日志
`
POST /system/instance/queryFailLog
` ---
3. 下载实例 (Download Instance)
3.1 查询下载实例列表
`
GET /system/downloadInstance/list
` 3.2 获取下载实例详情
`
GET /system/downloadInstance/{pkInstanceId}
` 3.3 查询待上传视频列表
`
GET /system/downloadInstance/pending
` 3.4 统计待上传视频数量
`
GET /system/downloadInstance/pending/count
` 3.5 查询下载趋势数据
`
GET /system/downloadInstance/trend
` 3.6 更新清理状态
`
PUT /system/downloadInstance/clean/{pkInstanceIds}
` ---
4. 账户管理 (Account)
4.1 查询账户列表
`
GET /system/account/list
` 4.2 获取账户详情
`
GET /system/account/{accId}
` ---
5. 引擎管理 (Engine)
5.1 查询引擎列表
`
GET /system/engineInfo/list
` 5.2 获取所有引擎信息
`
GET /system/engineInfo/listAll
` 5.3 获取引擎详情
`
GET /system/engineInfo/{engineId}
` ---
快速调用函数
技能提供以下快捷调用函数（写入 scripts/api_client.sh）：
基础调用
`bash
hope_api() {
local endpoint="$1"
local params="${2:-}"
sshpass -p 'hope' ssh hope@hope05 \
"curl -s -H
``