voiceclaw

voiceclaw-jp 是 OpenClaw 的语音对话技能：浏览器端用 Web Speech API 做唤醒词检测与语音识别，Node 服务把识别文本发给本地 OpenClaw Gateway 并流式返回，再按句调用 VOICEVOX 合成语音播放。提供 /health、/api/config、/api/chat-stream、/api/chat、/api/tts 接口，唤醒词、识别语言、模…

kentoku24

热度 53.93

最近更新 2026-05-11 17:28:31

分类：自动化依赖：代码执行 / 联网浏览搜索 / 读写文件 / 第三方 API / 内部调用大模型应用场景：自动化脚本 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add voiceclaw-jp

Metadata

name: voiceclaw-jp
description: Voice conversation interface for OpenClaw using wake word detection, streaming LLM responses, and text-to-speech. Use when a user wants to talk to their OpenClaw agent by voice, set up a voice assistant, or add speech input/output to OpenClaw. Supports configurable wake words, VOICEVOX TTS, and sentence-level streaming for low-latency responses.

voiceclaw

Voice conversation skill for OpenClaw: wake word → STT → LLM (streaming) → TTS → playback.

Requirements

OpenClaw running locally (gateway with chatCompletions enabled)
Node.js 18+
VOICEVOX running on localhost:50021 (download)
Chrome/Edge (Web Speech API for STT)
HTTPS for remote mic access (localhost works without HTTPS)

Quick Start

# Install
git clone https://github.com/kentoku24/voiceclaw.git
cd voiceclaw
npm install

# Start (no .env needed if OpenClaw is running locally)
npm start
# → [voiceclaw] OpenClaw config loaded from ~/.openclaw/openclaw.json
# → [voiceclaw] listening on http://127.0.0.1:8788

# Open browser
open http://127.0.0.1:8788

Press 開始, say the wake word (default: アリス), then speak your command.

Configuration

All settings are optional. Set in .env or environment variables:

Variable	Default	Description
`WAKE_WORDS`	アリスちゃん,アリス,...	Comma-separated wake words
`STT_LANG`	ja-JP	Speech recognition language
`OPENCLAW_MODEL`	openclaw	LLM model name
`VOICEVOX_URL`	http://127.0.0.1:50021	VOICEVOX endpoint
`VOICEVOX_SPEAKER`	1	VOICEVOX speaker ID
`HOST`	127.0.0.1	Server bind address
`PORT`	8788	Server port

Gateway token is auto-detected from ~/.openclaw/openclaw.json. Override with OPENCLAW_GATEWAY_TOKEN if needed.

Architecture

Wake word (browser STT) → voiceclaw server → OpenClaw Gateway (streaming)
                                           → sentence-level TTS (VOICEVOX)
                                           → audio playback (Web Audio API)

See docs/architecture.md for the full sequence diagram.

API Endpoints

Method	Path	Description
GET	`/health`	Health check
GET	`/api/config`	Client-safe settings (wake words, STT lang)
POST	`/api/chat-stream`	Streaming LLM → sentence-level SSE
POST	`/api/chat`	Non-streaming LLM (fallback)
POST	`/api/tts`	Text → VOICEVOX → WAV audio