renren-claw（人人爪）

人人商城龙虾助手

一、必读约束

首次安装配置

在 ~/.openclaw/openclaw.json 中添加凭证，平台启动时会自动读取该文件并将凭证注入技能运行上下文（技能代码本身不直接读取此文件）：

{
    "skills": {
        "entries": {
            "renren-claw": {
                "apiKey": "你的RR_CLAW_API_KEY",
                "env": {
                    "RR_CLAW_BASE_URL": "你的人人商城API基础地址"
                }
            }
        }
    }
}

获取凭证：前往 [人人商城后台 > 插件 > 龙虾助手 > API Key管理] 获取 API_KEY 和 服务器地址。

安全约定

• 你操作的是用户线上的电商系统，任何失误都可能造成用户的经济损失
• 操作类接口提交时一定与用户确认好之后再进行操作
• 技能运行时仅向用户配置的 RR_CLAW_BASE_URL 发送请求，不会将 API Key 传输至任何第三方端点
• 严禁在聊天消息中明文输出 API Key

二、认证与请求方式

请求头

• Authorization: Bearer $RR_CLAW_API_KEY（格式：lh-xxxxxxx-oc）

请求方式

• GET：查询类接口
• POST：提交数据 / 操作类接口，请求体以 application/x-www-form-urlencoded 格式提交

请求接口格式

RR_CLAW_BASE_URL + 接口地址

举例：https://example.com/wap/25/api/apps/openClaw/statistics/overview/to-do

响应数据格式

• 所有接口统一返回 HTTP 200，禁止以 HTTP 状态码判断成功或失败
• 响应格式为 JSON：{"error": 0, "message": "success", ...}
• 必须检查 error 字段：0 = 成功，非 0 = 业务失败（message 中包含错误描述）

脚本请求示例

凭证由平台从 ~/.openclaw/openclaw.json 注入，通过参数传递给客户端：

可自行拼接 cURL 请求，或调用 scripts/request_client.py 封装的客户端：

from request_client import get_client

# 首次初始化：传入平台注入的凭证
client = get_client(base_url=RR_CLAW_BASE_URL, api_key=RR_CLAW_API_KEY)

# 后续调用直接复用已初始化的单例
client = get_client()
client.get("/some/path")

三、快速决策

四、功能列表

数据统计模块

读取 数据统计模块 的接口文档。

商品查询管理模块

读取 商品查询管理模块 的接口文档。

订单查询管理模块

读取 订单查询管理模块 的接口文档。

会员查询管理模块

读取 会员查询管理模块 的接口文档。

营销活动查询管理模块

读取 营销活动查询管理模块 的接口文档。

五、意图判断指南

商城字段名词解释

时间段判断

功能关键词判断

⚠️ 危险操作（必须二次确认）

以下接口会直接影响线上业务，执行前必须向用户明确确认，禁止自动执行：

• POST /goods/operation/put-store — 下架商品（影响前台展示）
• POST /order/operation/close — 关闭订单（不可逆）
• POST /sales/coupon/manual-stop — 停止发放优惠券（立即生效）
• POST /sales/full-free/close — 关闭满额包邮（立即生效）