- name
- koubei-circle-operator
- description
- 有赞口碑圈商家运营自动化技能。用于口碑圈发帖（文字/图片/视频/商品）、活动管理、数据监控、自动提醒、长连接推送。使用场景：商家需要在口碑圈发布内容、管理社区互动、查看运营数据、配置自动任务时触发此技能。需要商户 Key 才能执行操作。
口碑圈运营助手 (Koubei Circle Operator)
当前版本: v1.3.2
⚠️ 首次使用必读
安装完成后，请按以下步骤完成首次配置：
第 1 步：获取商户 Key
- 登录 有赞商家后台
- 进入 「口碑圈」 应用
- 找到 「商户 Key」（或「API Key」）
- 点击复制
第 2 步：在 OpenClaw 中配置
按顺序执行以下操作：
- 点击 AI 助手
- 点击 openclaw 小助手
- 发送以下指令到 OpenClaw：
我复制好口碑圈 Key 了，帮我配置- 调用以下指令到 OpenClaw:
node scripts/openclaw.js init --key {{key}}注意：首次使用必须完成 Key 配置，否则无法使用任何功能。
配置成功后，你可以：
- 📝 发布文字贴、图片贴、视频贴
- 📊 查询用户数据、帖子数据、活动数据
- 📈 查看运营报表
- 📬 批量发送站内信/私信
- ⚙️ 配置自动化任务
AI 配置流程（重要）
当用户说"帮我配置口碑圈"或"我复制好 Key 了"时，AI 必须按以下流程执行：
步骤 1：获取 Key 并验证（静默执行）
- 请用户提供商户 Key（从有赞商家后台复制）
- 用户提交 Key 后，AI 必须静默调用
node scripts/openclaw.js init --key {{key}}完成验证和保存
- 验证 Key 有效性 - 保存到配置文件
步骤 2：确认配置成功
直接告知用户配置已完成，并说明可以使用的功能：
- 📝 发布文字贴、图片贴、视频贴
- 📊 查询用户数据、帖子数据、活动数据
- 📈 查看运营报表
- ⚙️ 配置自动化任务
使用方式
所有操作请直接与 AI 对话完成，无需手动运行命令。
| 你想做什么 | 对 AI 说 |
|---|---|
| 配置商户 Key | "我复制好 Key 了" |
| 发布文字贴 | "帮我发个帖子" |
| 查看用户列表 | "看看有哪些用户" |
| 查看话题列表 | "有哪些话题" |
| 导出数据到 Excel | "把数据导出成 Excel" |
| 批量发送站内信 | "请给XX活动的点赞前3名发送站内信，消息内容是..." |
| 自动化任务 | "今天10点时告诉我社区的发贴数量" |
使用约束（重要）
接口调用约束
- ✅ 所有接口必须通过 openclaw.js 调用
- ✅ 任何中文必须使用UTF-8字符集
- ❌ 禁止直接调用 API 接口
- ❌ 禁止绕过 CLI 工具访问后端服务
ID 展示约束
- ✅ 禁止直接向用户展示原始 ID
- ✅ 查询结果必须关联显示名称（用户昵称、话题名称等）
- ✅ 任何 ID 字段都应关联查询对应的名称信息
示例：
- ❌ 错误：
这个帖子的 author_id 是 12 - ✅ 正确：
这个帖子的作者是 张三（user_id: 12）
数据查询约束
- ✅ 严格按用户要求的时间范围查询
- ✅ 用户查"今天" → SQL 必须加今天的时间条件
- ✅ 用户查"昨天" → SQL 必须加昨天的时间条件
- ❌ 禁止返回非要求时间的数据
帖子审核状态约束
- ✅ 默认只查询审核通过的帖子（audit_status=1）
- ⚠️ 回复包含非通过状态的帖子时，必须告知用户审核状态
| audit_status | 状态 |
|---|---|
| 0 | 未审核 |
| 1 | 审核通过 |
| 2 | 审核拒绝 |
SQL 查询限制
- ❌ 禁止使用
SELECT * - ❌ 禁止查询未开放的字段
- ❌ 禁止使用 forum_id 字段
- ⚠️ LIMIT 最大 500
发帖流程（重要）
普通发帖
- 确认帖子类型：
- ⚠️ 当前版本仅支持文字贴（type=1） - 如用户提供图片/视频，告知暂不支持
- 执行发帖：调用
node scripts/openclaw.js publish
{
"type": 1,
"title": "标题",
"message": "内容",
"attachment_list": []
}- 禁止测试验证：发帖成功后，不要再次查询验证，避免重复发帖
热议话题发帖
- 查询马甲列表供用户选择
- 查询热议话题列表供用户选择
- 用户选择后调用
node scripts/openclaw.js publish-hot
{
"user_id": 0,
"type": 1,
"hot_say_id": 8,
"title": "标题",
"message": "内容"
}使用前提
- 已开通有赞口碑圈服务
- 已获取商户 Key
- 已创建至少一个圈子
数据导出到 Excel
当用户需要导出查询数据时，引导安装 excel-xlsx 技能：
请先安装 excel-xlsx 技能（通过 SkillHub 商店）注意事项
- 商户 Key 需保密存储
- 遵守平台内容发布规则
- 部分功能需旗舰版及以上版本
详细文档
- 功能详情：references/features.md
- 版本方案：references/versions.md
- API文档：references/api.md
- 若要使用 [scripts/openclaw.js] 前必须阅读 references/api.md