Quote/0

---

name: quote0 description: Control MindReset Dot Quote/0 through the local quote0.js script and Dot Developer Platform APIs. Use when the user asks to configure Quote/0, push text/image content, query device status, switch next content, list tasks, or troubleshoot Dot Open API integration. Requires credentials DOT_API_KEY and (for device actions) DOT_DEVICE_ID. homepage: https://dot.mindreset.tech/docs/service/open metadata: { "openclaw": { "emoji": "🖼️", "requires": { "bins": ["node"], "env": ["DOT_API_KEY", "DOT_DEVICE_ID"] }, "primaryEnv": "DOT_API_KEY", }, }

---

Quote/0 技能（v1.0.4）

使用本地脚本调用 Dot Developer Platform API：

node quote0.js  [options]

> 在技能目录内执行命令。

---

1) 凭据与安全（必须遵守）

必需凭据

DOT_API_KEY（必需）

DOT_DEVICE_ID（设备相关命令必需，如 status|next|list|text|image）

禁止事项

不要把 API Key / Device ID 硬编码到脚本、SKILL.md、Git 提交。

不要把敏感文件路径传给 --imageFile（脚本会读取该路径对应的本地文件并上传）。

推荐注入方式（按安全优先级）

1. 单次命令传参（最推荐） 2. 当前终端临时环境变量 3. 长期写入 shell 配置（仅在用户明确同意后）

> 若要持久保存环境变量（如写入 ~/.zshrc / ~/.bashrc / PowerShell profile），必须先征得用户明确同意。

---

2) 跨平台运行方式（macOS / Linux / Windows）

先进入技能目录：

cd /path/to/quote0

方式 A：单次命令传参（推荐）

node quote0.js devices --apiKey "..."
node quote0.js status --apiKey "..." --deviceId "..."

方式 B：临时环境变量

#### macOS / Linux（bash/zsh）

export DOT_API_KEY="你的_key"
export DOT_DEVICE_ID="你的_id"
node quote0.js devices
node quote0.js status

#### Windows PowerShell

$env:DOT_API_KEY="你的_key"
$env:DOT_DEVICE_ID="你的_id"
node .\quote0.js devices
node .\quote0.js status

#### Windows CMD

set DOT_API_KEY=你的_key
set DOT_DEVICE_ID=你的_id
node .\quote0.js devices
node .\quote0.js status

方式 C：持久环境变量（需用户同意）

仅在用户明确授权后再执行。

---

3) 首次配置（避免 404/403）

1. 在 Dot App 完成设备配对、联网、在线确认 2. 创建 API Key：More → API Key → Create API Key 3. 获取 Device Serial Number（作为 DOT_DEVICE_ID） 4. 在 Content Studio 至少添加： - 一个 Text API 内容项 - 一个 Image API 内容项 5. 运行： - devices 确认设备可见 - status 确认设备在线

---

4) 命令总览

node quote0.js --help

devices：获取设备列表

status：获取设备状态

next：切换下一条内容

list：列出设备内容项

text：推送文本内容

image：推送图像内容

---

5) 命令与 API 对应

devices

API: GET /api/authV2/open/devices

node quote0.js devices

status

API: GET /api/authV2/open/device/:id/status

node quote0.js status
node quote0.js status --deviceId "ABCD1234ABCD"

next

API: POST /api/authV2/open/device/:id/next

node quote0.js next

list

API: GET /api/authV2/open/device/:deviceId/:taskType/list

node quote0.js list --taskType loop

text

API: POST /api/authV2/open/device/:deviceId/text

node quote0.js text --message "你好，Quote/0"
node quote0.js text --title "验证码助手" --message "你的验证码：205112" --signature "2026-02-25 00:40" --refresh true

关键参数：

--message 必填

--title / --signature / --icon / --link / --taskKey 可选

--refresh 默认 true

image

API: POST /api/authV2/open/device/:deviceId/image

node quote0.js image --imageFile ./card.png
node quote0.js image --imageFile ./text-card.png --border 0 --ditherType NONE --refresh true

关键参数：

--image 或 --imageFile 二选一

--imageFile 必须是 .png 普通文件，且大小不超过 5MB

脚本会校验 PNG 文件头（不可绕过）

--border：0 白边 / 1 黑边

--ditherType：DIFFUSION | ORDERED | NONE

--ditherKernel：THRESHOLD | ATKINSON | BURKES | FLOYD_STEINBERG | ...

---

6) 常见错误排查

401 Unauthorized：API Key 错误/过期

403 Forbidden：Key 无此设备权限

404 Not Found：设备 ID 不存在，或未添加 Text/Image API 内容项

400 Invalid Params：参数非法（如 border、image、dither）

500 Device response failure：设备离线/网络异常

限流：10 requests/second

---

7) 官方文档

总览：https://dot.mindreset.tech/docs/service/open

API Key：https://dot.mindreset.tech/docs/service/open/get_api

Device ID：https://dot.mindreset.tech/docs/service/open/get_device_id

Device List：https://dot.mindreset.tech/docs/service/open/list_devices_api

Device Status：https://dot.mindreset.tech/docs/service/open/device_status_api

Device Next：https://dot.mindreset.tech/docs/service/open/device_next_api

List Device Content：https://dot.mindreset.tech/docs/service/open/list_device_tasks_api

Text API：https://dot.mindreset.tech/docs/service/open/text_api

Image API：https://dot.mindreset.tech/docs/service/open/image_api