$cd ../integrations/
🔌 IoT 集成专业版15 分钟配置
IoT 的 AI 方案：MQTT 发布/订阅
/** 让 OpenClaw 监听数千个传感器数据流，并使用轻量级 MQTT 协议操控现实世界中的物理开关。 */
intelligent_iot.log
硬件的感知逻辑
与其在 Node-RED 或 Home Assistant 中编写脆弱的硬编码规则，OpenClaw 为您的 MQTT 代理提供了直接桥接。通过将高频遥测状态推送到 LLM 并授予发布权限，它将成为一个有感知能力的逻辑引擎。它不仅仅是“运行脚本”，而是根据传感器上下文推断意图。例如，当光照传感器数值下降且检测到有人时，它会自动调暗灯光，而无需显式的 IF/THEN 逻辑块。
broker.sh
1. 代理设置 (Mosquitto/EMQX)
我们假设您已经在本地运行了代理。为了获得最佳性能，请确保您的代理与 OpenClaw 处于同一 VPC 或子网中。
# Mosquitto Docker launch
docker run -d -p 1883:1883 eclipse-mosquitto
mcp_bridge.json
2. MCP 到 MQTT 桥接器
OpenClaw 使用通用桥接器将 MQTT 消息转换为 MCP 资源。您无需编写 Python 模板代码；只需在配置中声明代理账号凭据即可。
"command": "npx",
"args": ["@clawdhub/mcp-mqtt-bridge"]
workflow.md
3. IoT 工作流：感知与行动
广播整个传感器树可能会让上下文窗口过载。我们建议使用特定的“暴露主题”来让代理专注于相关的遥测数据。
[1]mqtt_subscribe(topic)：从任何订阅路径读取实时负载。[2]mqtt_publish(topic, payload)：通过向执行器发送指令来执行物理操作。
prompts_library.log
4. 实用自动化示例
传感智能
- ⫸"在 home/sensors/air/co2 检查客厅的二氧化碳水平。"
- ⫸"home/garden/soil/1 上的花园土壤水分是否低于 20%？"
硬件执行
- ⫸"如果 CO2 > 1000ppm，通过向 home/actuators/window/cmd 发布 'OPEN' 来打开窗户。"
- ⫸"触发 home/garden/pump/set 上的灌溉系统。"
🛡️ 安全与边缘智能
关键提示：语言模型可能会产生幻觉。切勿在没有物理硬连线安全保护的情况下，让 mqtt_publish 访问生命攸关的基础设施或高发热量设备。在 Mosquitto 配置文件中使用特定的主题 ACL（访问控制列表）来限制 OpenClaw 的操作权限。
❓ FAQ
Q1. 支持哪些 MQTT 代理？
所有标准 MQTT 3.1.1/5.0 代理：Mosquitto、HiveMQ、EMQX 等。
Q2. 能控制设备吗？
能。向 MQTT 主题发布消息控制灯光、开关等设备。