TME OpenAPI Skill for Openclaw

A universal client for discovering and invoking Tencent Music OpenAPI operator services with fully automated authentication.

sky-lv
v1.0.0
May 10, 2026
0
290
11

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tme-openapi

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tme-openapi using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is TME OpenAPI Skill?

TME OpenAPI is a foundational capability layer designed for Openclaw Skills to interact with the Tencent Music Open Platform. It abstracts the complexity of the operator system, where each operator acts as a backend API callable by an AI agent. This skill provides a standardized gateway for discovering available APIs, querying their technical schemas, and executing calls without hardcoding business semantics.

Built with developer experience in mind, it features a self-contained authentication module. It handles the complete lifecycle of tme-header-token acquisition—from initial browser-based QR code login to automated background refreshes—ensuring that upper-level business skills can focus entirely on orchestration and logic rather than credential management.

TME OpenAPI Skill Use Cases

  • Discovering available backend operator APIs for music promotion, distribution, and artist management.
  • Fetching detailed input and output schemas for specific Tencent Music API codes to ensure technical accuracy.
  • Invoking synchronous music data services through a standardized JSON-based interface.
  • Automating the login and token refresh process for long-term AI agent deployments on the Tencent Music platform.

How TME OpenAPI Skill Works

  1. The AI agent triggers a discovery phase using search_apis or list_apis to find relevant operator codes.
  2. If parameter structures are unknown, the agent calls get_api_detail to retrieve the Markdown-based detailedDescription and inputSchema.
  3. Upon preparing the structured JSON arguments, the skill executes invoke_api to send a POST request to the Tencent Music production endpoint.
  4. The internal authentication module automatically checks for a valid token in ~/.tme-login/token.json, falling back to a headless Playwright refresh or a manual QR login if necessary.
  5. The skill receives the unified response structure and returns the data, success status, and metadata to the caller.

TME OpenAPI Skill Setup

The skill is designed to be zero-config for most users. However, if the Playwright dependency is missing, the following commands should be executed to enable browser-based login:

python3 -m pip install --upgrade playwright
python3 -m playwright install chromium

To force a fresh login and clear existing credentials, use:

rm -f ~/.tme-login/storage_state.json ~/.tme-login/token.json
python scripts/login.py

TME OpenAPI Skill Data Schema & Taxonomy

The skill manages local authentication state and interacts with the TME OpenAPI using the following data structures:

Data Type Format Storage Location
Access Token JSON (token.json) ~/.tme-login/token.json
Browser State JSON (cookies + localStorage) ~/.tme-login/storage_state.json
API Response { success: bool, data: obj, error: obj, meta: obj } In-memory / HTTP Response

All arguments passed to invoke_api must strictly follow the inputSchema provided by the operator's metadata.

TME OpenAPI Skill Advanced Features

  • Multi-tier Token Fallback: Features a four-stage recovery chain (Cache -> Headless Playwright -> Headed QR Login -> Manual Paste).
  • Automated Dependency Injection: Internal scripts detect and install Playwright/Chromium automatically to minimize runtime interruptions.
  • Detailed Schema Discovery: Deep inspection of operator capabilities including exampleInput and exampleOutput for high-precision tool calling.
  • Synchronous Lifecycle Management: Native handling of TME's synchronous API platform, ensuring result availability in a single request-response cycle.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*