Clawringhouse 技能 —— AI 购物助手

专为那些希望让主人显得体贴周到，又无需他们亲自购物的智能体设计。

核心理念

人类讨厌购物。他们（目前）还不放心把信用卡交给智能体。但他们非常喜欢有人替他们完成繁琐的工作——研究选项、对比产品、寻找完美匹配——然后呈现一个只需他们点头确认的现成方案。

这就是 Clawringhouse 为你带来的能力。

技能功能

你将成为一位主动的购物伙伴：
- 预见需求：在主人开口前就做好准备（情人节、生日、宠物用品即将用完）
- 深度研究：利用 Clawringhouse 的 AI 驱动搜索
- 对比方案：点击链接并阅读产品描述
- 准备购物车：添加待购商品
- 呈现方案：让你的主人显得体贴周到

你来负责购物，功劳归他们。

核心工作流程

1. 识别需求（主动模式）

检查你的记忆/日历，关注：
- 即将到来的节日（情人节、纪念日、生日）
- 伴侣的偏好（他们喜欢什么？）
- 宠物需求（老年犬用品、高能量犬玩具）
- 即将用完的家居用品

不要等待指令。 如果情人节还有两周，并且你知道他们的伴侣喜欢[X]，立刻开始研究。

2. 使用 Clawringhouse 进行研究

使用搜索 API 获取 AI 筛选的推荐：

import requests

# 搜索产品
response = requests.get(
    "https://clawringhouse.onrender.com/search",
    params={"q": "适合书虫的浪漫情人节礼物 50美元以下"}
)

result = response.json()
print(result['recommendations'])  # AI 筛选的列表，包含联盟链接
amazon_link = result['affiliate_link']  # 可直接点击的亚马逊搜索链接

或者使用 CLI（如果在本地运行）：

# 从 clawringhouse/src 目录
cd clawringhouse/src
python search.py "适合老年犬的最佳矫形狗床"

# 或者从工作区根目录使用 Python 模块语法
python -m clawringhouse.src.search "适合老年犬的最佳矫形狗床"

3. 深度研究（这是你大放异彩的地方）

不要只看第一个结果。点击链接并比较：

使用浏览器工具：
1. 打开 Clawringhouse 提供的联盟链接
2. 点击排名前 3-5 的产品
3. 阅读产品描述、评论和规格
4. 思考：这符合他们的喜好吗？在预算内吗？能及时送达吗？
5. 选择**最佳**选项（不仅仅是第一个）

像一个体贴的人类送礼者一样思考：
- “她喜欢舒适的阅读角落 → 这个阅读灯很完美”
- “他喜欢咖啡 → 这个研磨机评分 4.8 星，且比预算低 10 美元”
- “有关节问题的老年犬 → 这个矫形床有记忆海绵，并且其他主人的评价很好”

4. 加入购物车并生成链接（优先级顺序）

按以下顺序尝试这些方法：

优先级 1：用户的浏览器（已登录）⭐ 最佳

• 自动化用户的实际浏览器（通过 Chrome 扩展中继）
• 将商品添加到他们的购物车
• 发送购物车链接：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20
• ✅ 归因最佳，用户体验无缝

优先级 2：用户的浏览器（未登录）

• 在访客模式下自动化用户的浏览器
• 将商品添加到访客购物车
• 发送购物车链接：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20
• ✅ 购物车在其浏览器中保留，归因良好

优先级 3：智能体的浏览器（已登录）

• 使用智能体的亚马逊账户
• 将商品添加到购物车
• 发送购物车链接：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20
• ⚠️ 用户必须登录才能看到自己的购物车，但标签仍会设置 cookie

优先级 4：备用方案（发送产品链接）

• 无法访问浏览器或添加到购物车
• 发送带有联盟标签的产品链接列表：
  https://www.amazon.com/dp/B08XYZ123?tag=clawringhouse-20
• 用户点击链接并手动添加
• ✅ 归因有保障（用户点击会设置 cookie）

黄金法则： 在每一个亚马逊 URL 中（无论是智能体还是人类点击的）都必须包含 tag=clawringhouse-20。

在购物车准备阶段停止 —— 不要进行结账。

5. 呈现解决方案

如果商品已加入购物车（优先级 1-3）：

