---
name: xiaohongshu-writer
description: 小红书 AI 文案自动生成 - 使用通义千问 API 生成高质量内容，支持7种内容类型
homepage: https://github.com/xiaohongshu-writer
metadata:
  {
    "openclaw":
      {
        "emoji": "📝",
        "alias": ["小红书", "xhs", "xiaohongshu", "文案生成", "内容创作"]
      },
  }
---

# 小红书 AI 文案生成器 (Xiaohongshu Writer)

基于通义千问 API 的智能小红书内容生成工具，支持多种内容类型和风格。

## 安装说明

### 1. 解压到 OpenClaw skills 目录
```
Windows: C:\Users\<用户名>\.openclaw\skills\xiaohongshu-writer\
macOS/Linux: ~/.openclaw/skills/xiaohongshu-writer/
```

### 2. 安装依赖
```bash
cd xiaohongshu-content-assistant
pip install -r requirements.txt
```

### 3. 配置 API Key（四种方式任选）

**方式一：配置文件（推荐，一次配置永久有效）**
```bash
# 在 skill 目录创建 api_key.txt 文件
# Windows: C:\Users\<用户名>\.openclaw\skills\xiaohongshu-writer\api_key.txt
# Linux/macOS: ~/.openclaw/skills/xiaohongshu-writer/api_key.txt

# 文件内容（第一行 API Key，第二行可选 Base URL）：
sk-your-api-key-here
https://dashscope.aliyuncs.com/compatible-mode/v1
```

**方式二：命令行传入**
```bash
python run.py "主题" --api-key YOUR_API_KEY
```

**方式三：环境变量**
```bash
# Windows
set QWEN_API_KEY=your-key-here

# Linux/macOS
export QWEN_API_KEY=your-key-here
```

**方式四：.env 文件**
```bash
cd xiaohongshu-content-assistant
copy .env.example .env
# 编辑 .env 文件，写入 QWEN_API_KEY=your-key-here
```

获取通义千问 API Key: https://dashscope.console.aliyun.com/

## When to use (触发短语)

用户提到以下内容时使用此技能：

- "写一篇小红书"
- "生成小红书文案"
- "帮我写小红书"
- "小红书内容"
- "关于[主题]的小红书"
- "咖啡探店文案"
- "产品测评文案"
- "穿搭分享文案"

## 支持的内容类型

| 类型 | 参数值 | 说明 | 关键词触发 |
|------|--------|------|-----------|
| 咖啡文化 | `coffee_culture` | 咖啡探店、手冲指南、咖啡知识 | 咖啡、手冲、探店、咖啡馆 |
| 产品测评 | `product_review` | 好物推荐、产品使用体验 | 产品、测评、推荐、种草 |
| 穿搭分享 | `ootd` | 今日穿搭、搭配技巧 | 穿搭、OOTD、搭配、时尚 |
| 生活方式 | `lifestyle` | 日常分享、生活记录 | 日常、生活、分享 |
| 美食探店 | `food` | 餐厅测评、美食推荐 | 美食、餐厅、探店、菜谱 |
| 旅行攻略 | `travel` | 景点推荐、旅行指南 | 旅行、旅游、攻略、景点 |
| 知识科普 | `knowledge` | 干货分享、知识科普 | 知识、科普、干货 |

## 使用方式

### 通过 OpenClaw 对话

直接对 OpenClaw 说：
- "写一篇关于咖啡的小红书文案"
- "帮我生成穿搭分享内容"
- "生成一篇求职经验的小红书文案"

OpenClaw 会自动识别并调用此 skill 生成文案。

### 命令行直接调用

```bash
cd xiaohongshu-content-assistant

# 使用 --api-key 动态传入（推荐）
python main.py --api-key YOUR_KEY --topic "手冲咖啡" --type coffee_culture
python main.py --api-key YOUR_KEY --topic "瑞幸拿铁" --type product_review
python main.py --api-key YOUR_KEY --topic "秋冬穿搭" --type ootd

# 也可以指定 base-url 和 model
python main.py --api-key YOUR_KEY --base-url "https://your-api-endpoint" --model "qwen-max" --topic "主题"

# 交互模式
python main.py --api-key YOUR_KEY --mode interactive
```

## 写作风格选项

- 轻松活泼（默认）
- 文艺清新
- 幽默风趣
- 专业干货
- 温馨治愈

## 技术配置

- **API**: 通义千问 (DashScope) 或兼容 OpenAI API 的服务
- **模型**: qwen-plus（可通过 --model 指定其他模型）
- **Python 版本**: 3.10+

## 注意事项

1. 生成的文案需人工审核后使用
2. 遵守小红书社区规范
3. 建议配合图片使用效果更佳
4. 通义千问有免费额度，可先体验
