TencentDB DatabaseClaw for Openclaw

An automation-ready AI client that enables direct, streaming communication with TencentDB DatabaseClaw instances via secure TC3-signed SSE APIs for database inspection and SQL execution.

tencent-adm
v1.0.1
Jun 15, 2026
1
500
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install tencentdb-databaseclaw-skill

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 tencentdb-databaseclaw-skill 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 TencentDB DatabaseClaw?

The TencentDB DatabaseClaw integration is a highly specialized skill designed for developers and AI systems requiring real-time, streaming database operations. Utilizing the secure Tencent Cloud CreateChatCompletion SSE API, this tool empowers workflows to execute complex SQL queries, inspect database schemas, and perform automated data analysis. It functions as a secure bridge between your AI agents and your cloud databases, offering certified Python client scripts and complete TC3-HMAC-SHA256 signature references for robust authentication.

By utilizing Openclaw Skills, developers can rapidly deploy this capability inside agentic pipelines without writing complex boilerplate code for SSE stream parsing or cryptographic signing. It ensures low-latency execution and seamless agent-to-agent database interactions, transforming how autonomous systems fetch and analyze database records.

TencentDB DatabaseClaw Use Cases

  • Integrating automated SQL query execution and database schema inspection directly into autonomous AI agent workflows.
  • Building secure cross-product function-calling sequences where TencentDB DatabaseClaw serves as a backend analytical tool.
  • Verifying the operational health and connection status of a remote DatabaseClaw instance through automated test messaging.
  • Implementing a streamlined interface for LangChain, CrewAI, or custom LLM frameworks utilizing Openclaw Skills to request database telemetry.

How TencentDB DatabaseClaw Works

  1. Instance Health Verification: The skill checks if the target TencentDB DatabaseClaw instance is in a running state. Users can confirm active status via the Tencent Cloud Console.
  2. Session Creation: By default, the client initiates CreateClawSession to acquire a SessionKey, enabling full visibility of the conversation directly inside the cloud console list.
  3. Secure API Request: A request is dispatched to the SSE streaming host (tdai.ai.tencentcloudapi.com) with a valid TC3-HMAC-SHA256 signature generated dynamically.
  4. Stream Processing: The client initiates an HTTP connection expecting text/event-stream and begins parsing continuous incoming data chunks.
  5. Frame Decomposition: The client processes specific stream events such as tool calls, tool results, partial message chunks, and keep-alive heartbeats.
  6. Response Assembly: The CLI client strips wrapper headers, concatenates the text tokens, and provides a clean final stdout response to the caller.

TencentDB DatabaseClaw Setup

To use this tool within Openclaw Skills, ensure you have Python 3 and its standard libraries available.

Execute a test conversation by running the provided CLI client:

# Default behavior: Automatically handles session creation and sends a clean message
python3 scripts/chat.py \
  --instance-id $INSTANCE_ID \
  --secret-id $SECRET_ID \
  --secret-key $SECRET_KEY \
  --message "Show slow queries from the last 7 days"

To bypass session creation so that the interaction is hidden from the Tencent Cloud session history console:

python3 scripts/chat.py \
  --instance-id $INSTANCE_ID \
  --secret-id $SECRET_ID \
  --secret-key $SECRET_KEY \
  --no-session \
  --message "SELECT 1;"

For developers debugging the inner agent steps, enable verbose logging:

python3 scripts/chat.py -v \
  --instance-id $INSTANCE_ID \
  --secret-id $SECRET_ID \
  --secret-key $SECRET_KEY \
  --message "Find MySQL instances in ap-shanghai"

TencentDB DatabaseClaw Data Schema & Taxonomy

File Structure

Path Purpose
scripts/chat.py Standalone CLI client executing SSE requests without external dependencies.
references/python-integration.md Verification documentation covering manual TC3-signing algorithms and response parsing logic.

Streaming Event Structure

The dynamic SSE stream generates events that map into the workflow as follows:

Event Object Purpose Action Required
First Frame Returns the ChatId Capture and persist for multi-turn conversational context
claw.tool_call Indicates the agent is performing a query/action Optionally display progress bars or logs
claw.partial / chat.chunk Emits raw text slices Append dynamically to the stdout buffer
claw.final Stream termination Finalize display and terminate the socket connection
heartbeat Every 20 seconds keep-alive Silently drop or ignore

TencentDB DatabaseClaw Advanced Features

  • Session Synchronization: Native CreateClawSession support links automated agent queries directly to the console visual history interface.
  • Automatic Keep-Alive Handling: Built-in logic filters out periodic 20-second heartbeat frames to maintain clean output streams.
  • Clean Pipeline Mode: Designed with a Unix philosophy to output clean final text to stdout, facilitating effortless piping into subsequent Openclaw Skills or shell tasks.
  • Zero-Dependency Core: The included integration references require nothing but the Python standard library, ensuring high portability across containerized deployment environments.
  • TC3 Signing Reference: Pre-calculated signature checklists preventing time-drift errors or bad parameter rejections during high-security transactions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*