Run OpenClaw on any model

Step 1

Install OpenClaw

• Install OpenClaw
  npm install -g openclawCopy

  Verify with openclaw --version. OpenClaw has a newer Node.js support policy than Antseed, so use a Node version accepted by the current OpenClaw release. The config file lives at ~/.openclaw/openclaw.json and is created on first launch.

• Optional: let the setup script do the rest
  skills/openclaw-antseed/scripts/setup.sh --service deepseek-v4-flashCopy

  From a checkout of the Antseed repo. With no gateway, it installs the Antseed CLI if needed, runs antseed gateway service install (a background service that starts at login and restarts if it stops, on macOS and Linux, no root), creates a key for OpenClaw and saves it in ~/.antseed/openclaw/api-key, then writes the antseed provider into openclaw.json with that one model as the default (antseed/deepseek-v4-flash). Both files are readable only by you, and running it again reuses the saved key. To use a gateway you already have, set ANTSEED_BASE_URL and ANTSEED_API_KEY first. Then run openclaw gateway restart and check it with openclaw models list and openclaw agent exec "Say hi" --model "antseed/deepseek-v4-flash". The Configure and Test steps below are the by-hand route: they read ANTSEED_BASE_URL and ANTSEED_API_KEY from your shell and use a gateway preset the script doesn't create. A new gateway's wallet is empty, so add funds (antseed gateway console-link, then Wallet & Funding), or create the free-sellers preset below and add it to openclaw.json as a model.

Step 2

Point OpenClaw at Antseed

Step 3

Pick a model

Every id under models[] must be a model id from GET /v1/models or a gateway preset (@preset/<slug>). kimi-k2.6 has no free seller, so it needs a funded gateway. Don't pin a seller with <peerId>@<service-id>: OpenClaw drops everything from the @, so the gateway gets a bare peer id and answers 502 model_not_found. Pin with a preset instead: antseed gateway preset create --slug openclaw-pinned --name "OpenClaw pinned" --model deepseek-v4-flash --allow-peer <peerId>, then use @preset/openclaw-pinned. With the local buyer proxy and the desktop app, the special id antseed follows the model picked in the app; it does not work through a gateway.

The full list is every model on the network. Run GET /v1/models on your endpoint, antseed network browse, or open the live network page to see what's available right now.

Verify

Test it

• Confirm the endpoint advertises the model ids you put in config
  curl -s "$ANTSEED_BASE_URL/models" -H "Authorization: Bearer $ANTSEED_API_KEY" | jq '.data[].id'Copy
  Example response

  "deepseek-v4-flash" "gpt-oss-120b" "kimi-k2.6" "minimax-m2.7"

  Presets are not listed here. If a model id you listed in openclaw.json doesn't appear here, no seller your routing policy allows serves it right now. Remove the entry or pick another model from the list.

• Check the configured model catalog
  openclaw models listCopy

  You should see the antseed provider and its configured models.

• Run an agent against Antseed
  openclaw agent exec "Summarize the README in this repo" --model "antseed/@preset/openclaw"Copy

  Through the local buyer proxy: openclaw agent exec "Summarize the README in this repo" --model "antseed/kimi-k2.6".

If it goes wrong

Troubleshooting

• provider "antseed" not found when launching an agentJSON parse error in openclaw.json, or you put the entry in the wrong nesting level. The provider must live under models.providers.antseed. Run openclaw config validate to surface parse errors.
• 401 from the gatewaySet authHeader: true on the provider and make sure ANTSEED_API_KEY holds a gateway key in the environment OpenClaw starts with.
• Connection refused at localhost:8379The gateway on this computer isn't running. antseed gateway service status shows whether the service is installed and answering; antseed gateway service install starts it again.
• OpenClaw lists antseed/<id> but every call returns 502 model_not_foundNo seller your routing policy allows currently advertises that model. Check GET $ANTSEED_BASE_URL/models with the bearer key and update models[], or pick another model. If the error names a 40-character peer id instead of a model, the id was <peerId>@<service-id>, which OpenClaw cuts at the @; pin with a preset instead (see **Pick a model**).
• returned a billing error, then Inline API key for provider "antseed" is temporarily disabled after a provider auth/billing failureThe gateway answered 402: the request was routed to a paid seller and the workspace wallet is empty. OpenClaw then disables the antseed key for about 10 minutes for every model, free ones included; openclaw models status lists it under **Unavailable auth profiles** with the time left. Wait it out, then use the @preset/openclaw preset above, or fund the workspace wallet (console → **Wallet & Funding**).
• Streaming errors on long-running agentsAntseed supports SSE streaming. If you see truncated responses, check that no proxy between OpenClaw and Antseed is buffering (Cloudflare, nginx). The gateway and the buyer proxy do not buffer.
• Agent stalls on first request after a deployAntseed opens a payment channel on the first request to a new peer (one on-chain transaction, ~5–15s on Base). Subsequent requests reuse the channel. Pre-warm by running a quick curl before launching the agent.
• OpenClaw runs remotely and cannot reach 127.0.0.1:8377The local buyer proxy only listens on localhost. Use a gateway: a server gateway, or a tunnel (antseed tunnel start). Put its /v1 URL in ANTSEED_BASE_URL, a gateway key in ANTSEED_API_KEY, and keep authHeader: true. Do not expose port 8377 directly.

Reference

Links

Same category

Related