What makes openclaw-smartpi notable?

1.3K downloads. Trust evidence available

How should openclaw-smartpi be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

openclaw-smartpi

SmartPi 设备绑定、扫码、设备管理与连接故障排查。Use when the user mentions binding SmartPi, SmartPi QR code, 9002, SmartPi connection failure, listing SmartPi devices, or removi... Skill: openclaw-smartpi Owner: fengseven777 Summary: SmartPi 设备绑定、扫码、设备管理与连接故障排查。Use when the user mentions binding SmartPi, SmartPi QR code, 9002, SmartPi connection failure, listing SmartPi devices, or removi... Tags: latest:1.0.8 Version history: v1.0.8 | 2026-06-24T08:08:58.666Z | user Summary: Removed sample documentation; enhanced troubleshooting process for unresponsive SmartPi devices. - Removed the file skil

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.3k

Updated

Oct 10, 2026

Version

1.0.8

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.3K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.8release · observed Jun 24, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17fw757czgkjmbajwznw1kg5s83gwz7:smartpi

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fengseven777-smartpi/snapshot"

Documentation

CLAWHUB

60,451 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

skill.md

---
name: smartpi
description: SmartPi 设备绑定、扫码、设备管理与连接故障排查。Use when the user mentions binding SmartPi, SmartPi QR code, 9002, SmartPi connection failure, listing SmartPi devices, or removing a SmartPi device.
allowed-tools: terminal, read_file, grep, find_path
context: local-first
---

# SmartPi 

帮助用户完成 SmartPi 插件安装检查、设备扫码绑定、设备列表查看、设备删除，以及 `9002` / 连接失败等常见问题排查。

## 设计原则

- **元信息负责触发**：`description` 必须直接覆盖用户常见说法，例如 SmartPi 绑定、二维码、9002、连接失败、查看设备、删除设备。
- **正文负责执行**：按任务给出明确步骤、成功判定、失败分支和用户输出。
- **本地优先**：优先使用本机 `openclaw` 命令、Gateway 配置和日志，不假设外部服务可用。
- **最小副作用**：删除设备、安装插件、重启 Gateway、修改配置前必须说明影响并征得用户确认。

## 触发条件

当用户提出以下请求时使用本 Skill：

- **绑定设备**：绑定 SmartPi、添加 SmartPi、生成 SmartPi 二维码、扫码绑定。
- **设备管理**：查看 SmartPi 设备、列出已绑定设备、删除 SmartPi 设备。
- **连接故障**：SmartPi 连接失败、设备不在线、WebSocket 断开。
- **9002 故障**：用户看到 `9002`、`AI response timeout`、语音请求无响应或超时。
- **插件配置**：安装 `openclaw-smartpi`、检查插件是否启用、修复 `channels.openclaw-smartpi`。

## 不适用场景

- 用户问题与 SmartPi、OpenClaw Gateway、`openclaw-smartpi` 插件无关。
- 用户要求开发新功能、改插件源码或调试非 SmartPi 通道时，应转入代码分析/开发类流程。
- 用户只询问泛化 IoT、语音识别或硬件设计知识时，不应直接执行 OpenClaw 命令。

## 快速路由

