Docs

OpenClaw ClawHub plugin

Install @abliterationai/openclaw-abliteration-provider from ClawHub or npm to register abliteration.ai as an OpenClaw provider.

Updated 2026-04-25

The @abliterationai/openclaw-abliteration-provider package is the plugin-first way to use abliteration.ai from OpenClaw. Install it from ClawHub or npm, enable the abliteration plugin, and run OpenClaw onboarding with your abliteration.ai API key.

The plugin registers provider id abliteration, reads ABLITERATION_API_KEY, targets https://api.abliteration.ai/v1, and selects abliteration/abliterated-model as the default model. It is published as version 0.1.0 and declares OpenClaw compatibility with >=2026.4.24.

Use this guide for the packaged plugin. If you prefer to edit ~/.openclaw/openclaw.json directly, use the manual OpenClaw configuration guide.

openclaw plugins install clawhub:@abliterationai/openclaw-abliteration-provider
openclaw plugins enable abliteration
openclaw gateway restart

export ABLITERATION_API_KEY="ak_YOUR_API_KEY"
openclaw onboard --auth-choice abliteration-api-key

What the plugin registers

The package metadata and ClawHub listing identify this as a runtime provider plugin. The provider id is stable, so OpenClaw model references use the abliteration/<model-id> form.

FieldValueMeaning
Package@abliterationai/openclaw-abliteration-providerPublished npm package and ClawHub plugin name.
Latest version0.1.0Published release used for this guide.
Provider idabliterationThe OpenClaw provider namespace.
API key env varABLITERATION_API_KEYBearer token source for calls to abliteration.ai.
Default modelabliteration/abliterated-modelThe provider-qualified model id OpenClaw should run.
API surfaceOpenAI ResponsesThe plugin routes requests through the OpenAI Responses-compatible surface.
Base URLhttps://api.abliteration.ai/v1The public abliteration.ai API root.
OpenClaw compatibility>=2026.4.24Minimum plugin API declared by the package.

Prerequisites

Install OpenClaw first, then create an abliteration.ai API key before enabling the provider.

  • OpenClaw 2026.4.24 or newer with the openclaw CLI on your shell path.
  • An abliteration.ai account with credits. Purchase credits here.
  • An abliteration.ai API key that starts with ak_.
  • Network access from the OpenClaw gateway to https://api.abliteration.ai/v1.

Install from ClawHub

ClawHub is the preferred install path because it resolves the plugin by registry identity and shows compatibility metadata before install.

openclaw plugins install clawhub:@abliterationai/openclaw-abliteration-provider
openclaw plugins enable abliteration
openclaw gateway restart

Install from npm

Use npm package resolution if your OpenClaw environment installs plugins directly from npm packages.

openclaw plugins install @abliterationai/openclaw-abliteration-provider
openclaw plugins enable abliteration
openclaw gateway restart

Configure the API key

The plugin requires ABLITERATION_API_KEY. Export it in the shell that runs OpenClaw, or provide it directly to OpenClaw onboarding.

# Put this in ~/.bashrc, ~/.zshrc, or ~/.profile
export ABLITERATION_API_KEY="ak_YOUR_API_KEY"

# Reload your shell
source ~/.zshrc   # or source ~/.bashrc

# Run the plugin's guided auth flow
openclaw onboard --auth-choice abliteration-api-key

Non-interactive setup

For CI, dotfile bootstrap scripts, or remote machines, pass the API key to onboarding without prompts.

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice abliteration-api-key \
  --abliteration-api-key "$ABLITERATION_API_KEY" \
  --skip-health \
  --accept-risk

Verify the provider

After onboarding, restart the gateway and run a short agent prompt. The plugin should route the request to abliteration/abliterated-model using the API key you provided.

openclaw gateway restart
openclaw config show
openclaw agent --agent main --message "ping"

ClawHub verification notes

The ClawHub listing links the release to source metadata and shows the plugin as a code-executing provider plugin with runtime id abliteration. Because provider plugins execute code inside OpenClaw, review the package source and publisher before installing in a production workstation.

If ClawHub shows a warning about missing credential metadata, the important operational detail is that the plugin does require exactly one credential: ABLITERATION_API_KEY. Do not paste that key into public logs or shared terminal transcripts.

Troubleshooting

Most plugin setup issues are install source, OpenClaw version, or missing API key problems.

  • Plugin install fails — update OpenClaw to 2026.4.24 or newer, then retry the ClawHub command.
  • Provider does not appear — run openclaw plugins enable abliteration and restart the gateway.
  • 401 Unauthorized — confirm ABLITERATION_API_KEY is exported and starts with ak_.
  • Model not found — use the provider-qualified id abliteration/abliterated-model in OpenClaw config and agent defaults.
  • 402 Insufficient Credits — top up from the pricing page.
  • 429 Rate limited — wait for the retry window or reduce parallel agent activity.
  • You need Anthropic Messages instead of Responses — use the manual OpenClaw config guide, which points OpenClaw at /v1/messages.