Skip to main content

Voxvey OpenClaw Plugin

The Voxvey OpenClaw plugin adds voxvey as an OpenAI-compatible model provider with Voxvey account sign-in, live model discovery, and chat-completions transport through https://api.voxvey.com/v1.

Requirements​

  • Node.js 22 or newer.
  • OpenClaw 2026.6.1 or newer.
  • A Voxvey account with API access.

Install​

Install the plugin from ClawHub:

openclaw plugins install clawhub:voxvey

Restart any already-running OpenClaw gateway after installing the plugin.

Verify that OpenClaw can load it:

openclaw plugins inspect voxvey --runtime --json

The inspect output should include the voxvey plugin id and a voxvey provider.

Sign in​

Use browser OAuth for a local desktop setup:

openclaw models auth login --provider voxvey

OpenClaw prints a sign-in URL. Open it, complete Voxvey sign-in, then paste the full redirect URL back into the terminal when prompted.

For terminal-only or remote environments, use device-code login:

openclaw models auth login --provider voxvey --device-code

Select a model​

List the models exposed by Voxvey:

openclaw models list --provider voxvey

Model ids are exposed under the voxvey/ provider prefix:

voxvey/<model-id>

Set one as your active OpenClaw model:

openclaw models set voxvey/<model-id>

For chat-completions workloads, a common model selection is:

openclaw models set voxvey/deepseek/deepseek-v4-flash

Start a new OpenClaw session after changing the active model. If an existing session is pinned to another model, switch it in the session with:

/model voxvey/deepseek/deepseek-v4-flash

Verify a request​

After selecting the model, ask OpenClaw for a short response:

Reply with exactly: ready

Expected result:

ready

If model listing works but a request fails, confirm your Voxvey account has access to the selected model.

Install from a local checkout​

Use this path when testing changes to the plugin itself.

git clone https://github.com/VoxveyAI/openclaw-voxvey.git
cd openclaw-voxvey
npm install
npm run build
npx openclaw plugins install --link .

Restart any already-running OpenClaw gateway after installing or rebuilding the linked plugin.

Inspect the linked runtime:

npx openclaw plugins inspect voxvey --runtime --json

Before publishing plugin changes, run:

npm test
npm run build
npm pack --dry-run --json