免费版

管理并调用OpenRouter免费AI模型，支持自动化工作流和多场景应用，适合开发者和团队零成本使用。

Install

openclaw skills install @thcjp/free-ride

功能说明: 本技能涵盖化工作流场景等核心能力。

Free Ride

付费版扩展能力

能力	免费版	付费版
基础功能	支持	支持
Free RideSkillHub管理	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持

典型场景

场景	输入	输出
模型调用	输入文本与模型参数	模型输出与用量统计
管理操作	操作目标与参数	操作结果与状态变更
为SkillHub管	目标数据与配置参数	处理结果与执行状态

不适用于：需要人工判断的复杂决策场景

输入定义

参数名	类型	必填	说明
content	string	否	free-ride处理的内容输入
mode	string	否	处理模式, 可选: json/text/markdown,
max_retries	integer	否	单步最大重试次数, 默认: 2
skip_steps	array	否	跳过的步骤编号(用于断点续传), 默认: []

输出规范

json

{
  "success": true,
  "data": {
    "final_result": {
      "ride_result": "ride_result_value",
      "ride_metadata": "ride_metadata_value",
      "ride_status": "ride_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/free-ride_template

安装与配置

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

分类: MD+execute()
说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

功能边界

需要API Key，无Key环境无法使用

创新优势

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
模型调用	30分钟	5分钟	25分钟	5%
数据同步	2小时	30分钟	1.5小时	3%
工作流管理	1小时	15分钟	45分钟	2%
异常处理	2小时	30分钟	1.5小时	4%
报告生成	1小时	10分钟	50分钟	1%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
成本	低	高	中	高
效率	高	低	中	高
准确率	高	低	中	高
可定制性	中	低	高	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
手动操作繁琐	需要大量人工操作，效率低下	整体工作效率	自动化处理，减少人工操作	时间节约25%
数据同步困难	数据在不同系统间同步困难，影响决策	数据准确性	自动化数据同步，提高数据准确性	准确率提升3%
工作流管理复杂	工作流管理复杂，难以维护	工作流效率	简化工作流管理，提高工作效率	时间节约45%

常见问题FAQ

Q1: 免费版支持哪些AI模型？

A: 免费版支持OpenRouter提供的多种免费AI模型，包括文本分析、图像识别、语音识别等。

Q2: 如何在免费版中调用AI模型？

A: 在AI Agent对话中调用本技能，提供必要的输入参数，即可调用AI模型。

Q3: 免费版的调用频率有限制吗？

A: 免费版对调用频率没有限制，但可能会受到系统资源的影响。

Q4: 免费版支持断点续传吗？

A: 免费版支持断点续传功能，当操作中断时，可以继续执行，无需从头开始。

Q5: 免费版的数据安全性如何保障？

A: 免费版采用加密传输和存储，确保用户数据的安全性和隐私性。

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
调用失败	网络连接问题	检查网络连接，重试调用	确保网络连接正常
输出结果错误	输入数据格式错误	检查输入数据格式，提供正确格式	提供正确格式的输入数据
处理超时	系统资源不足	检查系统资源，优化处理流程	优化处理流程，增加系统资源
断点续传失败	缓存数据损坏	检查缓存数据，重新开始	清除旧缓存，重新开始
异常处理失败	异常处理逻辑错误	检查异常处理逻辑，修复错误	修复异常处理逻辑

安全规则

确保输入数据的安全性，避免敏感信息泄露。
定期更新AI模型，以保持模型的准确性和安全性。
限制对AI模型的访问权限，防止未授权访问。
对用户数据进行加密存储和传输，保护用户隐私。
监控系统日志，及时发现并处理异常情况。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

异常处理框架

针对"免费版"使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

"免费版"通用排查步骤

检查输入参数: 确认所有必填参数已提供且格式正确
查看日志输出: 定位具体错误行和异常类型
验证环境配置: 确认依赖库版本和运行环境满足要求
逐步调试: 缩小问题范围,隔离故障模块

上线流程

配置API密钥: 在环境变量中设置对应的API Key
初始化连接: 使用提供的凭证建立API连接
调用接口: 传入必要参数执行API调用
准备文件: 确认文件路径正确且格式受支持
执行处理: 调用对应的处理函数
查看结果: 检查输出文件或返回数据
检查环境: 确认运行时和依赖已安装
执行命令: 使用正确的参数格式执行
查看输出: 检查命令输出和退出码

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

免费版