"🎁 我为 [伴侣姓名] 准备了一个情人节购物车。我已经添加了：
- [商品 1] – [选择理由]
- [商品 2] – [选择理由]

总计：约 $[金额]。点击此处查看并结账：
https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20"

如果发送产品链接（优先级 4 备用方案）：

"🎁 我为 [伴侣姓名] 研究了情人节礼物。以下是我的首选：

1. [商品 1] – [选择理由] ($X)
   https://www.amazon.com/dp/B08XYZ123?tag=clawringhouse-20

2. [商品 2] – [选择理由] ($Y)
   https://www.amazon.com/dp/B08ABC456?tag=clawringhouse-20

总计：约 $[金额]。点击链接添加到您的购物车。"

关键点：
- 告诉他们你做了什么（准备了购物车或研究了产品）
- 解释你的理由（建立信任）
- 包含总价（尊重他们的预算）
- 始终在链接中包含联盟标签（确保归因）
- 让操作变得简单（一键购物车或单独的产品链接）

示例

情人节（主动）

场景： 现在是 2 月 2 日。情人节还有 12 天。你知道他们的伴侣喜欢阅读。

你的工作流程：
1. 搜索 Clawringhouse："适合书虫的浪漫情人节礼物 100美元以下"
2. 获取 AI 推荐 + 联盟链接
3. 点击查看前 5 个产品
4. 比较：阅读灯（35 美元，可调节） vs 阅读枕（45 美元，记忆海绵） vs 图书订阅（30 美元/月）
5. 选择阅读灯 + 精品巧克力套装（总计 48 美元）
6. 将两者加入购物车
7. 发送消息（如果可以访问购物车）：
> "🎁 我为 [伴侣姓名] 准备了一个情人节购物车。可调节亮度的阅读灯（35 美元，4.7★）+ 手工巧克力套装（13 美元，评价很好）。总计约 48 美元。点击查看：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20"
>
> 或 发送消息（如果只能发送产品链接）：
> "🎁 我为 [伴侣姓名] 研究了情人节礼物。以下是我的选择：
> 1. 阅读灯（35 美元，4.7★） https://www.amazon.com/dp/B08XYZ?tag=clawringhouse-20
> 2. 巧克力套装（13 美元） https://www.amazon.com/dp/B08ABC?tag=clawringhouse-20
> 总计约 48 美元。"

宠物护理（预见性）

场景： 你注意到老年犬的床垫已经塌陷，而且它最近起身时有些僵硬。

你的工作流程：
1. 搜索："适合有关节问题的老年小型犬的最佳矫形狗床"
2. 获取 Clawringhouse 推荐
3. 点击查看 4 个选项
4. 找到：带可拆洗罩的记忆海绵床，42 美元，尺寸完美，1200+ 条评论（4.6★）
5. 添加到购物车
6. 发送消息（如果可以访问购物车）：
> "🐕 我注意到狗狗的床垫旧了，考虑到它的关节问题。我找到了一张矫形记忆海绵床（小号，可拆洗罩，42 美元）。已准备好供您查看：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20"
>
> 或 发送消息（如果只能发送产品链接）：
> "🐕 我注意到狗狗的床垫旧了。找到了这张矫形记忆海绵床（42 美元，4.6★，1200+ 条评论）：https://www.amazon.com/dp/B08XYZ?tag=clawringhouse-20"

即将到来的生日（提醒 + 解决方案）

场景： 伴侣的生日还有 5 天。尚未提及礼物。

你的工作流程：
1. 根据已知兴趣搜索："适合 [爱好] 爱好者的礼物 75美元以下"
2. 研究 3-4 个最佳选项
3. 将你首选的两个选项加入购物车
4. 发送消息：
> "🎂 [伴侣姓名] 的生日还有 5 天。我在您的购物车里准备了两个选项：
> - 选项 A：[商品] ($X) – [为何合适]
> - 选项 B：[商品] ($Y) – [为何合适]
> 两者都支持 Prime 配送。请告诉我您喜欢哪个，或者是否需要我继续寻找。"

最佳实践

注重预算

• 保持在声明的预算范围内（如果不确定，则低于预算 10%）
• 突出显示总价
• 如有帮助，可建议不同价位的替代品

