thingsboard

What This Skill Does

The ThingsBoard Skill for OpenClaw provides a robust interface for interacting with the ThingsBoard IoT platform via its REST API. This skill acts as a bridge between the AI agent and your IoT ecosystem, enabling seamless management of devices, telemetry data, and system resources. It allows for programmatic control over tenant devices, including retrieving device identification, verifying security credentials, and querying sophisticated time-series data. By automating these API interactions, users can bridge the gap between raw machine data and intelligent actionable insights without manually crafting complex curl requests.

Installation

To integrate this skill, ensure you have the OpenClaw environment properly initialized. Run the following command in your terminal: clawhub install openclaw/skills/skills/hoangnv170752/thingsboard-skill. Post-installation, you must configure your credentials.json file as detailed in the technical documentation, ensuring your TB_URL, TB_USERNAME, and TB_PASSWORD environment variables are correctly exported to allow the agent to authenticate with your specific ThingsBoard instance.

Use Cases

This skill is ideal for IoT engineers and system integrators who need to automate daily operations. Use cases include:

• Automated Fleet Monitoring: Querying status and telemetry from hundreds of devices to identify potential maintenance needs.
• Data Analysis Pipelines: Extracting historical sensor readings for specific time ranges to feed into external analytics or report generation tools.
• Security Auditing: Periodically verifying device credential status and managing user access levels within the platform.
• Diagnostic Support: Quickly fetching error logs and system attributes to debug faulty hardware deployments remotely.

Example Prompts

1. "List all devices currently registered to my tenant and show me their IDs and types."
2. "Get the last hour of temperature and humidity readings for the device with ID 'sensor-alpha-001'."
3. "Refresh my ThingsBoard session token using the current environment credentials and confirm my user profile information."

Tips & Limitations

• Security: Always rotate your credentials regularly and avoid hardcoding passwords in scripts. Utilize the credentials.json approach.
• Time Stamps: Remember that ThingsBoard expects timestamps in milliseconds; the skill handles conversion, but ensure your queries are scoped correctly to avoid heavy server load.
• Rate Limiting: If your deployment has thousands of devices, use the pageSize parameter effectively in your API calls to prevent timeouts or hitting API limits.