by 安全扫描
OpenClaw
安全
medium confidence该技能的代码和运行指令与其声明的目的（重试、降级、审计）一致，没有明显的无关凭证请求或隐藏的网络/数据外泄行为，但包中有一些小的代码问题，并将日志/配置写入磁盘，建议在生产使用前在沙盒环境中review和测试。
评估建议
该技能看似与其声明的目的一致。安装前，请做以下事项：1) 在隔离环境中运行测试套件和示例，确认运行时行为。2) 审查注册的备份函数（fallback.register_backup），确保不调用不受信任的远程端点或处理秘密。3) 注意包中文件的少量实现问题——预期潜在运行时错误，先在沙盒中运行。4) 如果在共享位置存储日志，请确保不记录敏感数据或进行编辑。如果想要更高的保证，请请求完整的未截断源代码或进行安全代码审查，重点关注文件I/O和用户提供的回调执行路径。...详细分析 ▾
✓ 用途与能力
名称/描述（为ClawHub代理提供重试、降级）与提供的模块（retry_handler、exception_classifier、fallback_manager、degradation_handler、audit_logger、config_manager）匹配，没有无关的必需二进制文件、环境变量或配置路径声明。
ℹ 指令范围
SKILL.md和示例限制了配置和调用本地重试/降级逻辑以及导出日志的动作。示例代码显示调用外部API（占位符https://api.example.com），但这是用户驱动的示例代码——技能本身不嵌入隐藏的远程端点或指示代理读取无关的系统状态。技能将写入日志和配置到磁盘（./logs和可配置路径）并可以导出文件；考虑这些文件存储的位置。
✓ 安装机制
元数据中没有安装规格（SKILL.md中推荐通过pip -r requirements.txt进行指令安装）。requirements.txt列出了小型、知名的Python包（retry、pyyaml、python-json-logger）。没有迹象表明存在不安全的外部安装程序或任意下载URL。
✓ 凭证需求
技能没有声明所需的环境变量或凭证。代码与本地文件系统（日志、配置）交互并加载本地YAML配置；这与其目的一致。审查的文件中没有意外的凭证访问。
✓ 持久化与权限
技能没有请求always: true或其他高级平台权限。它持久化日志并可选地在提供的路径下写入配置文件（save_config）；这与审计/配置管理器一致，不是权限提升。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.12026/3/14
修复bug并完善文档
● 无害
安装命令 点击复制
官方npx clawhub@latest install clawhub-retry-fallback
镜像加速npx clawhub@latest install clawhub-retry-fallback --registry https://cn.clawhub-mirror.com
技能文档
为ClawHub平台Agent任务提供完整的容错兜底机制，实现「异常可感知、失败可重试、无招可兜底」的闭环。
核心功能
| 功能模块 | 说明 | PRD对应 |
|---|---|---|
| 全局重试策略配置中心 | 支持指数退避、固定间隔、自定义间隔策略 | 4.1节 |
| 异常类型智能识别引擎 | 自动区分可重试/不可重试异常 | 4.2节 |
| 备用工具自动切换 | 智能匹配备用工具池，自动参数映射 | 4.3节 |
| 三级降级处理机制 | 轻度/中度/重度降级策略 | 4.4节 |
| 全流程执行日志 | 支持导出Excel/PDF，满足审计要求 | 4.5节 |
快速开始
from scripts.retry_handler import RetryHandler
handler = RetryHandler()
@handler.with_retry(max_attempts=3, backoff_strategy='exponential')
def my_api_call():
# 你的API调用
return requests.get('https://api.example.com/data')
# 自动重试执行
result = my_api_call()
安装
pip install -r requirements.txt
项目结构
... （此部分保持原文未翻译，仅示意）运行测试
cd tests
python test_retry_handler.py # 预期输出: # Ran 22 tests in X.XXXs # OK
运行示例
cd examples
python basic_usage.py # 输出9个完整示例
详细文档
请参考README.md 获取：
- 完整API参考文档
- 9个渐进式使用示例
- 配置文件说明
- 异常分类规则库
- 高级用法指南
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制