Voice
Local Images
By OpenClaw plugin that generates images through a local image server on loopback, with several models the agent picks per call.
Install
openclaw plugins install git:file:///path/to/openclaw-local-images@<tagREADME
# openclaw-local-images
An OpenClaw plugin that generates and edits images through a local image server on loopback. You configure the models the server serves; the agent picks one per call.
## Install
```sh
openclaw plugins install git:file:///path/to/openclaw-local-images@<tag or commit> --force --accept-capabilities
openclaw plugins inspect local-images --runtime --json
```
OpenClaw loads the committed `dist/` through `openclaw.runtimeExtensions`, from a git install, a copy, a load path or `--link` alike (`docs/plugins/sdk-entrypoints/package-entries.md:36-38`, 2026.10.8), checked on 2026.10.8: an install runs npm without scripts, so nothing is built then, and a change to `src/` runs only after `npm run build`. `--force` confirms a source that isn't on ClawHub, and `--accept-capabilities` the image provider.
## Configure
```json5
{
plugins: {
entries: {
"local-images": {
config: {
baseUrl: "http://127.0.0.1:7860",
models: ["everyday", "realism"],
},
},
},
},
agents: {
defaults: {
mediaModels: { image: { primary: "local-images/everyday" } },
},
},
}
```
| Key | What |
|---|---|
| `baseUrl` | The image server. Loopback only (`127.0.0.1`, `[::1]`, `localhost`); anything else leaves the provider unconfigured |
| `models` | Model ids the server serves; the first is the default |
The agent can override the model per call: `image_generate model=local-images/realism`.
## The server
Any server that speaks [the image server API](docs/server-api.md). The plugin only sends a model, a prompt, a size and a count, and returns the PNGs with model, seed and timings.
## Limits
- Editing: one reference image per request (`image_generate image=<path>`); the server decides how each model uses it.
- Sizes: 1024×1024, 832×1216, 1216×832, 768×1344, 1344×768; an aspect ratio maps to the nearest of these.
See [verification](docs/verification.md) for what's been checked against a live gateway.
voice
Comments
Sign in to leave a comment