S
SkillNav

物联代理

xlink-iot-agent

by allenkwok

Xlink IoT Agent - Query IoT devices and events via Xlink Gateway API. Provides device overview, device list, event instance queries, and alert statistics. Use when managing IoT devices and monitoring events on the XLink IoT platform.

3.9kAI 与智能体未扫描2026年3月30日

安装

claude skill add --url https://github.com/openclaw/skills

必需环境变量

XLINK_APP_IDXLINK_APP_SECRETXLINK_API_GROUP

文档

Xlink IoT Agent

Control and query IoT devices and events on the XLink IoT platform via GatewayAppClient with signature-based authentication.

When to Use

✅ Use This Skill When

  • Querying device status and statistics on XLink IoT platform
  • Monitoring device alerts and events
  • Batch querying device attributes (latest values or historical data)
  • Remote control of IoT devices (invoking thing model services)
  • Filtering device data by project/product

❌ Do Not Use This Skill For

  • Other IoT platforms (AWS IoT, Azure IoT, Alibaba Cloud IoT, etc.)
  • Direct local device control (not via XLink IoT platform)
  • Historical weather data or severe weather alerts (use weather skill)
  • Non-IoT related device management tasks

Quick Start

1. Set Environment Variables

bash
export XLINK_BASE_URL="https://api-gw.xlink.cn"
export XLINK_APP_ID="your-app-id"
export XLINK_APP_SECRET="your-app-secret"
export XLINK_API_GROUP="your-group-id"

2. Run Commands

bash
cd /path/to/xlink-iot-agent

# Device overview
python scripts/xlink_api.py overview

# Pending events
python scripts/xlink_api.py event-instances --status 1 --limit 20

# Alert statistics (last 24 hours)
python scripts/xlink_api.py alert-statistics

# Device control
python scripts/xlink_api.py device-control \
  --thing-id 10299402 \
  --service device_attribute_set_service \
  --input '{"PowerSwitch":true}'

Core Commands

CommandFunctionExample
overviewDevice overview statisticspython scripts/xlink_api.py overview
device-listDevice list querypython scripts/xlink_api.py device-list --limit 20
device-trendDevice statistics trendpython scripts/xlink_api.py device-trend --start-time "2026-03-17T00:00" --end-time "2026-03-24T23:59"
device-historyDevice attribute history snapshotspython scripts/xlink_api.py device-history --device-ids 300513220,501548135
device-latestDevice latest attributespython scripts/xlink_api.py device-latest --device-ids 300513220,501548135
device-controlDevice controlpython scripts/xlink_api.py device-control --thing-id 10299402 --service device_attribute_set_service --input '{"PowerSwitch":true}'
alert-overviewAlert overviewpython scripts/xlink_api.py alert-overview
alert-statisticsAlert time-series statisticspython scripts/xlink_api.py alert-statistics --interval hour
event-instancesEvent instance querypython scripts/xlink_api.py event-instances --status 1 --limit 20

Common Query Examples

Device Overview

bash
python scripts/xlink_api.py overview

Output:

code
==================================================
📊 XLINK Device Overview
==================================================

   📱 Total Devices:    7823
   🟢 Online:           143 (1.8%)
   ✅ Activated:        6756 (86.4%)
   ⚫ Offline:          7680
   ⏸️  Not Activated:   1067

Pending Events

bash
python scripts/xlink_api.py event-instances --status 1 --limit 20

Alert Overview

bash
python scripts/xlink_api.py alert-overview

Device List (with Filtering)

bash
# Filter by project
python scripts/xlink_api.py device-list \
  --query '{"logic":"AND","device":{"project_id":{"$eq":"XJA1JJAJA"}}}' \
  --limit 20

# JSON output
python scripts/xlink_api.py device-list --limit 20 --json

Device Control

bash
# Set attributes
python scripts/xlink_api.py device-control \
  --thing-id 10299402 \
  --service device_attribute_set_service \
  --input '{"ColorTemperature": 8}'

# With command cache (10 minutes)
python scripts/xlink_api.py device-control \
  --thing-id 10299402 \
  --service device_attribute_set_service \
  --input '{"Brightness": 100}' \
  --ttl 600

