Xiaohongshu (RedNote/小红书) automation skill for content publishing and engagement. Publish image-text notes via the xhs API using cookies, and simulate browse...
根据用户需求,自动完成小红书的内容发布或运营互动任务。
完整参数文档见
references/params.md
常见错误与处理见references/troubleshooting.md
工作流规则与约束见references/runtime-rules.md
venv/ 和 xhs_browser_data/ 不随 skill 迁移,可以即开即用。創建新环境请运行对应安装脚本:
# Linux/macOS(Openclaw 部署环境)
bash setup.sh
# Windows 本地调试
.\setup.ps1
安装完成后再执行后续步骤。
在执行任何任务前,检查:
venv/ 虚拟环境是否存在(不存在则先运行 setup.sh)。.env 文件是否包含 XHS_COOKIE(发布任务必须)。xhs_browser_data/ 是否有登录数据(互动任务必须,否则先引导用户登录)。触发条件:用户提供图片路径、笔记标题和正文,要求发布到小红书。
# Linux/macOS (Openclaw)
venv/bin/python scripts/publish_xhs.py --dry-run --title "验证" --images <任意图片路径>
# Windows
.\venv\Scripts\python.exe scripts\publish_xhs.py --dry-run --title "验证" --images <任意图片路径>
.env 中的 XHS_COOKIE(见 references/params.md)# Linux/macOS (公开发布)
venv/bin/python scripts/publish_xhs.py \
--title "笔记标题" \
--desc "正文内容 #话题标签" \
--images 封面.png 配图1.png \
--public
# Windows
.\venv\Scripts\python.exe scripts\publish_xhs.py --title "笔记标题" --desc "正文" --images 封面.png --public
默认仅自己可见,确认效果后再用
--public公开。
references/troubleshooting.md 排查并上报错误原因。触发条件:用户要求搜索某关键词、浏览帖子、或回复评论。
检查 xhs_browser_data/ 是否存在。若不存在:
# Linux/macOS (Openclaw) - Openclaw 默认有头环境时使用
venv/bin/python scripts/interact_xhs.py --login
# Windows
.\venv\Scripts\python.exe scripts\interact_xhs.py --login
import asyncio
from scripts.interact_xhs import XHSInteractor
async def run():
async with XHSInteractor() as bot:
await bot.start(headless=True)
# 搜索并进入第一个笔记
await bot.search_and_browse("关键词")
# 发表评论
await bot.add_comment("评论内容")
asyncio.run(run())
连续评论建议每次间隔 30 秒以上。
scripts/publish_xhs.py — 图文发布脚本(XHSPublisher 类)scripts/interact_xhs.py — 网页互动脚本(XHSInteractor 类)references/params.md — 所有参数说明与 Cookie 获取方法references/runtime-rules.md — 操作规范与风控约束references/troubleshooting.md — 常见错误排查examples/publish_example.py — 发布调用示例ZIP package — ready to use