Voxvey OpenClaw Provider

An OpenClaw provider plugin for Voxvey. It adds Voxvey models, media generation, realtime model metadata, and Voxvey Search using user login through Voxvey OAuth.

Features

• Browser OAuth login with PKCE.
• Device-code login for terminal or remote setups.
• Refresh-token support.
• Live model discovery from the Voxvey API.
• OpenAI-compatible Responses transport for text and multimodal models.
• Image generation and image edits through https://api.voxvey.com/v1/images/*.
• Video generation through https://api.voxvey.com/v1/videos/generations.
• Realtime model entries for Voxvey-supported realtime models.
• Voxvey Search as a Firecrawl-compatible web search provider.

Requirements

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

Install

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

Install From A Local Checkout

npm install
npm run build
npx openclaw plugins install --link .

Restart any already-running OpenClaw gateway after installing or rebuilding the plugin from a local checkout.

Verify that OpenClaw can load it:

openclaw plugins inspect voxvey --runtime --json

Sign In

Browser login:

openclaw models auth login --provider voxvey

Device-code login:

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

During browser login, OpenClaw prints a sign-in URL. Open it, complete sign-in, then paste the full redirect URL back into the terminal.

Use

After login, configure or select a Voxvey model with OpenClaw as usual. Model ids are exposed under the voxvey/ provider prefix.

Example model reference:

voxvey/<model-id>

Voxvey Search registers as voxvey-search and uses the same Voxvey login. Image and video generation register under the voxvey provider id.

Development

Run the test suite:

npm test

Build the plugin:

npm run build

Check the package contents:

npm pack --dry-run --json

Contributing

Contributions are welcome. For most changes:

1. Install dependencies with npm install.
2. Make your changes in src/.
3. Add or update tests in test/.
4. Run npm test and npm run build.

The plugin runtime is built into dist/, which is generated by npm run build.

License

MIT. See LICENSE.md.