# Send 小红书自动化 to your agent
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
## Fast path
- Open the source page via Review source status.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-xhs",
    "name": "小红书自动化",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/pearl799/openclaw-xhs",
    "canonicalUrl": "https://clawhub.ai/pearl799/openclaw-xhs",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/openclaw-xhs",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-xhs",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "README_CN.md",
      "SKILL.md",
      "config.example.json",
      "install.sh",
      "scripts/configure_openclaw.py"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "openclaw-xhs",
      "status": "unstable",
      "reason": "timeout",
      "recommendedAction": "retry_later",
      "checkedAt": "2026-05-13T01:25:48.436Z",
      "expiresAt": "2026-05-13T13:25:48.436Z",
      "httpStatus": null,
      "finalUrl": null,
      "contentType": null,
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-xhs",
        "error": "Timed out after 5000ms",
        "slug": "openclaw-xhs"
      },
      "scope": "item",
      "summary": "Item is unstable.",
      "detail": "This item is timing out or returning errors right now. Review the source page and try again later.",
      "primaryActionLabel": "Review source status",
      "primaryActionHref": "https://clawhub.ai/pearl799/openclaw-xhs"
    },
    "validation": {
      "installChecklist": [
        "Wait for the source to recover or retry later.",
        "Review SKILL.md only after the download returns a real package.",
        "Treat this source as transient until the upstream errors clear."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-xhs",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-xhs",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-xhs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-xhs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-xhs/agent.md"
  }
}
```
## Documentation

### 小红书自动化 (XHS)

重要：所有小红书操作必须使用 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: 行表示附件图片。

### 注意事项

每个命令只需调用一次，等待结果即可，不要重复执行
脚本输出的 JSON 是给你解析用的，转述关键信息给用户即可，不要原样转发
生成内容后，把标题、正文、话题发给用户预览，图片用 MEDIA 行的路径作为附件
不要在一次回复中发送多条消息，合并为一条
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: pearl799
- Version: 1.0.1
## Source health
- Status: unstable
- Item is unstable.
- This item is timing out or returning errors right now. Review the source page and try again later.
- Health scope: item
- Reason: timeout
- Checked at: 2026-05-13T01:25:48.436Z
- Expires at: 2026-05-13T13:25:48.436Z
- Recommended action: Review source status
## Links
- [Detail page](https://openagent3.xyz/skills/openclaw-xhs)
- [Send to Agent page](https://openagent3.xyz/skills/openclaw-xhs/agent)
- [JSON manifest](https://openagent3.xyz/skills/openclaw-xhs/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/openclaw-xhs/agent.md)
- [Download page](https://openagent3.xyz/downloads/openclaw-xhs)