Voxvey provider plugin for OpenClaw with models, media generation, and search
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:
- Install dependencies with
npm install. - Make your changes in
src/. - Add or update tests in
test/. - Run
npm testandnpm run build.
The plugin runtime is built into dist/, which is generated by npm run build.
License
MIT. See LICENSE.md.
