📕 小红书全能助手（本地版）

MCP 服务运行在本机，远程网关只负责 API Key 认证。

特点

• 本地运行：MCP 二进制在用户本机运行 headless Chrome，不受海外 IP 限制
• 扫码更稳：本机 IP 扫码登录，避免海外 IP 风控
• 无需上传：图片/视频直接使用本地路径，无需上传到远程服务器
• API Key 认证：通过远程网关验证 Key 有效性，确保授权合规

系统要求

• OpenClaw 已安装
• Chrome 或 Chromium 浏览器（headless 模式需要）
• 至少 2GB 可用内存

快速安装

方式一：npm 安装（推荐）

openclaw plugins install @fwgi/xiaohongshu-mcp-local

方式二：本地安装

Linux / macOS

chmod +x install.sh
./install.sh

Windows

# 以管理员权限运行 PowerShell
.\install.ps1

配置

安装脚本会自动配置 gatewayUrl 和 mcpPort。API Key 不会自动写入——首次使用时机器人会向你索要。

手动配置

# 设置 API Key
openclaw config set plugins.entries.xiaohongshu-mcp-local.config.apiKey '你的KEY'

# 修改本地 MCP 端口（默认 18060）
openclaw config set plugins.entries.xiaohongshu-mcp-local.config.mcpPort 18060

# 修改远程网关地址（默认 https://api-backend.fwgi.ai）
openclaw config set plugins.entries.xiaohongshu-mcp-local.config.gatewayUrl 'https://api-backend.fwgi.ai'

环境变量（可选，优先级低于插件配置）

export XHS_API_KEY="你的KEY"
export XHS_MCP_PORT=18060
export XHS_GATEWAY_URL="https://api-backend.fwgi.ai"

使用方式

安装完成后，直接对你的 OpenClaw 机器人说：

• "帮我写一篇小红书并发布"
• "搜索小红书上的美食笔记"
• "帮我回复小红书评论"
• "查看我的小红书通知"

本地数据

MCP 的 Cookie 和浏览器数据保存在 ~/.xhs-mcp-local/ 目录下。

架构说明

用户 → OpenClaw Bot → 本地插件（index.ts）
                          │
                          ├─ API Key 验证 → 远程网关（api-backend.fwgi.ai）
                          │                  仅验证 Key 有效性
                          │
                          └─ 工具调用 → 本地 MCP 二进制（localhost:18060）
                                        headless Chrome → 小红书

与远程版的区别

| 特性 | 远程版 | 本地版 | |------|--------|--------| | MCP 运行位置 | 远程服务器 | 本机 | | 图片/视频 | 需上传到远程 | 直接用本地路径 | | 登录 IP | 远程服务器 IP | 本机 IP | | 扫码登录 | 可能受海外 IP 限制 | 更稳定 | | 网络依赖 | API Key + 所有操作 | 仅 API Key 验证 | | 系统要求 | 无 | 需要 Chrome + 内存 |

工具列表

共 15 个工具，包括：登录管理、内容发布、搜索浏览、互动操作、通知管理。

详见 SKILL.md 第三节。