From bdfd13078aa635a0d6133e1e5a75c83211b44137 Mon Sep 17 00:00:00 2001
From: andrew-iotx <andrew@iotex.io>
Date: Mon, 9 Mar 2026 19:27:35 -0700
Subject: [PATCH] Add OpenClaw skill integration docs

Add trio-vision OpenClaw skill documentation with install instructions,
usage examples, and supported stream types. Published on ClawHub as
trio-vision@1.0.0.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 README.md          |  1 +
 openclaw/README.md | 87 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+)
 create mode 100644 openclaw/README.md

diff --git a/README.md b/README.md
index 2fb2408..e1e9cf2 100644
--- a/README.md
+++ b/README.md
@@ -68,6 +68,7 @@ print(f"Job started: {job['job_id']}")
 | [quickstart/live_digest.py](quickstart/live_digest.py) | Stream summarization |
 | [webhook-server/](webhook-server/) | FastAPI webhook receiver |
 | [mcp/](mcp/) | AI agent integration (Claude, GPT) |
+| [openclaw/](openclaw/) | OpenClaw skill — smart camera alerts via chat |
 
 ## Installation
 
diff --git a/openclaw/README.md b/openclaw/README.md
new file mode 100644
index 0000000..575719f
--- /dev/null
+++ b/openclaw/README.md
@@ -0,0 +1,87 @@
+# Trio + OpenClaw Integration
+
+Use Trio directly from your [OpenClaw](https://openclaw.ai) AI agent. Ask questions about live video streams, set up smart alerts, and get periodic summaries — all in natural language through your chat.
+
+## Install
+
+From [ClawHub](https://clawhub.ai):
+
+```bash
+clawhub install trio-vision
+```
+
+Or from GitHub:
+
+```bash
+git clone https://github.com/drandrewlaw/trio-openclaw-skill.git ~/.openclaw/skills/trio-vision
+```
+
+## Setup
+
+1. Get your API key at [console.machinefi.com](https://console.machinefi.com) (100 free credits on signup)
+2. Set the environment variable:
+   ```bash
+   export TRIO_API_KEY="your_key_here"
+   ```
+3. Restart your OpenClaw gateway:
+   ```bash
+   openclaw gateway restart
+   ```
+4. Verify the skill is ready:
+   ```bash
+   openclaw skills list
+   ```
+
+## Usage
+
+Once installed, just chat with your agent naturally:
+
+| What You Say | What Happens | Cost |
+|-------------|-------------|------|
+| "Is anyone at my front door?" | Instant answer with VLM explanation | $0.01 |
+| "Alert me when a package is delivered" | Continuous monitoring, notifies on match | $0.02/min |
+| "Summarize this stream every 10 minutes" | Periodic narrative digests | $0.02/min |
+
+### Quick Check
+
+Ask a yes/no question about any live stream:
+
+> "Check this stream and tell me if there are people visible: https://www.youtube.com/live/STREAM_ID"
+
+### Smart Alerts
+
+Set up monitoring with natural-language conditions:
+
+> "Watch my front door camera and tell me when a person (not a cat) approaches: rtsp://192.168.1.100/stream"
+
+### Periodic Summaries
+
+Get narrative digests at regular intervals:
+
+> "Summarize what's happening on this construction site every 15 minutes: https://www.youtube.com/live/STREAM_ID"
+
+## Supported Streams
+
+- YouTube Live
+- Twitch
+- RTSP/RTSPS cameras
+- HLS streams
+
+## How It Works
+
+The skill gives your OpenClaw agent instructions to call the Trio API using `curl`. When you ask about a video stream, the agent:
+
+1. Sends the stream URL and your question to Trio's `/check-once` endpoint
+2. Trio extracts frames from the stream and analyzes them with a Vision LLM
+3. Returns a `triggered` (yes/no) result and an `explanation` of what it sees
+4. Your agent delivers the answer in your chat
+
+For monitoring, the agent creates a background job via `/live-monitor` that checks at regular intervals and alerts you when the condition is met.
+
+## Links
+
+- [Trio API Docs](https://docs.machinefi.com)
+- [Trio Console](https://console.machinefi.com)
+- [OpenClaw](https://openclaw.ai)
+- [ClawHub](https://clawhub.ai)
+- [Skill Source (GitHub)](https://github.com/drandrewlaw/trio-openclaw-skill)