iot-platform_skill

Overview

This skill is a practical guide to connect to Cloud Studio IoT's OpenClaw platform via the MCP (Model Context Protocol) API. It documents how to verify and configure the OpenClaw gateway, add an MCP server entry for clients like Claude Code, and use the gateway to interact with devices and channels. The guide is focused on configuration steps, gateway modes, available MCP tools, and troubleshooting tips.

How this skill works

The gateway exposes an MCP server endpoint (SSE) that MCP clients can register in their settings to gain programmatic access to OpenClaw resources. Once configured, the gateway presents tools and resources such as device lists, sensor reads, channel management, and command execution over URIs like openclaw://devices. The guide explains local loopback and Tailscale binding modes, plus authentication options for public access.

When to use it

• Setting up an MCP client (e.g., Claude Code) to control OpenClaw devices
• Sending commands to IoT devices or running agent tasks on the gateway
• Reading live sensor data or enumerating device/ channel resources
• Configuring remote access via Tailscale (serve or funnel modes)
• Troubleshooting gateway connectivity, ports, or authentication

Best practices

• Verify gateway health with curl http://127.0.0.1:18789/healthz before adding MCP entries
• Use loopback binding for local-only development and Tailscale serve/funnel for remote access
• Store funnel mode passwords securely and keep gateway auth config synchronized with MCP client settings
• Restart the gateway and monitor journalctl logs when encountering connectivity issues
• Test MCP tooling visibility in your client after changing mcpServers settings and restarting the client

Example use cases

• Add the openclaw MCP server to Claude Code to expose device and sensor tools within the client
• Issue an actuator command to a specific device using openclaw_device_command from an MCP client
• Poll openclaw://devices/{id}/sensors to ingest telemetry into a monitoring workflow
• Send notifications through configured channels (e.g., Telegram) using openclaw_channel_send
• Run maintenance or automation tasks on the gateway with openclaw_agent_run