小红书自动化运营 OpenClaw 插件。

复用你已登录的 Chrome（通过 OpenClaw browser control），让 AI Agent 获得完整的小红书网页端操作能力——无需独立浏览器进程，无需 API Key，无需逆向工程。

English →

AI Agent（Claude / Gemini / …）
  → xhs_* 工具调用
  → auto-rednote 插件（TypeScript）
  → 进程内调用 → OpenClaw browser control
  → Playwright → OpenClaw 管理的 Chrome（openclaw profile）
  → 小红书网页端（www.xiaohongshu.com）

插件通过进程内调用直接使用 OpenClaw 的 browser control，无需独立 HTTP 端口。它控制 OpenClaw 管理的 Chromium 实例，自动共享你的登录会话。

extensions 目录紧邻 OpenClaw 安装目录：

# npm 全局安装（最常见）
ls $(npm root -g)/openclaw/extensions/

# Homebrew
ls /opt/homebrew/lib/node_modules/openclaw/extensions/

# 源码目录
ls /path/to/openclaw/extensions/

提示：运行 openclaw doctor，输出中会显示 gateway 二进制路径，extensions/ 就在同级目录下。

cd $(npm root -g)/openclaw/extensions   # 根据你的安装方式调整路径
git clone https://github.com/BodaFu/auto-rednote.git
cd auto-rednote
npm install

打开 ~/.openclaw/openclaw.json（不存在则新建），添加：

{
  "plugins": {
    "entries": {
      "auto-rednote": {
        "enabled": true
      }
    }
  }
}

可选：指定自定义数据库路径：

{
  "plugins": {
    "entries": {
      "auto-rednote": {
        "enabled": true,
        "config": {
          "dbPath": "~/.openclaw/auto-rednote.db"
        }
      }
    }
  }
}

OpenClaw 管理一个独立的 Chrome profile（openclaw），需要在这个浏览器里登录小红书：

openclaw browser

这会打开 OpenClaw 的 Chromium 窗口。访问 https://www.xiaohongshu.com 正常登录即可。登录状态会持久化在 openclaw profile 中。

# 发送 HUP 信号，热重载插件（无需完整重启）
kill -HUP $(pgrep -f "openclaw.*gateway")

# 或者完整重启
openclaw gateway --force

向你的 Agent 发送："调用 xhs_check_login，告诉我结果。"

预期返回：{ "loggedIn": true, "message": "已登录" }

browserProfile 配置项无需设置——插件始终使用 OpenClaw 内置的 openclaw Chrome profile。

需要小红书 macOS App（rednote，Mac App Store 可下载）以全屏模式运行在独立 Space 中。网页版小红书不支持私信功能。通过 peekaboo CLI 控制。

通过 Ghost OS 操作小红书 macOS App 的 GUI，从 AX 树提取数据。相比网页端 CDP 操作，更接近真人行为，风控风险更低。

用户：帮我检查小红书有没有新评论，如果有就回复"谢谢支持！"

Agent 调用流程：
1. xhs_check_login                → 确认已登录
2. xhs_get_notifications_pending { maxPages: 2 }
3. 过滤 comment_on_my_note / reply_to_my_comment 类型
4. xhs_reply_comment { feedId, xsecToken, commentId, content: "谢谢支持！" }
5. xhs_mark_notification { id, status: "replied" }

用户：帮我查一下小红书有没有新私信，有的话帮我回复

Agent 调用流程：
1. xhs_desktop_im_scan_inbox      → 截图消息列表 + 所有行坐标
2. 视觉分析截图，找到有未读的对话行及其 clickX/clickY
3. xhs_desktop_im_open { x, y }   → 打开对话，截图显示消息历史
4. 读取截图中的消息内容
5. xhs_desktop_im_send { text: "..." }  → 发送回复
6. 视觉确认回复已出现在对话中
7. xhs_desktop_im_back            → 返回收件箱，继续处理下一条

用户：搜索"手机摄影技巧"，点赞前3条

Agent 调用流程：
1. xhs_search { keyword: "手机摄影技巧", sortBy: "most_liked" }
2. 取前3条结果
3. xhs_like { feedId, xsecToken } × 3