Control Response Codes:

CodeDescription
200✅ Success - device responded
202⏸️ Device offline - command not sent
408⚠️ Connection closed - device sleeping
503❌ Control failed

Python API

python
import sys
sys.path.insert(0, "scripts")
from xlink_api import XlinkIoTClient

# Initialize (reads from environment variables)
client = XlinkIoTClient()

# Device overview
overview = client.get_device_overview(project_id="ab582")

# Device list
devices = client.get_device_list(limit=50)

# Alert statistics
alerts = client.get_alert_statistics(interval="hour")

# Event instances
events = client.get_event_instances(status=[1], limit=20)

# Device control
result = client.control_device(
    thing_id="10299402",
    service="device_attribute_set_service",
    input_params={"PowerSwitch": True}
)

Detailed Documentation

Complete CLI command reference, parameter descriptions, and API documentation:

Error Handling

StatusDescriptionSolution
401 UnauthorizedInvalid credentialsCheck App ID/Secret
403 ForbiddenAccess deniedVerify Group ID and permissions
404 Not FoundResource not foundCheck endpoint path or resource ID
429 Too Many RequestsRate limitedImplement exponential backoff retry
500 Server ErrorServer errorRetry later

Best Practices

  1. Use pagination - For large datasets, use --offset and --limit
  2. Filter early - Apply filters (status, device, time) to reduce data transfer
  3. Cache results - Device status changes infrequently; cache for 30-60 seconds
  4. Handle rate limits - Implement exponential backoff for 429 errors
  5. JSON output for scripting - Use --json for programmatic parsing
  6. Debug mode - Use --debug for troubleshooting

相关 Skills

Claude接口

by anthropics

Universal
热门

面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景，自动识别项目语言并给出对应示例与默认配置，快速搭建 LLM 应用。

✎ 想把Claude能力接进应用或智能体，用claude-api上手快、兼容Anthropic与Agent SDK，集成路径清晰又省心

AI 与智能体
未扫描111.8k

计算机视觉

by alirezarezvani

Universal
热门

聚焦目标检测、图像分割与视觉系统落地，覆盖 YOLO、DETR、Mask R-CNN、SAM 等方案，适合定制数据集训练、推理优化及 ONNX/TensorRT 部署。

✎ 把目标检测、图像分割到推理部署串成完整工程链路，主流框架与 YOLO、DETR、SAM 等方案都覆盖，落地视觉 AI 会省心很多。

AI 与智能体
未扫描9.8k

智能体流程设计

by alirezarezvani

Universal
热门

面向生产级多 Agent 编排，梳理顺序、并行、分层、事件驱动、共识五种工作流设计，覆盖 handoff、状态管理、容错重试、上下文预算与成本优化，适合搭建复杂 AI 协作系统。

✎ 帮你把多智能体流程设计、编排和自动化统一起来，复杂工作流也能更稳地落地，适合追求强控制力的团队。

AI 与智能体
未扫描9.8k

相关 MCP 服务

知识图谱记忆

编辑精选

by Anthropic

热门

Memory 是一个基于本地知识图谱的持久化记忆系统，让 AI 记住长期上下文。

✎ 帮 AI 和智能体补上“记不住”的短板，用本地知识图谱沉淀长期上下文，连续对话更聪明，数据也更可控。

AI 与智能体
83.1k

顺序思维

编辑精选

by Anthropic

热门

Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。

✎ 这个服务器展示了如何让 Claude 像人类一样逐步推理，适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例，别指望直接用在生产环境里。

AI 与智能体
83.1k

PraisonAI

编辑精选

by mervinpraison

热门

PraisonAI 是一个支持自反思和多 LLM 的低代码 AI 智能体框架。

✎ 如果你需要快速搭建一个能 24/7 运行的 AI 智能体团队来处理复杂任务（比如自动研究或代码生成），PraisonAI 的低代码设计和多平台集成（如 Telegram）让它上手极快。但作为非官方项目，它的生态成熟度可能不如 LangChain 等主流框架，适合愿意尝鲜的开发者。

AI 与智能体
6.8k

评论