ThingsBoard设备管理

技能简介

ThingsBoard Skill 通过 curl 命令与 ThingsBoard REST API 交互，管理 IoT 平台的设备、仪表盘、遥测数据和用户资源。

业务背景

IoT运维团队需要实时掌握分散设备的状态，传统登录平台逐台查看效率低下。该工具通过命令行直接调取ThingsBoard核心数据，支持批量查询设备清单、遥测记录和属性配置，加速故障排查和资产盘点。

落地案例：某智慧园区管理方接入2000+传感器，值班人员通过脚本批量获取所有设备的温度、湿度最新读数，快速定位异常点位；同时定期导出设备台账用于资产审计，无需反复切换Web界面操作。

能做什么

• 获取认证令牌并管理会话
• 查询和管理租户设备列表
• 读取设备遥测数据与时序记录
• 操作设备属性（客户端/共享/服务端作用域）
• 创建和管理可视化仪表盘
• 控制仪表盘的公开访问权限

使用说明

环境准备

1. 安装依赖工具：sudo apt-get install jq curl
2. 设置环境变量：

   export TB_URL="http://localhost:8080"
   export TB_USERNAME="tenant@thingsboard.org"
   export TB_PASSWORD="tenant"

3. 获取认证令牌：

   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')

常用操作示例

列出所有设备：

curl -s "$TB_URL/api/tenant/devices?pageSize=100&page=0" \
  -H "X-Authorization: Bearer $TB_TOKEN" | jq '.data[] | {name, id: .id.id, type}'

获取最新遥测数据：

curl -s "$TB_URL/api/plugins/telemetry/DEVICE/{deviceId}/values/timeseries?keys=temperature,humidity" \
  -H "X-Authorization: Bearer $TB_TOKEN" | jq

公开仪表盘：

curl -s -X POST "$TB_URL/api/customer/public/dashboard/{dashboardId}" \
  -H "X-Authorization: Bearer $TB_TOKEN" | jq

输入与输出

见下方输入与输出表格。

风险提示

• 令牌过期后需重新获取或刷新
• 生产环境建议使用 HTTPS 并妥善保管凭证
• 删除时序数据操作不可逆
• 公开仪表盘可能暴露敏感信息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hoangnv170752/thingsboard-skill/SKILL.md
来源类型：开源社区技能