Plugin Qtum

Name: Plugin Qtum
Rating: 3.5 (1 reviews)
Author: Dannnymack

By Dannnymack 👁 18 views ▲ 0 votes

OpenClaw provider plugin for router.qtum.ai (OpenAI-compatible router, credits billed in QTUM)

GitHub

Install

openclaw plugins install https://github.com/Dannnymack/openclaw-plugin-qtum

README

# openclaw-plugin-qtum

An [OpenClaw](https://openclaw.ai) provider plugin for [`router.qtum.ai`](https://router.qtum.ai) — the Qtum AI Gateway, an OpenAI-compatible router with credits billed in QTUM.

One install, one API key, and OpenClaw can use any model in the Qtum catalog (currently includes gpt-5.5, gpt-5.4, deepseek-v4-pro/flash, kimi-k2.6, glm-5.1, qwen3.6/3.7 series, MiniMax-M2.5, etc.) for both text and vision.

## Install

```bash
openclaw plugins install https://github.com/Dannnymack/openclaw-plugin-qtum
```

For local development, clone this repo and link instead:

```bash
git clone https://github.com/Dannnymack/openclaw-plugin-qtum
openclaw plugins install ./openclaw-plugin-qtum --link
```

Then restart the gateway:

```bash
XDG_RUNTIME_DIR=/run/user/$(id -u) \
DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus \
  systemctl --user restart openclaw-gateway
```

## Authenticate

```bash
openclaw models auth login --provider qtum --method api-key
```

You'll be prompted for your Qtum API key (get one from [console.qtum.ai](https://console.qtum.ai/keys)). The key is stored in your per-agent `auth-profiles.json` using OpenClaw's standard credential store — it's never written to `openclaw.json`, environment variables, or anywhere else.

For non-interactive setups you can also pass `--qtum-api-key sk-...` or set `QTUM_API_KEY` in the environment.

## Pick a model

```bash
openclaw models set qtum/gpt-5.5
```

Or any model from the qtum catalog (`gpt-5.4`, `deepseek-v4-pro`, `kimi-k2.6`, `qwen3.7-max`, etc.). The plugin fetches qtum's `/v1/models` at startup so newly-released qtum models become available without a plugin update.

You can verify with:

```bash
openclaw agent --agent main -m "Say only the single word: pong"
```

## Vision

Vision works out of the box for models that support it (gpt-5.x, kimi, glm, qwen, MiniMax). OpenClaw's `image` tool will route image-bearing requests through `qtum/gpt-5.5` automatically. If you want a different vision model:

```bash
openclaw config set agents.defaults.imageModel.primary qtum/kimi-k2.6
```

DeepSeek models are text-only and won't be picked for vision queries.

## What this plugin does

- Registers a `qtum` provider with OpenClaw's plugin system.
- Uses qtum's OpenAI Chat Completions endpoint (`/v1/chat/completions`) — the cleanest wire-format match for OpenClaw's `openai-completions` API type. Auth is `Authorization: Bearer <key>`.
- Dynamically fetches `/v1/models` from qtum at startup; falls back to a small built-in static list if the fetch fails.
- Filters out non-chat catalog entries (video generators like `happyhorse-1.0-t2v` and `doubao-seedance-*`).
- Maintains a curated capability map (which models support vision, per-model context windows) since qtum's model API doesn't expose this metadata. Unknown model ids fall through to safe text-only defaults.
- Registers a media-understanding provider so OpenClaw's image tool can call qtum for vision.

## Status, scope, caveats

- **Pricing**: qtum's API doesn't currently expose per-model pricing, so OpenClaw's cost tracking shows zero for qtum routes. If qtum adds a pricing endpoint, this plugin should consume it.
- **Capabilities**: vision-capability and context-window data is curated by hand in this plugin (`MODEL_OVERRIDES`). If qtum adds a richer `/v1/models` response or a separate metadata endpoint, switch to that.
- **Egress**: qtum's gateway has its own outbound restrictions on image URL fetches — some hosts (e.g., `github.githubassets.com`) are blocked. OpenClaw's image tool downloads images locally first and sends bytes, so this isn't normally an issue, but be aware if you're passing image URLs directly to qtum.
- **No image generation, audio, or speech yet** — text + vision only.

## Uninstall

```bash
openclaw plugins uninstall qtum
```

Then restart the gateway. Remove `qtum:default` profiles from your per-agent `auth-profiles.json` files if you want to drop the stored keys.

## License

MIT.

tools