前言¶
跑 OpenClaw 的主机一旦对外暴露,常见问题不是「有没有装防火墙」,而是审计项分散:SSH、网关配置、已装 Skill、更新状态各看各的,很难在一次对话里形成可执行的加固清单。手工查文档再拼命令,既慢也容易漏项。
下面介绍 SkillHub 上的 wukong-healthcheck-skill(坐标 @user_8211d795/healthcheck-skill)。它把 OpenClaw 主机安全加固与风险评估整理成标准 SKILL.md 工作流,由 Agent 按步骤引导检查、修复与复测;包内附带 Shell 脚本与示例,可在本机直接跑基础检测。
这是什么¶
wukong-healthcheck-skill 是面向 OpenClaw 主机 的安全加固与风险评估 Agent Skill。SkillHub 分类为 it-ops-security,来源为社区(community),发布者为 user_8211d795,当前商店版本 1.0.0,标签标明 不需要 API Key(requires_api_key=false)。
官方简介将其定位为:适用于安全审计、防火墙与 SSH 加固、更新管理、风险暴露检查、定时监控等场景;部署形态包括 VPS、云服务器、本地工作站、Docker 容器与沙盒环境。包内 package.json 声明运行环境为 OpenClaw >= 2026.1.29,主文档为 SKILL.md,维护方在文档中标注为 OpenClaw Community。
核心功能¶
以下能力均来自 SkillHub 简介与安装包内 SKILL.md、examples/、scripts/ 目录,可按模块理解 Agent 会引导你完成的工作。
主机安全评估与加固流程¶
SKILL.md 定义了从环境检测、安全审计到修复与复测的多步工作流(文档中按步骤编号组织,含进度与结果分级)。覆盖方向与官方简介一致:审计、暴露面与配置风险、防火墙与 SSH、更新状态等。
OpenClaw 原生命令(文档标明为当前可执行)¶
技能文档明确区分「真实 CLI」与「示例用虚构命令」。实际应优先使用:
openclaw status
openclaw status --all
openclaw security audit
openclaw security audit --deep
openclaw update status
openclaw update
文档同时说明:healthcheck --* 一类命令为示例用途,不是独立可执行的 CLI;openclaw config、openclaw cron 等需按你当前 OpenClaw 版本验证是否可用。
包内脚本与专项检测¶
安装目录下提供可执行脚本,用于环境识别与专项检查,例如:
| 路径(相对技能根目录) | 作用(据文档与脚本说明) |
|---|---|
scripts/quick-start.sh |
检测容器/服务器/本地环境,推荐后续检查方式并做基础项扫描 |
scripts/env-leak-detector.sh |
环境变量与敏感信息泄露检测(容器场景可用 --quick) |
scripts/one-click-hardening.sh |
一键加固相关流程(文档「自动加固」章节引用) |
scripts/security-checks.sh |
安全项检查集合 |
examples/scripts/basic-cve-check.sh |
基础 CVE 配置检查示例,可输出 JSON |
examples/scripts/malicious-skill-scan.sh |
已安装 Skill 的恶意/可疑模式扫描示例 |
examples/README.md 还列出配置审计、权限检查、云环境检测等示例脚本路径;examples/outputs/ 提供 JSON 样例,便于对照严重级别。
可视化与基线模板¶
包内包含 dashboard/(静态页面与 dashboard/api/),用于展示安全评分类信息(见 SKILL.md 中 Dashboard 章节)。templates/ 下有如 database-server.json、high-concurrency-web.json 等基线模板,供按场景套用检查项。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
按 SkillHub 安装说明 检查或安装:
command -v skillhub && skillhub --version
未安装时可执行完整安装(文档推荐):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
必须用 --dir 指向 Agent 实际读取的 skills 目录,否则默认装到 ./skills/ 可能不会被加载。
skillhub install @user_8211d795/healthcheck-skill --dir <你的 skills 目录>
常见路径(摘自 SkillHub 安装文档):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或项目下.agents/skills/
也可在对话中让 Agent 按官方提示安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8211d795/healthcheck-skill。
3. 启用后如何使用¶
安装完成后,重启或刷新 Agent 使技能生效。之后在对话中用自然语言描述场景即可,例如「对新 VPS 做 OpenClaw 部署前安全审计」「检查 SSH 与网关暴露配置」。Agent 会读取 SKILL.md 并按工作流调用上述 openclaw 命令或包内脚本。
SkillHub 页面:https://www.skillhub.cn/skills/user_8211d795/healthcheck-skill
API 资源地址:https://api.skillhub.cn/user_8211d795/healthcheck-skill
典型用法¶
方式一:通过 Agent 对话(推荐入口)¶
安装到 skills 目录后,直接说明环境与目标,由技能文档驱动步骤选择与结果解读。适合你不熟悉全部审计项、希望有修复优先级与复测建议的场景。
方式二:本机先跑快速入门脚本¶
进入技能安装目录后执行快速启动,用于识别环境并跑基础检查:
cd <skills 目录>/@user_8211d795/healthcheck-skill
chmod +x scripts/quick-start.sh
./scripts/quick-start.sh
SKILL.md 中的环境对照建议:
- 容器:优先
./scripts/env-leak-detector.sh --quick - 服务器:
openclaw security audit - 本地:
./scripts/env-leak-detector.sh
方式三:运行示例 CVE / Skill 扫描脚本¶
examples/README.md 给出的可复现步骤:
cd <skills 目录>/@user_8211d795/healthcheck-skill
chmod +x examples/scripts/basic-cve-check.sh
./examples/scripts/basic-cve-check.sh
chmod +x examples/scripts/malicious-skill-scan.sh
./examples/scripts/malicious-skill-scan.sh
脚本会在终端输出分级结果,并在末尾提供 JSON 便于接入 CI 或存档。examples/README.md 示例:将 JSON 中的 summary.critical_count 与 0 比较以决定是否阻断部署。
方式四:深度审计与更新¶
在已安装 OpenClaw CLI 的主机上:
openclaw security audit --deep
openclaw update status
openclaw update
自动加固类操作应结合 SKILL.md 中的确认步骤;文档对生产环境、沙盒只读等场景有单独说明。
适用场景与注意¶
适合谁
- 刚购入 VPS/云主机、准备部署 OpenClaw,需要初始化安全基线。
- 需要定期做配置与暴露面审计,或响应 CVE/Skill 供应链相关检查。
- 在 Docker 或本地工作站运行 OpenClaw,希望用同一套检查清单。
限制与坑
- 命令别混用:README 与
SKILL.md中的healthcheck --deep等仅为示例叙述;实际操作以openclaw security audit及包内脚本为准。 - 权限与环境:
SKILL.md「适用边界」指出 Windows、无权限环境、高并发生产、沙盒等场景功能受限或仅适合只读/低峰检查。 - 版本信息:SkillHub 商店版本为 1.0.0;包内
SKILL.mdfront matter 与package.json可能带有不同的内部版本号,以你skillhub install得到的目录内容为准。 - 自动修复:文档对 Docker、沙盒等环境标注不宜盲目自动修复;生产环境建议先只读审计,再按文档 Tier 分级执行。
- 网络与依赖:部分示例脚本会调用
openclaw config get等命令;examples/README.md写明需 OpenClaw 版本兼容,且部分检查依赖读取本地 OpenClaw 配置目录权限。
SkillHub 统计(以抓取资料为准):评分 100000,下载 981 次,安装 1 次。
结尾¶
wukong-healthcheck-skill 把 OpenClaw 主机安全从「零散命令」收敛成 Agent 可执行的 SKILL.md 流程,并附带脚本、示例输出与 Dashboard 资源。若你已在用 Cursor、Claude Code 等支持 Skills 的客户端,按上文安装到对应 skills 目录后,即可从一次 openclaw security audit 或 quick-start.sh 开始建立基线。
官方入口:
- SkillHub:https://www.skillhub.cn/skills/user_8211d795/healthcheck-skill
- 坐标:
@user_8211d795/healthcheck-skill