小红书自动化

OpenClaw 专属小红书自动化技能，通过 exec 执行 uv run 脚本完成扫码登录、热搜爬取、AI 生成文案与配图、预览确认和一键发布，并支持热点到发布的自动流水线。依赖 uv、xhs-toolkit 源码、Chrome 与 OpenAI 兼容图片生成 API。

热度 70.85

最近更新 2026-05-17 12:34:29

分类：营销依赖：代码执行 / 第三方 API / 读写文件应用场景：社交媒体 / 文案创作 / 图像生成 / 自动化脚本 ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-xhs

Metadata

name: xhs
description: 小红书自动化 — 用 exec 工具运行脚本来登录、发布、爬热点、AI 生成图文。所有操作必须通过 exec 工具执行 uv run 命令，不要用 browser 工具。
homepage: https://github.com/pearl799/xhs-toolkit
metadata: {"openclaw":{"emoji":"📕","requires":{"bins":["uv"],"env":["XHS_TOOLKIT_DIR","IMAGE_API_KEY","IMAGE_BASE_URL","IMAGE_MODEL"]},"primaryEnv":"XHS_TOOLKIT_DIR","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}

重要：所有小红书操作必须使用 exec 工具执行以下命令，不要用 browser 工具打开网页。

变量	必填	说明
`XHS_TOOLKIT_DIR`	是	xhs-toolkit 项目路径（`git clone https://github.com/pearl799/xhs-toolkit`）
`IMAGE_API_KEY`	是	图片生成 API Key（任意 OpenAI 兼容的图片生成服务）
`IMAGE_BASE_URL`	是	图片生成 API Base URL（例如 `https://openrouter.ai/api/v1/chat/completions`）
`IMAGE_MODEL`	是	图片生成模型名称（例如 `google/gemini-3-pro-image-preview`）
`OPENCLAW_GATEWAY_TOKEN`	否	OpenClaw Gateway token（文案生成用，如果 gateway 开了 auth）
`XHS_DATA_DIR`	否	数据目录，默认 `~/.openclaw/skills/xhs/data`

检查登录状态：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_status.py

登录小红书（用户说"登录小红书"/"xhs login"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_auth.py

会在 Mac 桌面打开 Chrome，告知用户去扫码。

发布笔记（用户说"发小红书"/"发布笔记"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_publish.py --title "标题" --content "正文" --images "/path/1.png,/path/2.png" --topics "话题1,话题2"

发布前先用 xhs_status.py 检查登录。--images 必须是本地文件路径，1-9 张。--dry-run 可验证不发布。

爬取热点（用户说"小红书热点"/"trending"/"今天什么热门"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_trending.py --category "综合" --limit 20

支持 --keyword "AI" 搜索。分类：综合/时尚/美食/旅行/美妆/科技/健身/宠物/家居/教育。

AI 生成内容（用户说"生成小红书"/"帮我生成"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_generate_content.py --topic "主题" --style "干货分享" --image-count 4

生成文案+配图。生成后发给用户预览，确认后再调 xhs_publish.py 发布。

全自动流水线（用户说"自动发布"/"全自动"时）：

uv run --project $XHS_TOOLKIT_DIR {baseDir}/scripts/xhs_auto_pipeline.py --mode preview

热点→选题→生成→预览/发布。--mode auto 直接发布。

所有脚本输出 JSON，解析 status 字段判断结果。MEDIA: 行表示附件图片。