@movecall/onepage-agent-channel

OnePage e-paper voice terminal agent channel & firmware suite for Hermes and OpenClaw runtimes.

🚀 One-Line Quick Install

Option A: npx (Recommended for AI Agents & Node Environments)

# Install for Hermes runtime (default)
npx @movecall/onepage-agent-channel

# Install for OpenClaw Gateway runtime
npx @movecall/onepage-agent-channel install --runtime openclaw --openclaw-url "ws://127.0.0.1:18789"

# Non-interactive with API keys
ONEPAGE_ASR_API_KEY="sk-xxx" MINIMAX_CN_API_KEY="sk-yyy" npx @movecall/onepage-agent-channel install --yes

Option B: Shell Script (Zero-Dependency)

curl -fsSL https://raw.githubusercontent.com/movecall/onepage-agent-channel/main/installer/install.sh | bash

📂 Repository Structure & Boundaries

onepage-agent-channel/
├── README.md                  <- Architecture & navigation portal
├── package.json               <- npm manifest (publishes channels & installer)
├── channels/                  <- Agent platform adapters
│   ├── hermes/                <- Hermes Python platform plugin (adapter.py, plugin.yaml)
│   └── openclaw/              <- OpenClaw platform adapter (adapter.js, openclaw.plugin.json)
├── firmware/                  <- ESP32-C61 ESP-IDF firmware (uses movecall/bsp_onepage_c61^0.1.2)
├── installer/                 <- Productized installer CLI & install.sh
└── docs/                      <- Message & QR code protocol specifications

🔄 End-to-End Architecture

OnePage ESP32-C61 Terminal
  -> POST audio to /api/onepage/voice (or /poll /hello)
  -> ASR (Aliyun DashScope FunASR)
  -> AI Agent Runtime (Hermes or OpenClaw Gateway)
  -> JSON reply payload (Text / Markdown / QR code / 1-bit EPD Bitmap)
  -> Moui E-Paper Display (424x700 resolution)

🛠️ CLI Verification & Commands

# End-to-end API probe & 424x700 image contract test
npx @movecall/onepage-agent-channel smoke

# Uninstall OnePage channel plugin
npx @movecall/onepage-agent-channel uninstall

📟 Firmware Compilation (firmware/)

For hardware developers building ESP32-C61 firmware:

cd firmware
idf.py set-target esp32c61
# Edit CHAT_SERVER_URL in main/main.c
idf.py build
idf.py -p /dev/tty.usbmodem* flash monitor

For detailed firmware documentation, see firmware/README.md.
For detailed Hermes plugin documentation, see channels/hermes/README.md.
For detailed OpenClaw plugin documentation, see channels/openclaw/README.md.

📋 Clean Machine Acceptance Checklist

1. Install AI Gateway runtime: Hermes (hermes gateway) or OpenClaw (openclaw gateway)
2. Run One-Liner Install: npx @movecall/onepage-agent-channel (or --runtime openclaw)
3. Configure API keys in ~/.hermes/.env or ~/.openclaw/.env
4. Confirm 100% Smoke Pass: npx @movecall/onepage-agent-channel smoke
5. Pair ESP32-C61 terminal: hermes pairing approve onepage <PAIRING_CODE> (or openclaw channels approve onepage <PAIRING_CODE>)
6. Perform voice conversation & QR code rendering verification!