适用于 Openclaw 的 TKSeller

TKSeller 是一个交互式自动化技能,旨在将自定义的 TikTok 卖家 SaaS 平台直接与即时通讯客户端集成。

evanholt921
v3.3.13
2026年7月8日
0
340
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install clawshop-pro

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 clawshop-pro。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 TKSeller?

TKSeller 是一种专为与 Openclaw Skills 配合工作而设计的专业开发者集成。该工具充当 AI Agent 与 TikTok 卖家 SaaS 平台之间的桥梁,将复杂的 API 工作流(/api/v1/*)映射为简单的斜杠命令和图形按钮事件。它为数字商业团队提供了一种强大的机制,无需在仪表板之间手动跳转即可管理以视频为中心的电商任务。

该技能构建并自动化了创意资产流水线。通过在活跃的聊天频道中处理后台生成运行、商品目录链接、多级分镜评审和视频批准,TKSeller 降低了维持高频内容推广的阻力。它在严格的零前导码(zero-preamble)执行规则下运行,确保快速的 API 通信和可靠的运行时反馈。

TKSeller 应用场景

  • 自动化收集视频资产并将其链接到目标 TikTok Shop 商品。
  • 直接在团队聊天中对分镜、商品配对和视频生成进行多步创意审批。
  • 实时轮询来自 SaaS 后端的异步远程事件和更新。
  • 在不同的团队频道中安全地管理独立的本地状态和安全令牌。
  • 在实时用户交互中,最小化 Agent 工具执行期间的对话延迟。

TKSeller 工作原理

  1. 执行调用:用户使用 /tkseller 或通过 TikTok 视频链接触发该技能。Agent 立即启动工具执行,不产生任何预先声明的对话噪音。
  2. 身份验证处理:脚本评估 data/token.json 中缓存的凭据。如果缺失或无效(401),该工具会提示输入登录凭据,并发送 POST 请求到 /api/v1/auth/login 以检索 bearer 令牌。
  3. 工作流启动:通过 POST /api/v1/recommend 提交视频资源 URL。此操作会初始化远程分析并调度后台轮询 cron 触发器。
  4. SaaS 事件轮询:注册的 cron 脚本(poll-events.mjs)定期调用 /api/v1/events/pending,以获取新的分镜评审、渲染任务或发布更新。
  5. 状态驱动的交互:任务详细信息将分发到带有集成按钮的聊天卡片中。点击时,handle-button.mjs 将交互标签映射到后端 API,处理评审和内容状态更新。
  6. 注销:一旦达到最终状态(视频发布、拒绝或 15 分钟超时),轮询 cron 任务会自动取消订阅,以防止资源消耗。

TKSeller 配置指南

安装

使用命令行在活跃的工作区中安装技能文件:

clawhub install tkseller

斜杠命令注册

要绕过全局传播延迟,并在您的 Discord 服务器中立即激活斜杠命令界面:

node ./lib-js/register-discord.mjs

在运行执行脚本之前,配置配置文件(data_service.base_url)中您的自定义目标 API 设置。

TKSeller 数据架构与分类体系

该技能在 data\/ 文件夹内管理本地化的运营数据文件,以保持状态对齐:

文件名 用途 核心 Schema 元素
data\/token.json 存储活跃的 SaaS JWT 身份验证和用户名数据。 {"token": "string", "username": "string"}
data\/card_map.json 将交互卡片跟踪 ID 与远程制作视频记录配对。 {"date": "YYYY-MM-DD", "next_id": 3, "cards": {}}
data\/processed_events.json 记录已确认的远程 ID,以防止重复操作。 {"ids": [1001, 1002, 1003]}
data\/poll_state.json 跟踪运行时状态和启动时间戳,以便进行上下文管理。 {"started_at": 1716180000, "active": true}

此架构可让关键 API 元数据保持可访问状态,而不会负担活跃的内存池。

TKSeller 高级特性

  • 自动化 Cron 调度:使用原生网关功能,在亚秒级间隔内编排递归循环轮询。
  • 自适应客户端框架:标准化渲染选项,使其在 Discord 按钮块和 Webchat 文本触发器上无缝运行。
  • 强大的 API 错误管理器:集成备用处理程序,以干净地解决速率限制、令牌过期问题和网络服务器超时。
  • 轻量级上下文隔离:避免将历史参数加载到后台调用中,防止在自动更新期间出现上下文膨胀。
  • 简短 ID 解析引擎:将临时本地标识标记解析为远程数据库条目,以加快手动客户端触发的速度。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*