A comprehensive automation tool for managing ThingsBoard IoT platform resources, telemetry data, and dashboard configurations via REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install thingsboard-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install thingsboard-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 ThingsBoard?
The ThingsBoard skill for Openclaw Skills offers a robust framework for interacting with the ThingsBoard IoT platform. It enables developers and system administrators to programmatically manage the entire lifecycle of IoT entities, from device provisioning and credential management to complex telemetry data retrieval. By utilizing this skill, users can integrate ThingsBoard functionalities into larger automation workflows, ensuring efficient management of smart environments and industrial IoT setups.
This integration simplifies the interaction with the platform's REST API, providing pre-configured commands for authentication, asset organization, and user management. Whether you are scaling a multi-tenant environment or monitoring specific device attributes, this skill provides the necessary tools to maintain high visibility and control over your IoT infrastructure within the Openclaw Skills ecosystem.
ThingsBoard Use Cases
- Automating the onboarding process for new IoT devices and managing their security credentials.
- Fetching real-time and historical telemetry data for external data analytics or reporting.
- Programmatically managing dashboard visibility and public access for stakeholder demonstrations.
- Synchronizing device attributes across client, shared, and server scopes for state management.
- Auditing and managing tenant users and customer accounts to ensure secure platform access.
How ThingsBoard Works
- The skill authenticates with the designated ThingsBoard server using provided credentials to retrieve a JWT access token.
- Commands are issued using curl and jq to interact with specific API endpoints for devices, assets, or telemetry.
- The skill handles entity identification using specific UUID formats required by the ThingsBoard REST API architecture.
- Telemetry and attribute requests are processed using scoped keys to ensure data is retrieved from or sent to the correct logical layer (Client, Shared, or Server).
- For long-term operations, the skill manages token expiration by providing mechanisms for re-authentication and token refreshing.
ThingsBoard Setup
To get started with this skill in Openclaw Skills, configure your environment and credentials:
# Set your ThingsBoard instance details
export TB_URL="http://localhost:8080"
export TB_USERNAME="[email protected]"
export TB_PASSWORD="tenant"
# Retrieve your initial authentication token
export TB_TOKEN=$(curl -s -X POST "$TB_URL/api/auth/login" \
-H "Content-Type: application/json" \
-d "{\"username\":\"$TB_USERNAME\",\"password\":\"$TB_PASSWORD\"}" | jq -r '.token')
ThingsBoard Data Schema & Taxonomy
The skill organizes and retrieves data based on the standard ThingsBoard entity model. Below is a summary of the data structures used:
| Entity Type | Description | Key Metadata Fields |
|---|---|---|
| Devices | Physical or virtual IoT sensors | name, type, id.id, credentials |
| Telemetry | Time-series sensor data | ts (milliseconds), key, value |
| Attributes | Key-value pairs for configuration | scope (SERVER, SHARED, CLIENT), key, value |
| Dashboards | UI visualization layouts | name, id, publicAccess status |
| Assets | Logical grouping of devices | name, type, id.id |
| Users | Platform access accounts | email, firstName, lastName, authority |
ThingsBoard Advanced Features
- Multi-scope attribute management allowing granular control over server-side and device-side configurations.
- Historical data extraction with millisecond precision and configurable limits for deep-dive analytics.
- Public access automation for dashboards, enabling quick sharing of IoT visualizations without manual UI clicks.
- Full support for multi-tenant architectures, including customer and asset hierarchy management.
- Integration with jq for advanced JSON filtering of API responses directly in the CLI.
SKILL.md
Loading
Related Openclaw Skills
Relationship Coach
An AI-driven relationship coaching agent utilizing Internal Family Systems and Emotionally Focused Therapy to help couples navigate conflict and deepen connection.
X Hot Topics Daily
An automated social intelligence skill that scrapes X for high-value trends in AI, LLM, and global news while filtering out marketing noise.
Macro Monitor
A professional financial intelligence agent that monitors, aggregates, and explains global macroeconomic indicators and policy shifts every 24 hours.
Crypto Market Analyzer
An automated cryptocurrency analysis tool that generates technical reports and sentiment insights for Bitcoin and Ethereum using real-time market data.
confcli
A high-performance CLI tool for interacting with Confluence Cloud spaces, pages, and attachments directly from your terminal.
Home Assistant Control
A robust technical bridge allowing AI agents to control, inspect, and automate Home Assistant devices through a secure REST API interface.
Featured*
