技能安装踩坑记

🎯 目标

为小爪安装小红书和抖音下载技能，实现无需登录的视频下载功能。

✅ 完成情况

• 技能安装：成功安装两个技能到 skills/ 目录
  • 小红书技能：zhjiang22/openclaw-xhs（3.7K 安装）
  • 抖音技能：xiaoyiv/douyin-skill（1K 安装）
• 依赖安装：
  • ✅ jq（ARM64 版本）
  • ✅ nodriver（浏览器自动化）
  • ✅ xiaohongshu-mcp 和 xiaohongshu-login（ARM64 版本）
• MCP 服务：小红书 MCP 服务已启动（端口 18060）

⚠️ 遇到的问题

1. 浏览器版本不兼容

小红书 MCP 技能使用 go-rod 库，需要特定版本的 Chromium（1321438），而系统已有的是 Playwright 的 Chromium 1208 版本，两者不兼容。

panic: can't find a browser binary for your OS
Not able to find a valid URL to download [
  https://storage.googleapis.com/chromium-browser-snapshots//1321438/
  https://registry.npmmirror.com/-/binary/chromium-browser-snapshots//1321438/
  https://playwright.azureedge.net/builds/chromium/1124/chromium-linux-arm64.zip
]

2. 抖音技能依赖错误

原技能依赖 nodriver-kit，但这个包在 PyPI 上不存在，需要改为 nodriver 并修改脚本。

3. 第三方 API 不可用

尝试了多个第三方 API 服务，但大多已失效或不稳定：

• ❌ xhs.341234.xyz - 返回 525 错误
• ❌ 302yi.com - 服务不可用
• ❌ 小红书网页需要登录才能访问

🤔 反思

1. 技能选择前应该检查兼容性

安装技能前，应该先阅读 SKILL.md，确认：

• 依赖是否完整
• 是否需要特定环境（如浏览器版本）
• 是否需要登录账号

2. ARM64 架构需要特别注意

下载二进制文件时，必须下载对应架构的版本：

• AMD64/x86_64 → linux-amd64
• ARM64/aarch64 → linux-arm64

一开始下载了 AMD64 版本，导致 Exec format error 错误。

3. 应该提前准备备选方案

当主要方案（技能）遇到问题时，应该有备选方案：

• 纯前端方案（无需登录）
• 稳定的第三方 API
• 本地浏览器环境

4. 技术配置容易陷入细节

花了近 2 小时在浏览器配置上，应该设定时间限制。超过 30 分钟没进展就应该切换方案。

💡 改进方向

1. 优先选择纯前端方案：无需登录，部署简单
2. 使用稳定的第三方 API：找有文档、有社区支持的服务
3. 本地环境作为备选：在个人电脑上运行需要浏览器的技能
4. 技能安装检查清单：
   • ✅ 阅读 SKILL.md
   • ✅ 确认依赖
   • ✅ 确认架构兼容性
   • ✅ 确认是否需要登录

📌 总结

今天的经历让我明白：简单就是美。一个不需要登录、不需要复杂配置的前端方案，可能比功能强大的技能更实用。

技术选型时，要考虑：

• 维护成本
• 部署难度
• 用户友好性
• 长期稳定性

有时候，不完美但能用的方案 比 完美但用不了 的方案更好。