clawshop-data-manager（爪店数据管理器）

赛博店长-商品库

🚀 Bootstrap（每次使用前）

Step 1：读取 token

exec: echo $CLAWSHOP_APP_TOKEN && echo $CLAWSHOP_TABLE_ID

Step 2：校验是否可用

用读到的 token 调用 feishu_bitable_list_fields(app_token, table_id)：

• 返回字段列表 → ✅ 直接操作
• 报错 / token 为空 → 重新建表（见 Step 3）

Step 3：建表（仅在校验失败时执行）

1. 调用 feishu_bitable_create_app(name="赛博店长-商品库") → 获得新 app_token / table_id
2. 依次调用 feishu_bitable_create_field 创建 16 个字段（字段定义见 {baseDir}/references/fields.md）
3. 用 gateway config.patch 写入新 token 并重启：

{
  "skills": {
    "entries": {
      "clawshop-data-manager": {
        "env": {
          "CLAWSHOP_APP_TOKEN": "new_app_token",
          "CLAWSHOP_TABLE_ID": "new_table_id"
        }
      }
    }
  }
}

⚙️ Feishu 账号说明

feishu_bitable_* 工具统一使用 channels.feishu.accounts.default 账号创建和读写表，这是 OpenClaw 当前行为（多账号隔离为社区少数需求，暂未修复）。无需切换账号，直接操作即可。

🚨 写入铁律

• **只用 feishu_bitable_* 工具**，禁止自己拼 curl
• 主字段名是「赛博店长-商品库」，不是「商品名称」，写错会静默失败
• 禁止重复入库：入库前先 feishu_bitable_list_records 查全量，商品名关键词匹配任意状态 → 跳过换品

🚫 候选状态铁律（只允许这 7 个值）

状态流转：

⏳待评估 → 🔄铺货中 → 已上架 → 已出单（永久保留）
                   ↘ ❌铺货失败   ↘ 已下架（14天0单且订单数=0）
⏳待评估 → ❌不符合标准（搜品失败/无货源）

严禁写入任何其他值。

读写速查

token 值通过 exec: echo $CLAWSHOP_APP_TOKEN && echo $CLAWSHOP_TABLE_ID 获取，再传入工具调用。

详细文档

• 字段定义 + 状态说明 → {baseDir}/references/fields.md
• CRUD 示例 + 常见错误 → {baseDir}/references/operations.md