TS-OPI与OpenClaw:天软函数如何发布为AI的SKILL

上一篇文章我们介绍了TS-OPI的使用方法，本篇我们将介绍TS-OPI与AI相关的应用是如何碰撞出火花的。

SKILL可以把它看作一份给AI的“标准化作业指导”，让AI知道“当遇到什么情况时，该去做什么事”。当一个SKILL被激活，AI会读取这份说明，并自行调用底层工具来执行任务。

SKILL的核心内容有两个：一个是SKILL.md 文件，另一个是对应的可执行的API。

我们有了一个可执行的函数，那么我们的创建流程应该是：

1. 创建一个函数可调用的API

2. 编写SKILL.md

3. 测试及更新

4. SKILL发布

2.1    创建函数的API

我们以一个最简单的例子来说明：我们有一个输入参数a和b，输出a+b的函数，他们有默认值（a=15，b=100），命名为plus：

现在我们希望把这个函数发布为可以在OpenClaw中使用的技能。

首先需要将“函数plus”设置为一个可以通过http接口访问的API ;

同时，为访问该API的用户生成session-key，并设定好相关访问权限、调用配额、白名单；

天软函数发布为API，并生成对应的session-key，需要通过“天软租户管理系统”进行，具体步骤可参考上一篇TS-OPI的介绍。

2.2    编写核心文件SKILL.md

接下来，我们需要为上边的这个API,做一份说明文档，为AI提供使用指南。

• 告诉AI底层的函数信息（代码示例、参数格式、注意事项）

• 告诉AI这个skill工具的用途和场景和调用方法（触发条件、调用范例）

• 告诉AI返回结果格式（也可增加对结果的解析）

我们在目录下创建SKILL.md，用文本编辑器打开。

整个文件分为两大部分：

2.2.1 头部源数据

name：SKILL名称，必须与文件夹名字相同。

description：一句话说明技能用途。这是AI判断是否启用该SKILL的关键。要包含用户可能说的关键词，如“a”，“b”，求和等。

2.2.2 Markdown正文

正文要写清楚：参数说明、返回值含义以及 调用行为约定相关说明。

以我们这次plus为例：由于我们在函数里是有设置默认值的，在接受用户的输入参数的情景，MD文档描述需要特别约定：

• 其中天软API的访问地址为：https://opi.tinysoft.com.cn/Service/Session/Call/函数名

• 认证所需要的“Bearer Token ”，就是前边生成API时对应的“session-key”。

• 天软的函数API，既支撑命名参数的传入，也支撑无命名参数传入。对应的是不同的请求体结构：

命名参数模式：{“parama”:1,”paramb”:[“SZ000001”]}模式。即对每个具体的参数进行赋值，未指定的参数会采用TSL函数的默认参数值。

无命名参数模式：[param1,param2,…]。即按顺序对每个参数进行赋值。

至此，一个最基本的SKILL.MD就编辑好了。

2.3    Skill安装、测试及更新

2.3.1 Skill安装

只需要将“SKILL.MD”递给“OpenClaw”安装,它就可以开始工作了。

2.3.2 Skill功能测试

我们可以通过对话测试一下是否创建成功:

2.3.3 Skill功能更新

当我们对SKILL对应的后台模型进行了修改，只需要一句话，即可更新SKILL.MD.

2.4    Skill的发布

2.4.1 方法一：直接分享Skill包

可以直接把Skill.md以及相关文件压缩成zip，直接给OpenClaw对话更新。

1）如果Skill需要验证，那还需要把对应的session-key给到OpenClaw。

2）技能里不需要包含天软账号和密码。

2.4.2 方法二：发布到ClawHub（推荐）

ClawHub是OpenClaw的官方技能仓库。发布后其他用户可直接安装使用。

前面介绍的是一个最基本的加法例子,说明了天软函数创建SKILL的全过程。而当一个函数包含了金融数据等内容，那么在编写md文档时，参数的说明中需要针对“证券代码的格式说明”和“时间日期参数”加以描述。

我们在天软平台开发了一个函数GetEY——通过输入股票代码与日期，来返回股票名称与对应的盈利收益率。

这个函数对应的MD 文档说明如下：

这里的关键在于：

1. 需要告知open claw，天软的函数的代码参数的标准格式，以便调用的时候进行转换；

2. 需要告知open claw，对各种格式的时间表达（20260424，2026-04-24，“今天”）转化天软函数可识别的时间参数的标准格式。

4.1    SKILL.MD文档内容的重要性

请认真的撰写你的SKILL.MD中的一些说明，并给AI以引导！

AI 确实“能干”，OpenClaw会自己尝试各种调用方式来调用这个SKILL, 经过多轮尝试后，也可以把正确的调用过程自动更新到md中。但这样既浪费时间，也浪费“TOKEN”。

4.2    SKILLS需要专业的金融数据支持

当我们用通用AI做数据分析时，需要保障基础数据的准确性，如果AI工具从你提供的SKILL工具中不能获得全部的数据，它就会自行寻找和填补！！

我们可以看看诚实的大模型是怎么说的：

TS-API 可以获得及时、准确、全面的金融数据，TS-API包含了专业的金融分析指标库，TS-API还具有高效的计算性能和访问性能。

利用TS-OPI 封装SKILL，等于给 AI应用配了一个专业的金融数据中台和金融数据计算底座。

欢迎新老朋友尝试构造自己的AI金融数据分析师！