宝塔 OpenClaw 怎么做安全体检?btclawscan 技能 6 大模块本地扫描
给 OpenClaw(昵称「龙虾」)装了各种技能之后,很多人会冒出一个问题:这些技能到底安不安全? 官方给的答案是一个本地体检技能 btclawscan——纯本地检测、不依赖任何外部 API、数据不出设备,5 分钟扫完 6 大模块,给龙虾出一份安全报告。下面按官方教程讲怎么装、怎么跑、报告怎么看。
btclawscan 是什么:本地体检,数据不出设备
btclawscan 是 OpenClaw 的一个安全体检技能,专做「自己给自己体检」。它的两个关键特性是:
- 纯本地检测:不依赖任何外部 API,扫描过程中数据不出设备。
- 6 大模块:一次跑完配置审计、Skill 风险、版本基线、隐私检测、网络出口、SOUL.md 安全规则。
为什么需要它?官方教程的原话是:龙虾只是个执行者,技能是用户装的,「万一里面有个 rm -rf 呢?万一偷偷发数据到外网呢?」——体检就是用来把这些隐患扫出来。
怎么安装:从官方源拉取 SKILL.md
先创建技能目录,再从官方源拉取 SKILL.md:
# 创建技能目录
mkdir -p ~/.openclaw/workspace/skills/btclawscan
# 拉取 SKILL.md
curl -o ~/.openclaw/workspace/skills/btclawscan/SKILL.md \
https://allinssl.bt.cn/btclawscan/SKILL.md
也可以直接对龙虾说人话,让它自己装:
帮我安装 btclawscan 技能,从 https://allinssl.bt.cn/btclawscan/SKILL.md 拉取
怎么运行:两种方式
安装完成后有两种运行方式:
# 方式 1:提取脚本后运行
grep -A 1000 '^```python$' ~/.openclaw/workspace/skills/btclawscan/SKILL.md | \
grep -B 1000 '^```$' | head -n -1 | tail -n +2 > /tmp/scanner.py
python3 /tmp/scanner.py
方式 2 更简单,直接对龙虾说:
帮我做个安全体检
体检报告包含 6 大模块
btclawscan 一次扫 6 个维度,官方给出的模块与风险等级如下:
| 模块 | 检查内容 | 风险等级 |
|---|---|---|
| 配置审计 | Gateway 状态、凭证存储、会话安全 | 高危 → 极高 |
| Skill 风险 | 扫描所有技能脚本,检测恶意代码 | 中危 → 极高 |
| 版本基线 | Node.js、Chrome、OpenClaw 版本 | 信息类 |
| 隐私检测 | 核心文件权限(MEMORY.md 等) | 中危 |
| 网络出口 | 技能中的外网请求,区分白名单/黑名单 | 高危 |
| SOUL.md 安全规则 | 检查是否包含安全规则章节 | 中危 |
其中 Skill 风险和配置审计是重点关注对象——它们的风险上限都是「极高」,一旦技能脚本里藏了恶意代码,或凭证存储、会话配置有问题,影响面最大。
报告怎么看:一个示例
官方教程给了一份报告示例,结构是这样(评分为示例值):
# 🏥 BTclawScan OpenClaw 安全体检报告
📅 2026-03-24 18:00
🖥️ OpenClaw 1.2.3 · Node v24.12.0 · Linux
📦 安全评分:85/100 — 基于配置、技能、隐私、网络四维评估
| 检查项 | 状态 | 详情 |
|--------|------|------|
| 配置审计 | ✅ 通过 | 0 项配置问题 |
| Skill 风险 | ⚠️ 需关注 | 0 个高危、2 个需关注、5 个安全 |
| 隐私泄露风险 | ✅ 未见明显风险 | 1 项需关注 |
| 网络出口 | ✅ 安全 | 3 个出口,3 个白名单 |
| SOUL.md 安全规则 | ⚠️ 需关注 | 缺少安全规则章节 |
| 综合评估 | 🟢 低风险 | 建议定期体检 |
报告的关键在最后几列:哪些项「✅ 通过」、哪些项「⚠️ 需关注」、综合评估是什么等级。有 ⚠️ 的项不用慌,按详情逐个处理即可。
常见坑:Python 没装、高危项、从不体检
官方教程列了 4 个踩坑记录,这里挑最常见的三个说:
- Python 未安装——运行会直接失败。避法是先装好:
apt install python3(Debian/Ubuntu)或brew install python3(macOS)。 - 报告显示高危技能——可能存在安全隐患。避法是看报告里的具体说明,优先处理 ⛔ 极高和 🔴 高危项。
- 从不体检——养了半天不知道龙虾有没有后门。避法是养成习惯,每月体检一次。
还有一个和安全直接相关:如果报告提示 SOUL.md 缺少安全规则章节,意味着可能被提示词注入、Skills 投毒攻击,回复「添加安全规则」即可自动加固 SOUL.md。
体检这件事,官方教程里的建议很直接:养成每月体检一次的习惯。装了技能却不知道里面有什么,才是最危险的。
常见问题
btclawscan 是什么?
btclawscan 是 OpenClaw(龙虾)的本地安全体检技能,纯本地检测、不依赖外部 API、数据不出设备,5 分钟跑完 6 大模块,给龙虾出一份安全报告。
btclawscan 怎么安装?
创建技能目录后从官方源拉取 SKILL.md:mkdir -p ~/.openclaw/workspace/skills/btclawscan 然后 curl 下载 https://allinssl.bt.cn/btclawscan/SKILL.md,或者直接对龙虾说「帮我安装 btclawscan 技能」。
体检都检查哪些方面?
共 6 大模块:配置审计、Skill 风险、版本基线、隐私检测、网络出口、SOUL.md 安全规则,覆盖凭证存储、技能脚本恶意代码、核心文件权限、外网请求白黑名单等。
体检报告发现高危项怎么办?
优先处理 ⛔ 极高和 🔴 高危项,报告里会给出具体说明。如果 SOUL.md 缺少安全规则,回复「添加安全规则」即可自动加固。
运行时报错怎么办?
最常见是没装 Python,运行前先 apt install python3(Debian/Ubuntu)或 brew install python3(macOS)。
多久体检一次合适?
官方建议养成每月体检一次的习惯,避免装了技能却不知道里面有没有隐患。