口碑圈运营助手 (Koubei Circle Operator)
当前版本: v1.4.0
⚠️ 首次使用必读
安装完成后,请按以下步骤完成首次配置:
第 1 步:获取商户 Key
- 登录 口碑圈商家后台(https://dengluu.com)
- 进入 「口碑圈」 应用
- 找到 「商户 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 将发送至口碑圈官方 API 服务器(
https://ocg.myfans.cc),用于验证和绑定配置 - 用户确认后,调用
node scripts/openclaw.js init --key {{key}}完成验证和保存- 验证 Key 有效性
- 保存到本地配置文件
scripts/config.json
步骤 2:确认配置成功
直接告知用户配置已完成,并说明可以使用的功能:
- 📝 发布文字贴、图片贴、视频贴
- 📊 查询用户数据、帖子数据、活动数据
- 📈 查看运营报表
- ⚙️ 配置自动化任务
使用方式
所有操作请直接与 AI 对话完成,无需手动运行命令。
| 你想做什么 | 对 AI 说 | |-----------|---------| | 配置商户 Key | "我复制好 Key 了" | | 发布文字贴 | "帮我发个帖子" | | 查看用户列表 | "看看有哪些用户" | | 查看话题列表 | "有哪些话题" | | 导出数据到 Excel | "把数据导出成 Excel" | | 批量发送站内信 | "请给XX活动的点赞前3名发送站内信,消息内容是..." | | 自动化任务 | "今天10点时告诉我社区的发贴数量" |
使用约束(重要)
接口调用约束
- ✅ 所有接口必须通过 openclaw.js 调用
- ✅ 任何中文必须使用UTF-8字符集
- ❌ 禁止直接调用 API 接口
- ❌ 禁止绕过 CLI 工具访问后端服务
操作确认约束(重要)
- ⚠️ 所有写操作必须向用户明确确认后方可执行
- 需要确认的操作类型:
- 删除类:删帖、删评论、删用户、删活动、删标签等
- 修改类:编辑帖子标题/内容、修改活动信息、修改用户信息等
- 积分类:增加积分、扣除积分、调整积分等
- 确认可直接执行的操作(免确认):
- 通知类:批量发送站内信/私信
- 状态类:置顶/取消置顶
- 确认话术示例:
"即将删除帖子《xxx》,共 X 条关联数据,确认执行吗?" - 禁止未经确认私自执行任何需要确认的写操作
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
发帖与帖子管理流程(重要)
第一步:确认帖子类型(发帖/编辑都必须执行)
当用户要求发帖或编辑帖子时,必须先向用户确认:
"请确认:这是普通贴还是活动贴?"
- 普通贴:关联话题(topic_id),走普通发帖/编辑流程
- 活动贴:关联活动(activity_id),走活动发帖/编辑流程
禁止跳过此步骤直接执行发帖或编辑。
第二步:发帖
普通帖发帖流程
-
确认发帖参数:
- 必须提供:
user_id(马甲/作者ID)、topic_id(话题ID)、title(标题)、message(内容) type:查询帖子表获取(文字贴通常为1)
- 必须提供:
-
执行发帖:
node scripts/openclaw.js publish '{"user_id":12,"type":1,"topic_id":3,"title":"标题","message":"内容"}' -
禁止测试验证:发帖成功后,不要再次查询验证,避免重复发帖
活动帖发帖流程
- 先查询可用活动列表,供用户选择:
node scripts/openclaw.js query "SELECT activity_id, title, started_at, ended_at FROM wb_activity LIMIT 20" - 确认活动 ID 和发帖参数后,调用对应接口发布活动关联帖子
第三步:帖子编辑/优化
帖子优化(含图片)
当用户要求优化已有帖子时,按以下步骤执行:
- 先确认帖子类型:查询帖子详情,判断是普通贴还是活动贴
- 理解图片内容(如有):用 vision 工具查看图片,理解信息、氛围、卖点
- 分析帖子原文:结合图片内容,找出可优化的文案方向
- 优化并回传:生成优化后的文案,图片链接原样透传,禁止修改
编辑帖子通用流程
- 确认帖子类型:先查询帖子详情,明确是普通贴还是活动贴
- 获取帖子当前信息:查询原标题、正文、图片等
- 执行修改:根据用户要求修改对应字段
- 调用对应接口:普通贴走普通编辑,活动贴走活动编辑
热议话题发帖
- 查询马甲列表供用户选择
- 查询热议话题列表供用户选择
- 用户选择后调用:
node scripts/openclaw.js publish-hot '{"user_id":12,"type":1,"hot_say_id":8,"title":"标题","message":"内容"}'
使用前提
- 已开通口碑圈服务(https://dengluu.com)
- 已获取商户 Key
- 已创建至少一个圈子
数据导出到 Excel
当用户需要导出查询数据时,引导安装 excel-xlsx 技能:
请先安装 excel-xlsx 技能(通过 SkillHub 商店)
注意事项
- 商户 Key 存储在本地
scripts/config.json,需妥善保管 - 所有 API 请求发送至口碑圈官方服务器
https://ocg.myfans.cc,该服务器为口碑圈官方服务域名 - 遵守平台内容发布规则
- 部分功能需旗舰版及以上版本
详细文档
- 功能详情:references/features.md
- 版本方案:references/versions.md
- CLI 命令参考:references/api.md
- 使用
scripts/openclaw.js前必须先阅读 references/api.md
扫码联系在线客服