• HTTP 浏览器控制：插件通过原生 fetch() 直接调用 OpenClaw Gateway 的浏览器控制 HTTP 服务，避免 jiti 模块隔离导致的 Playwright 连接冲突，由 Gateway 统一管理浏览器实例。
• SPA 预热：小红书是 React SPA，插件会确保 Chrome 已访问首页完成 window.__INITIAL_STATE__ 初始化，再提取数据。
• 数据提取：优先从 window.__INITIAL_STATE__ 提取结构化数据，降级到 DOM 解析。包含 Vue 响应式 Proxy 深度解包逻辑。
• API 拦截：通知获取拦截 /api/sns/web/v1/you/mentions。评论回复在页面注入持续拦截器（window.__commentAPIEntries），处理虚拟化渲染和多级评论结构。
• 多级评论处理：xhs_reply_comment 实现了 4 级容错查找策略，包括从拦截的 API 数据中反推真实父评论 ID。
• 通知状态持久化：使用 Node.js 内置 node:sqlite 将通知处理状态存储在本地 SQLite 数据库中。
• 导航可靠性：三层重试机制（URL 验证 → 强制重导航 → 开新标签页），CDP navigate 返回成功不代表页面已加载。
• 桌面 IM — Space 切换：小红书 macOS App 在独立全屏 Space 运行。activateApp 使用 System Events set frontmost to true（唯一能跨 Space 切换的方式），而非 tell application X to activate（只激活进程，不切换 Space）。截图在 Space 切换动画完成后（~800ms）由 screencapture -R 执行。
• 桌面 IM — iOS on Mac 限制：该 App 是 iOS 移植版，Accessibility 树质量极低（大多数元素标注为"按钮"/"文本"）。工具实现了优雅降级：peekaboo see 失败时自动回退到纯截图视觉分析。点击操作使用从已知窗口区域（x=0, y=33, 1512×949）推算的绝对屏幕坐标。
• 桌面 Feed — Ghost OS：通过 Ghost OS CLI 操作小红书 macOS App 的 GUI，从 AX 树深度遍历提取 Feed 数据，不依赖网页端 __INITIAL_STATE__。更接近真人行为，风控风险更低。

plugin not found: auto-rednote 找不到插件目录。确认 auto-rednote/ 直接位于 OpenClaw 安装目录下的 extensions/ 文件夹内，且已在目录内执行 npm install。

Can't reach the OpenClaw browser control service OpenClaw browser 尚未启动，或 Chromium 进程崩溃。运行 openclaw browser 打开浏览器窗口，等待几秒后重试。

{ "loggedIn": false } 需要在 OpenClaw Chromium 窗口中登录小红书。运行 openclaw browser，访问 https://www.xiaohongshu.com 并登录。

工具在命令行测试正常，但通过 Agent 调用超时 这通常发生在 gateway 刚重启后，browser control service 还在初始化。等待 10–15 秒后重试。

• 新增：桌面 Feed 工具（Ghost OS） — 4 个新的 xhs_desktop_* 工具，通过 GUI 操作小红书 macOS App
  • xhs_desktop_list_feeds、xhs_desktop_search、xhs_desktop_get_feed、xhs_desktop_go_back
• 新增：xhs_search 支持排序、笔记类型、时间范围、搜索范围筛选
• 移除：网页端工具的频率限制冷却机制

• 新增：桌面 IM 工具 — 9 个 xhs_desktop_im_* / xhs_desktop_screenshot 工具，通过小红书 macOS App 实现私信回复能力
  • xhs_desktop_im_scan_inbox、xhs_desktop_im_scan_stranger、xhs_desktop_im_unread、xhs_desktop_im_inbox、xhs_desktop_im_open、xhs_desktop_im_send、xhs_desktop_im_back、xhs_desktop_im_see、xhs_desktop_screenshot
• 修复全屏 Space 切换：activateApp 改用 System Events set frontmost 正确跨 Space 切换
• 修复跨 Space 截图：screenshot() 先激活 App 等待动画完成（800ms）再截图
• 校准全屏 1512×949 布局的 UI 坐标（输入框 y=930，返回按钮 y=30）
• xhs_search 新增 limit 参数（默认 20），控制返回条数

• 全面重构通知解析与评论查找逻辑
• 新增 injectCommentAPIInterceptor：持续收集评论 API 响应
• 重写 scrollToComment 与 expandAndFindSubComment：停滞检测 + has_more 判断
• 补全 replyComment 4 级容错路径
• 修复 followUser ReferenceError
• 增强 parseCommentApiResponse：返回 subCommentCount / subCommentHasMore

• 初始版本，实现 19 个核心工具
• 覆盖账号、内容、互动、通知、发布全域能力

MIT — 详见 LICENSE。

本项目与小红书官方无关，不受其背书。