Comments Agent - 评论区智能运营工具

自媒体运营者的评论区 AI 分析工具 基于 OpenClaw + CloakBrowser + LLM

系统架构

┌─────────────────────────────────────────────────┐
│              comments-agent CLI                  │
│  scrape → analyze → report                      │
├─────────────────────────────────────────────────┤
│  puppeteer-core + CloakBrowser (浏览器自动化)    │
├─────────────────────────────────────────────────┤
│  OpenAI / DeepSeek / Ollama (AI 分析)            │
├─────────────────────────────────────────────────┤
│  HTML 报告 + JSON 数据                           │
└─────────────────────────────────────────────────┘

快速开始

1. 安装依赖

cd comments-agent
npm install

2. 配置

# 生成配置文件
node bin/comments-agent config --init

# 编辑配置文件，填入 LLM API Key
vim comments-agent.yaml

3. 安装 CloakBrowser（推荐）

npx cloakbrowser

或者直接用系统 Chrome，在配置文件中修改 browser.executablePath。

4. 运行

# 全流程：抓取 → 分析 → 报告
node bin/comments-agent run --url https://channels.weixin.qq.com/...

# 只抓取评论
node bin/comments-agent scrape --platform videoChannel

# 分析已有数据
node bin/comments-agent analyze -i ./reports/raw-xxx.json

Mac Mini 部署指南

推荐方案

# 1. 克隆项目
git clone <你的仓库> ~/comments-agent
cd ~/comments-agent

# 2. 安装依赖
npm install

# 3. 安装 CloakBrowser
npx cloakbrowser

# 4. 配置
cp config/default.yaml comments-agent.yaml
# 编辑 comments-agent.yaml，填入 LLM API Key

# 5. 测试运行
node bin/comments-agent run

# 6. 设置定时任务（每天自动分析）
# 编辑 crontab
crontab -e
# 每天 9 点运行
0 9 * * * cd ~/comments-agent && node bin/comments-agent run >> ./logs/cron.log 2>&1

配置文件说明

llm:
  apiKey: "sk-xxx"           # 你的 API Key
  baseUrl: "https://api.deepseek.com"  # 或 OpenAI / Ollama
  model: "deepseek-chat"     # 或 gpt-4o-mini（省钱）

browser:
  executablePath: "/usr/local/bin/cloakbrowser/chrome"  # CloakBrowser 路径
  headless: true              # Mac Mini 上建议 true

报告示例

生成在 reports/ 目录下：

• raw-xxx.json — 原始评论数据
• analysis-xxx.json — AI 分析结果
• analysis-xxx.html — 可视化报告（浏览器直接打开）

技术选型理由

| 组件 | 选型 | 原因 | |------|------|------| | 浏览器引擎 | CloakBrowser | 58 个指纹补丁，防抖音检测 | | 浏览器控制 | puppeteer-core | 直接操控 CDP，轻量无依赖 | | AI 分析 | OpenAI 兼容 API | 用户自备 Key，灵活切换模型 | | UI 报告 | 纯 HTML | 无需服务端，本地直接打开 |