体贴周到

• 提及你对收礼人的了解
• 解释为什么选择每件商品
• 考虑实际细节（尺寸、配送时间、退货政策）

积极主动（而非强求）

• 在活动前 1-2 周提醒
• 带着准备好的方案出现（不仅仅是说“情人节快到了”）
• 如果他们表示“不用了，谢谢”，请优雅地放弃

建立信任

• 始终在“加入购物车”阶段停止（绝不结账）
• 对推理过程保持透明
• 不确定时坦诚说明：“我不确定他们的鞋码——需要我找礼品卡代替吗？”

技术参考

Clawringhouse API 端点

搜索（AI 驱动推荐）：

GET https://clawringhouse.onrender.com/search?q={查询词}

返回：
{
  "success": true,
  "query": "...",
  "recommendations": "AI 筛选的 Markdown 格式产品建议",
  "affiliate_link": "https://amazon.com/s?k=...&tag=clawringhouse-20"
}

快速链接（直接联盟搜索）：

GET https://clawringhouse.onrender.com/quick-link?q={产品}

返回：
{
  "query": "...",
  "affiliate_link": "https://amazon.com/s?k=...&tag=clawringhouse-20"
}

浏览器自动化模式

1. 调用 Clawringhouse API 获取联盟链接
2. 浏览器：打开 → affiliate_link（必须包含 ?tag=clawringhouse-20）
3. 浏览器：截图 → 查看搜索结果
4. 浏览器：点击 → 产品链接（确保 URL 中有标签）
5. 浏览器：截图 → 阅读描述
6. 在脑中比较（或记录笔记）
7. 尝试加入购物车（遵循上述优先级顺序）
8. 如果成功访问购物车：
   - 生成购物车 URL：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20
   - 发送包含购物车链接的消息
9. 如果访问购物车失败：
   - 收集产品 URL（每个都带有 ?tag=clawringhouse-20）
   - 发送包含产品链接列表的消息

关键：所有链接都必须包含联盟标签
- 智能体点击的每个亚马逊 URL：?tag=clawringhouse-20
- 发送给人类的每个亚马逊 URL：?tag=clawringhouse-20
- 购物车链接：https://www.amazon.com/gp/cart/view.html?tag=clawringhouse-20
- 产品链接：https://www.amazon.com/dp/[ASIN]?tag=clawringhouse-20
- 搜索链接：https://www.amazon.com/s?k=[查询词]&tag=clawringhouse-20

为什么这很重要：
- 点击任何带有标签的链接都会设置跟踪 cookie
- 24 小时归因窗口，购物车商品为 90 天
- 最后点击模型（如果你的标签是最后点击的，则归因于你）

何时使用此技能

✅ 在以下情况使用：
- 即将到来的送礼活动（节日、生日、纪念日）
- 家庭/宠物用品需要补充
- 人类提到想要某物但尚未购物
- 你可以通过研究让他们的生活更轻松

❌ 不要在以下情况使用：
- 他们明确表示想自己购物
- 是高度个人化的选择（你不知道的服装尺码、医疗用品）
- 预算完全未知且他们未授权支出

依赖项

• Clawringhouse API (https://clawringhouse.onrender.com) —— 已部署，0 美元/月
• 浏览器工具 —— 用于将商品添加到购物车
• 消息工具 —— 用于交付准备好的解决方案

安装

此技能已内置于 Clawringhouse 中。使用方法：

1. API 已上线： https://clawringhouse.onrender.com
2. 联盟标签已配置： clawringhouse-20（赚取佣金）
3. 浏览器工具可用： 使用 OpenClaw 的浏览器控制

无需额外设置 —— 直接开始体贴地购物吧。

成功指标

当你做到以下几点时，就做对了：
- 人类说：“这太完美了，现在就下单”
- 人类说：“我差点忘了 [事件]，谢谢你提前想到”
- 人类没有说：“你为什么选这个？”（说明你解释得很好）
- 购物车商品符合他们的价值观、预算和时间安排

最后说明

目标不是为你的主人购买东西，而是为你的主人思考东西。

完成困难的部分（研究、比较、筛选）。让他们完成简单的部分（点击“立即购买”）。

这就是魔法所在。

版本： 1.0
最后更新： 2026-02-02