| 用户意图 | 首选流程 | 主要成功判定 |
| --- | --- | --- |
| 绑定/添加 SmartPi | [流程：绑定设备](#流程绑定设备) | 日志出现 `WebSocket connected: <deviceKey>` |
| 查看/列出设备 | [流程：查看设备](#流程查看设备) | `accounts list` 返回设备列表 |
| 查询设备连接状态 | [流程：查询设备连接状态](#流程查询设备连接状态) | `accounts status` 返回设备在线/离线状态 |
| 删除设备 | [流程：删除设备](#流程删除设备) | 删除命令成功且列表不再包含该设备 |
| 安装/启用插件 | [流程：首次安装或修复插件](#流程首次安装或修复插件) | `plugins list` 显示 `openclaw-smartpi: enabled` |
| 9002/超时 | [流程：9002 排查](#流程9002-排查) | 定位为连接、路由或 AI 响应链路问题 |

## 执行前检查

在执行会改变状态的动作前，先确认用户意图是否明确。

1. 检查 OpenClaw CLI 是否可用：`openclaw --help`
2. 检查插件状态：`openclaw plugins list`
3. 检查已绑定设备：`openclaw smartpi accounts list`
4. 若需要修改配置，先读取完整配置，再构造完整 patch。

## 流程：绑定设备

### 目标

生成 SmartPi 绑定二维码，让用户扫码绑定，并确认设备通过 WebSocket 上线。

### 执行步骤

1. 执行绑定命令：

```bash
openclaw smartpi accounts bind
```

2. 从输出中提取 `绑定ID:` 后的 `bindingId`。
3. 使用 `bindingId` 生成 `smartpi_qr.png`。
4. 把二维码图片发给用户，并提示：`请用微信扫一扫，绑定成功后我会继续确认设备连接状态。`
5. 等待 30-120 秒，检查日志中是否出现 `WebSocket connected: <deviceKey>`。
6. 连接成功后告知用户：`设备已连接，可以对着 SmartPi 说话了。`

### 二维码生成方式

优先使用当前环境已经安装的二维码工具，不要为了生成二维码自动安装依赖。

Python：

```python
import qrcode
binding_id = "REPLACE_WITH_ACTUAL_BINDING_ID"
qrcode.make(binding_id).save("smartpi_qr.png")
```

Node.js：

```bash
node -e "const id=process.argv[1]; require('qrcode').toFile('smartpi_qr.png',id,{type:'png'},e=>e&&console.error(e))" "REPLACE_WITH_ACTUAL_BINDING_ID"
```

### 成功判定

- 已生成二维码并发送给用户。
- 日志出现 `WebSocket connected: <deviceKey>`。
- `openclaw smartpi accounts list` 能看到新设备。

### 失败分支

- **未提取到 `bindingId`**：反馈绑定命令输出异常，并展示关键输出让用户确认。
- **二维码生成失败**：说明当前环境缺少二维码依赖，询问用户是否允许安装依赖或改用其他方式生成。
- **120 秒内未连接**：转入 [流程：连接失败排查](#流程连接失败排查)。
- **连接后仍不可用**：转入 [流程：9002 排查](#流程9002-排查)。

## 流程：查看设备

### 执行步骤

```bash
openclaw smartpi accounts list
```

### 输出要求

- 如果有设备，列出 `deviceKey`、在线状态或命令输出中的关键字段。
- 如果没有设备，提示用户可以执行绑定流程。
- 不要伪造设备状态；只根据命令输出和日志判断。

## 流程：查询设备连接状态

### 目标

通过设备号查询指定设备的在线/离线连接状态。

### 执行步骤

1. 如果用户未提供设备号，先执行

_meta.json

{
  "ownerId": "kn72bjnwex9cmswhrh2b11zj15837qpb",
  "slug": "smartpi",
  "version": "1.0.8",
  "publishedAt": 1782288538666
}

skill-card.md

## Description:

SmartPi device binding, QR-code setup, device management, and troubleshooting for connection failures, 9002 timeouts, and unresponsive SmartPi devices.

This skill is ready for commercial/non-commercial use.

## Publisher:

[fengseven777](https://clawhub.ai/user/fengseven777)

### License/Terms of Use:

MIT-0

## Use Case:

External OpenClaw users and developers use this skill to bind and manage SmartPi devices, check plugin and Gateway status, and diagnose connection, routing, and AI response timeout issues.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Installing or repairing the OpenClaw SmartPi plugin can change the local environment.

Mitigation: Confirm the plugin source, publisher, and version before approving installation or repair.

Risk: Device removal, configuration changes, and Gateway restart can alter local state or interrupt service.

Mitigation: Proceed only after explicit user confirmation and only when the action matches the requested SmartPi task.

Risk: Incorrect channel configuration can break message routing for SmartPi or other channels.

Mitigation: Read the full configuration first, preserve existing channel entries, and verify that channels.openclaw-smartpi matches the plugin channel id.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/fengseven777/skills/smartpi)

## Skill Output:

**Output Type(s):** [Guidance, Shell commands, Configuration, Markdown]

**Output Format:** [Markdown guidance with inline shell commands, JSON configuration examples, status summaries, and next-step recommendations]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Local-first troubleshooting; state-changing actions require user confirmation.]

## Skill Version(s):

1.0.8 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular