clscli

What This Skill Does

The clscli skill provides a command-line interface for the Tencent Cloud Log Service (CLS). It allows users to interact with their cloud infrastructure logs directly from the terminal or through an AI agent. You can perform complex log analysis using CQL or SQL, search for errors, monitor application performance, and audit cloud events efficiently. It abstracts the complexity of the Tencent Cloud API, enabling you to list log topics, query specific log entries, and export log data to various formats like JSON or CSV for further analysis.

Installation

To integrate this skill, follow these steps:

1. Ensure you have Homebrew installed, then run: brew tap dbwang0130/clscli && brew install dbwang0130/clscli/clscli
2. Acquire your Tencent Cloud API credentials (Secret ID and Secret Key) from the Tencent Cloud Console.
3. Set your credentials as environment variables in your terminal profile: export TENCENTCLOUD_SECRET_ID="your-secret-id" export TENCENTCLOUD_SECRET_KEY="your-secret-key"
4. Install the skill into your OpenClaw environment using: clawhub install openclaw/skills/skills/dbwang0130/clscli

Use Cases

• Incident Response: Quickly grep error logs across multiple services during an outage to identify root causes.
• Operational Monitoring: Extract metrics from log data using SQL aggregation to track request latency or error rates over the last hour.
• Audit Compliance: Export security logs or access logs to CSV for regular compliance reporting and review.
• Development Debugging: Filter logs for a specific User ID or Request ID to trace user journeys through your application backend.

Example Prompts

1. "List all log topics in the ap-guangzhou region to see what data sources I have available."
2. "Search for all logs with level:ERROR in topic 'app-logs' for the last 30 minutes and output as JSON."
3. "Calculate the count of requests grouped by status code for the last hour using SQL in the 'web-server' log topic."

Tips & Limitations

• Pre-check: Always use clscli topics first if you are unsure of the log topic ID or region name to avoid failed queries.
• Syntax: Prefer the CLS Query Language (CQL) for general log searches as it is optimized for speed and readability compared to Lucene.
• Performance: When running large queries, use the --max flag to prevent excessive API consumption and ensure your terminal doesn't get flooded with results; it will handle pagination automatically.
• Security: Never hardcode your API keys in scripts; always use environment variables or secure vault integrations to manage access.