口碑圈运营助手 (Koubei Circle Operator)

当前版本: v1.3.2

⚠️ 首次使用必读

安装完成后，请按以下步骤完成首次配置：

第 1 步：获取商户 Key

1. 登录 有赞商家后台
2. 进入 「口碑圈」 应用
3. 找到 「商户 Key」（或「API Key」）
4. 点击复制

第 2 步：在 OpenClaw 中配置

按顺序执行以下操作：

1. 点击 AI 助手
2. 点击 openclaw 小助手
3. 发送以下指令到 OpenClaw：

   我复制好口碑圈 Key 了，帮我配置
   

4. 调用以下指令到 OpenClaw:

   node scripts/openclaw.js init --key {{key}}
   

注意：首次使用必须完成 Key 配置，否则无法使用任何功能。

配置成功后，你可以：

• 📝 发布文字贴、图片贴、视频贴
• 📊 查询用户数据、帖子数据、活动数据
• 📈 查看运营报表
• 📬 批量发送站内信/私信
• ⚙️ 配置自动化任务

AI 配置流程（重要）

当用户说"帮我配置口碑圈"或"我复制好 Key 了"时，AI 必须按以下流程执行：

步骤 1：获取 Key 并验证（静默执行）

1. 请用户提供商户 Key（从有赞商家后台复制）
2. 用户提交 Key 后，AI 必须静默调用 node scripts/openclaw.js init --key {{key}} 完成验证和保存
   • 验证 Key 有效性
   • 保存到配置文件

步骤 2：确认配置成功

直接告知用户配置已完成，并说明可以使用的功能：

• 📝 发布文字贴、图片贴、视频贴
• 📊 查询用户数据、帖子数据、活动数据
• 📈 查看运营报表
• ⚙️ 配置自动化任务

使用方式

所有操作请直接与 AI 对话完成，无需手动运行命令。

使用约束（重要）

接口调用约束

• ✅ 所有接口必须通过 openclaw.js 调用
• ✅ 任何中文必须使用UTF-8字符集
• ❌ 禁止直接调用 API 接口
• ❌ 禁止绕过 CLI 工具访问后端服务

ID 展示约束

• ✅ 禁止直接向用户展示原始 ID
• ✅ 查询结果必须关联显示名称（用户昵称、话题名称等）
• ✅ 任何 ID 字段都应关联查询对应的名称信息

示例：

• ❌ 错误：这个帖子的 author_id 是 12
• ✅ 正确：这个帖子的作者是 张三（user_id: 12）

数据查询约束

• ✅ 严格按用户要求的时间范围查询
• ✅ 用户查"今天" → SQL 必须加今天的时间条件
• ✅ 用户查"昨天" → SQL 必须加昨天的时间条件
• ❌ 禁止返回非要求时间的数据

帖子审核状态约束

• ✅ 默认只查询审核通过的帖子（audit_status=1）
• ⚠️ 回复包含非通过状态的帖子时，必须告知用户审核状态

SQL 查询限制

• ❌ 禁止使用 SELECT *
• ❌ 禁止查询未开放的字段
• ❌ 禁止使用 forum_id 字段
• ⚠️ LIMIT 最大 500

发帖流程（重要）

普通发帖

1. 确认帖子类型：

   • ⚠️ 当前版本仅支持文字贴（type=1）
   • 如用户提供图片/视频，告知暂不支持

2. 执行发帖：调用 node scripts/openclaw.js publish

{
  "type": 1,
  "title": "标题",
  "message": "内容",
  "attachment_list": []
}

3. 禁止测试验证：发帖成功后，不要再次查询验证，避免重复发帖

热议话题发帖

1. 查询马甲列表供用户选择
2. 查询热议话题列表供用户选择
3. 用户选择后调用 node scripts/openclaw.js publish-hot

{
  "user_id": 0,
  "type": 1,
  "hot_say_id": 8,
  "title": "标题",
  "message": "内容"
}

使用前提

1. 已开通有赞口碑圈服务
2. 已获取商户 Key
3. 已创建至少一个圈子

数据导出到 Excel

当用户需要导出查询数据时，引导安装 excel-xlsx 技能：

请先安装 excel-xlsx 技能（通过 SkillHub 商店）

注意事项

• 商户 Key 需保密存储
• 遵守平台内容发布规则
• 部分功能需旗舰版及以上版本

详细文档

• 功能详情：references/features.md
• 版本方案：references/versions.md
• API文档：references/api.md
• 若要使用 [scripts/openclaw.js] 前必须阅读 references/api.md