一、重新理解Skill上篇我们讲到Skill是让AI学会新技能。但有个重大误解需要澄清❌ 之前的误解很多人以为Skill是这样工作的Skill 配置文件 执行代码index.js ↓ 像函数调用一样直接执行✅ 正确的理解Skill Prompt模板 ↓ 告诉AI什么时候触发 触发后怎么做 ↓ AI自己决定调用什么Tool、如何处理结果Skill是给LLM的指令卡片不是可执行代码。AI会根据Skill中的Prompt来选择调用哪个Tool。二、Skill的核心机制2.1 SKILL.md的正确写法---name:stock_querydescription:查询股票实时行情---# Stock Query Skill当用户询问股票信息时使用此Skill。## 触发条件用户说股票、股价、查询XXX等## 执行步骤1. 识别股票名称或代码支持中文名称或6位代码 2. 使用 browser 工具访问金融网站获取数据 3. 解析返回的HTML提取当前价格、涨跌额、涨跌幅、成交量 4. 格式化输出为中文结果## 输出格式【股票名称】-当前价格¥XXX-涨跌▲/▼ XXX-涨跌幅▲/▼ XX%-成交量XX万手2.2 关键组成字段作用nameSkill唯一标识description一句话描述供AI判断是否调用正文Prompt核心指令告诉AI如何执行2.3 触发机制没有显式的trigger字段。触发靠的是description- AI根据描述判断是否适用正文Prompt- 描述触发场景用户输入- AI判断当前请求是否符合Skill场景三、实战开发股票查询Skill3.1 创建目录mkdir-p~/.openclaw/workspace/skills/stock-query3.2 编写SKILL.md---name:stock_querydescription:查询股票价格、涨跌幅、市值等实时行情---# 股票查询 Skill## 什么时候触发当用户询问以下内容时-查询XXX股票-XXX股价多少-XXX今天涨跌-股票代码XXX怎么样-推荐一支股票## 如何执行### 第1步识别股票-如果用户输入6位数字如600519直接作为股票代码-如果用户输入中文名称如茅台映射到代码-茅台/贵州茅台 → 600519-腾讯 → 00700-宁德时代 → 300750-比亚迪 → 002594-平安 → 601318### 第2步获取数据使用 browser 工具访问-A股https://finance.sina.com.cn/quote/{股票代码}.html 示例代码 // 使用 browser.navigate 访问页面 await browser.navigate(https://finance.sina.com.cn/quote/600519.html) // 使用 browser.evaluate 提取数据 const data await browser.evaluate(() {const price document.querySelector(.price).innerText; const change document.querySelector(.change).innerText; return{price,change};})### 第3步解析数据从页面提取以下信息-当前价格-涨跌额与开盘价对比-涨跌幅百分比-最高价、最低价-成交量、成交额-更新时间### 第4步格式化输出【贵州茅台】(600519) ┌─────────────┬──────────┐ │ 当前价格 │ ¥1689.00 │ │ 涨跌 │ ▲ 45.50 │ │ 涨跌幅 │ 2.77% │ │ 成交量 │ 12.5万手 │ └─────────────┴──────────┘## 注意事项-如果找不到股票回复抱歉未找到该股票信息请检查名称或代码是否正确-如果获取数据失败回复获取数据失败请稍后重试-保持输出简洁美观使用表格和emoji3.3 安装Skill# 复制到工作区cp-r~/.openclaw/workspace/skills/stock-query ~/.openclaw/workspace/agents/zebra-fish-workspace/skills/# 重启OpenClaw让Skill生效openclaw gateway restart3.4 测试# 测试1查询茅台openclaw agent--message查询贵州茅台股票今天怎么样# 测试2查询代码openclaw agent--message600519现在多少钱# 测试3问涨跌openclaw agent--message平安银行今天跌了多少四、进阶带工具配置的Skill如果你的Skill需要特定的API Key可以通过metadata配置---name:stock_prodescription:高级股票查询支持更多功能metadata:{openclaw:{requires:{env:[TIING_API_KEY]},primaryEnv:TIING_API_KEY,},}---# Stock Pro Skill需要使用付费金融API进行查询。五、多Skill协同当有多个相关Skill时AI会自动选择最合适的# Skill 1: stock_query---name:stock_querydescription:查询股票实时行情---# 股票查询当用户问股票价格、涨跌时触发...# Skill 2: stock_analysis---name:stock_analysisdescription:分析股票走势和技术指标---# 股票分析当用户问股票走势、技术分析、K线时触发...AI会根据用户意图和Skill描述自动匹配。六、常见问题Q1: Skill不触发检查description是否清晰描述了触发场景用户输入要包含Skill描述中的关键词重启Gateway让新Skill生效Q2: AI调用了错误的Tool在Prompt中明确指定使用哪个Tool添加Few-shot示例Q3: 如何调试使用openclaw agent --debug查看AI的决策过程查看日志openclaw logs更多内容如果你对AI开发、Agent实战感兴趣欢迎关注我的公众号【码头码农】每日AI热点解读实战项目复盘技术成长心得
OpenClaw进阶篇：手把手开发一个自定义Skill
发布时间：2026/5/25 22:24:38
一、重新理解Skill上篇我们讲到Skill是让AI学会新技能。但有个重大误解需要澄清❌ 之前的误解很多人以为Skill是这样工作的Skill 配置文件 执行代码index.js ↓ 像函数调用一样直接执行✅ 正确的理解Skill Prompt模板 ↓ 告诉AI什么时候触发 触发后怎么做 ↓ AI自己决定调用什么Tool、如何处理结果Skill是给LLM的指令卡片不是可执行代码。AI会根据Skill中的Prompt来选择调用哪个Tool。二、Skill的核心机制2.1 SKILL.md的正确写法---name:stock_querydescription:查询股票实时行情---# Stock Query Skill当用户询问股票信息时使用此Skill。## 触发条件用户说股票、股价、查询XXX等## 执行步骤1. 识别股票名称或代码支持中文名称或6位代码 2. 使用 browser 工具访问金融网站获取数据 3. 解析返回的HTML提取当前价格、涨跌额、涨跌幅、成交量 4. 格式化输出为中文结果## 输出格式【股票名称】-当前价格¥XXX-涨跌▲/▼ XXX-涨跌幅▲/▼ XX%-成交量XX万手2.2 关键组成字段作用nameSkill唯一标识description一句话描述供AI判断是否调用正文Prompt核心指令告诉AI如何执行2.3 触发机制没有显式的trigger字段。触发靠的是description- AI根据描述判断是否适用正文Prompt- 描述触发场景用户输入- AI判断当前请求是否符合Skill场景三、实战开发股票查询Skill3.1 创建目录mkdir-p~/.openclaw/workspace/skills/stock-query3.2 编写SKILL.md---name:stock_querydescription:查询股票价格、涨跌幅、市值等实时行情---# 股票查询 Skill## 什么时候触发当用户询问以下内容时-查询XXX股票-XXX股价多少-XXX今天涨跌-股票代码XXX怎么样-推荐一支股票## 如何执行### 第1步识别股票-如果用户输入6位数字如600519直接作为股票代码-如果用户输入中文名称如茅台映射到代码-茅台/贵州茅台 → 600519-腾讯 → 00700-宁德时代 → 300750-比亚迪 → 002594-平安 → 601318### 第2步获取数据使用 browser 工具访问-A股https://finance.sina.com.cn/quote/{股票代码}.html 示例代码 // 使用 browser.navigate 访问页面 await browser.navigate(https://finance.sina.com.cn/quote/600519.html) // 使用 browser.evaluate 提取数据 const data await browser.evaluate(() {const price document.querySelector(.price).innerText; const change document.querySelector(.change).innerText; return{price,change};})### 第3步解析数据从页面提取以下信息-当前价格-涨跌额与开盘价对比-涨跌幅百分比-最高价、最低价-成交量、成交额-更新时间### 第4步格式化输出【贵州茅台】(600519) ┌─────────────┬──────────┐ │ 当前价格 │ ¥1689.00 │ │ 涨跌 │ ▲ 45.50 │ │ 涨跌幅 │ 2.77% │ │ 成交量 │ 12.5万手 │ └─────────────┴──────────┘## 注意事项-如果找不到股票回复抱歉未找到该股票信息请检查名称或代码是否正确-如果获取数据失败回复获取数据失败请稍后重试-保持输出简洁美观使用表格和emoji3.3 安装Skill# 复制到工作区cp-r~/.openclaw/workspace/skills/stock-query ~/.openclaw/workspace/agents/zebra-fish-workspace/skills/# 重启OpenClaw让Skill生效openclaw gateway restart3.4 测试# 测试1查询茅台openclaw agent--message查询贵州茅台股票今天怎么样# 测试2查询代码openclaw agent--message600519现在多少钱# 测试3问涨跌openclaw agent--message平安银行今天跌了多少四、进阶带工具配置的Skill如果你的Skill需要特定的API Key可以通过metadata配置---name:stock_prodescription:高级股票查询支持更多功能metadata:{openclaw:{requires:{env:[TIING_API_KEY]},primaryEnv:TIING_API_KEY,},}---# Stock Pro Skill需要使用付费金融API进行查询。五、多Skill协同当有多个相关Skill时AI会自动选择最合适的# Skill 1: stock_query---name:stock_querydescription:查询股票实时行情---# 股票查询当用户问股票价格、涨跌时触发...# Skill 2: stock_analysis---name:stock_analysisdescription:分析股票走势和技术指标---# 股票分析当用户问股票走势、技术分析、K线时触发...AI会根据用户意图和Skill描述自动匹配。六、常见问题Q1: Skill不触发检查description是否清晰描述了触发场景用户输入要包含Skill描述中的关键词重启Gateway让新Skill生效Q2: AI调用了错误的Tool在Prompt中明确指定使用哪个Tool添加Few-shot示例Q3: 如何调试使用openclaw agent --debug查看AI的决策过程查看日志openclaw logs更多内容如果你对AI开发、Agent实战感兴趣欢迎关注我的公众号【码头码农】每日AI热点解读实战项目复盘技术成长心得
