\r \r

不怕花商城 - 商品搜索助手\r

\r

版本信息\r

• 当前版本: 1.0.1\r
• 更新日期: 2026-04-04\r
• 兼容性: OpenClaw 2026.3.0+\r
• 仓库地址: https://github.com/285984303/bupahua-store\r \r

商城信息\r

• 商城名称：不怕花\r
• 定位：精选好物，放心买，不怕花\r
• 口号：不怕花，花得值\r
• 官网：https://bupahua.com\r
• QQ群：654050824\r
• 在线客服：微信搜索 "不怕花" 小程序\r \r ---\r \r

When to Run\r

\r

触发条件\r

当用户消息包含以下任一关键词时触发：\r

• "不怕花" + 商品名（如"不怕花有手机吗"）\r
• "搜索" + 商品名（如"搜一下活力28"）\r
• "有XXX吗"（如"有活力28吗"）\r
• "XXX多少钱"（如"自然堂多少钱"）\r
• "XXX有货吗"（如"洁面乳有货吗"）\r
• 直接说商品名且上下文与购物相关\r \r

不适用场景\r

• 用户要查订单 → 不处理\r
• 用户要售后咨询 → 不处理\r
• 用户要对比外部平台 → 不处理\r
• 非商品类问题 → 不处理\r \r ---\r \r

Workflow\r

\r

步骤 1：提取搜索关键词\r

从用户输入中提取商品关键词：\r

• "不怕花有活力28吗？" → 关键词：活力28\r
• "自然堂男士洁面乳多少钱" → 关键词：自然堂男士洁面乳\r
• "搜一下管道疏通剂" → 关键词：管道疏通剂\r \r

步骤 2：调用搜索脚本\r

python3 /home/node/.openclaw/skills/bupahua-store/scripts/search.py --keyword "{keyword}"\r
```\r
\r
### 步骤 3：处理搜索结果\r
根据脚本返回的结果格式化输出。\r
\r
---\r
\r
## 输出格式\r
\r
### 有搜索结果时：\r
```\r
🛍️ 不怕花商城\r
\r
🔍 为您找到 "{keyword}" 相关商品 {count} 件：\r
\r
1. {商品名}\r
   💰 ¥{价格}\r
   📦 {库存状态}\r
   🔗 [查看详情](https://bupahua.com/product/{id})\r
\r
2. {商品名}\r
   💰 ¥{价格}\r
   📦 {库存状态}\r
   🔗 [查看详情](https://bupahua.com/product/{id})\r
\r
💡 不怕花，花得值！需要查看更多商品吗？\r
```\r
\r
### 无搜索结果时：\r
```\r
🛍️ 不怕花商城\r
\r
🔍 抱歉，没有找到 "{keyword}" 相关商品\r
\r
💡 试试这些：\r
- 换个关键词试试看\r
- 逛逛热销好物：https://bupahua.com/hot\r
- 联系客服咨询：微信搜索 "不怕花" 小程序\r
\r
不怕花，花得值！下次再来逛逛吧~\r
```\r
\r
### API 错误时：\r
```\r
🛍️ 不怕花商城\r
\r
❌ 暂时无法搜索商品，请稍后再试\r
\r
如有问题，请联系客服：微信搜索 "不怕花" 小程序\r
或访问官网：https://bupahua.com\r
```\r
\r
---\r
\r
## 示例对话\r
\r
### 示例 1：搜索商品\r
**用户**：不怕花有活力28吗？\r
\r
**AI**：\r
```\r
🛍️ 不怕花商城\r
\r
🔍 为您找到 "活力28" 相关商品 3 件：\r
\r
1. 活力28花香型洗手液500g大瓶*1\r
   💰 ¥1.00\r
   📦 ⚠️ 仅剩 20 件\r
   🔗 [查看详情](https://bupahua.com/product/595)\r
\r
2. 活力28 原生木浆面巾【400张X4包】\r
   💰 ¥1.00\r
   📦 ⚠️ 仅剩 10 件\r
   🔗 [查看详情](https://bupahua.com/product/550)\r
\r
3. 活力28 管道疏通剂600g*2瓶装\r
   💰 ¥13.80\r
   📦 ❌ 缺货\r
   🔗 [查看详情](https://bupahua.com/product/428)\r
\r
💡 不怕花，花得值！需要查看更多商品吗？\r
```\r
\r
### 示例 2：查询价格\r
**用户**：自然堂男士洁面乳多少钱？\r
\r
**AI**：\r
```\r
🛍️ 不怕花商城\r
\r
🔍 为您找到 "自然堂" 相关商品 1 件：\r
\r
1. 自然堂男士咖啡因活力氨基酸洁面乳120g\r
   💰 ¥108.00 (原价 ¥90.00)\r
   📦 ❌ 缺货\r
   🔗 [查看详情](https://bupahua.com/product/677)\r
\r
💡 不怕花，花得值！需要查看更多商品吗？\r
```\r
\r
### 示例 3：无结果\r
**用户**：不怕花有电视机吗？\r
\r
**AI**：\r
```\r
🛍️ 不怕花商城\r
\r
🔍 抱歉，没有找到 "电视机" 相关商品\r
\r
💡 试试这些：\r
- 换个关键词试试看\r
- 逛逛热销好物：https://bupahua.com/hot\r
- 联系客服咨询：微信搜索 "不怕花" 小程序\r
\r
不怕花，花得值！下次再来逛逛吧~\r
```\r
\r
---\r
\r
## 配置说明\r
\r
### 环境变量（.env 文件）\r
API KEY 通过微信 "不怕花" 小程序获取 → 进入小程序后点击右下角 "我的" → "个人资料" → "API KEY" → 复制粘贴到 .env 文件中\r
技能需要以下配置，放在 `~/.openclaw/skills/bupahua-store/.env`：\r
\r
```env\r
# 不怕花商城 API 配置\r
STORE_API_URL=https://bupahua.com/Api/Search/searches\r
STORE_API_KEY=\r
STORE_NAME=不怕花\r
USE_REAL_API=true\r
```\r
\r
### 配置文件位置\r
- 技能目录：`~/.openclaw/skills/bupahua-store/`\r
- 搜索脚本：`scripts/search.py`\r
- 配置文件：`.env`\r
\r
---\r
\r
## 注意事项\r
\r
1. **关键词提取**：尽可能准确提取商品名称，去除无关词语\r
2. **库存状态**：\r
   - 库存 > 50：✅ 充足\r
   - 库存 1-50：⚠️ 仅剩 X 件\r
   - 库存 = 0：❌ 缺货\r
3. **价格显示**：优先显示优惠价，如有原价则一并显示\r
4. **链接生成**：商品详情页链接为 `https://bupahua.com/product/{id}`\r
5. **错误处理**：API 调用失败时显示友好提示\r
\r
---\r
\r
## 故障排查\r
\r
### 技能未触发\r
- 确保消息包含"不怕花"或明确的商品名\r
- 检查技能是否正确安装：`openclaw skills list`\r
\r
### 搜索无结果\r
- 检查网络连接\r
- 确认 API 地址正确\r
- 查看日志：`openclaw logs --tail 50`\r
\r
### 脚本执行失败\r
- 确认 Python 路径：`which python3`\r
- 测试脚本：`python3 scripts/search.py --keyword "测试"`\r
- 检查 .env 配置是否正确\r
```\r
\r
---\r