← Back to Plugins
Tools

Voxvey

VoxveyAI By VoxveyAI 👁 58 views ▲ 0 votes

Official Openclaw plugin for Voxvey.

GitHub

Install

npm install
npm

README

# Voxvey OpenClaw Provider

An OpenClaw provider plugin for Voxvey. It adds `voxvey` as an OpenAI-compatible model provider and supports 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 chat-completions transport.

## Requirements

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

## Install

```bash
openclaw plugins install clawhub:voxvey
```

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

Verify that OpenClaw can load it:

```bash
openclaw plugins inspect voxvey --runtime --json
```

## Install From A Local Checkout

```bash
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:

```bash
openclaw plugins inspect voxvey --runtime --json
```

## Sign In

Browser login:

```bash
openclaw models auth login --provider voxvey
```

Device-code login:

```bash
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:

```text
voxvey/<model-id>
```

## Development

Run the test suite:

```bash
npm test
```

Build the plugin:

```bash
npm run build
```

Check the package contents:

```bash
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](./LICENSE.md).
tools

Comments

Sign in to leave a comment

Loading comments...