New Grok Modelsdefault agent | Friends of the Crustacean 🦞🤝 | Page 1

sterile patrolBOT Mar 3, 2026, 4:18 PM

#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> ✅ Mark Solution

vale jungleBOT Mar 3, 2026, 4:20 PM

#

Yes — if you can see it in your model catalog, you can run it on a per-agent basis.

OpenClaw has a built-in xAI provider (provider: xai, env var XAI_API_KEY) and you select models as provider/model refs. So the ref you’d want to try is:

xai/grok-4-1-fast-reasoning (model refs are normalized to lowercase)

How to verify it’s currently available in your install:

In chat: /model list and look under the xai provider
CLI: openclaw models list --provider xai --all

How to set it for one agent (default model for that agent):

{
  agents: {
    list: [
      { id: "my-agent", model: "xai/grok-4-1-fast-reasoning" }

#

    ]
  }
}

Two common gotchas:

If you have an allowlist (agents.defaults.models), you must add this model there or you’ll get “Model … is not allowed”.
Make sure the Gateway actually has XAI_API_KEY available (process env / .env / ~/.openclaw/.env / config env block).

Docs:

If openclaw models list --provider xai --all doesn’t show it, paste your openclaw --version + that command’s output and we can tell whether it’s a version/catalog gap vs just an allowlist/auth issue.

atomic prawn Mar 3, 2026, 4:25 PM

#

I ran openclaw models list --provider xai --all but I dont see that model in the list

vale jungleBOT Mar 3, 2026, 4:26 PM

#

If openclaw models list --provider xai --all doesn’t show it, that means it’s not in the xAI model catalog shipped with your current OpenClaw build (the --all list comes from the bundled catalog).

That doesn’t necessarily mean it’s impossible — it just means OpenClaw won’t offer it in the picker/list yet.

A few practical next steps:

Confirm version (catalog updates are release-bound):

openclaw --version

Try setting it explicitly anyway (works if the upstream xAI API accepts that model id):

In chat: /model xai/grok-4-1-fast-reasoning
Or per-agent in openclaw.json:

#

  agents: {
    list: [
      { id: "my-agent", model: "xai/grok-4-1-fast-reasoning" },
    ],
  },
}

If xAI doesn’t recognize it, you’ll get a provider error like “model not found”.

If you’re using a model allowlist (agents.defaults.models), you must add it there too, otherwise you’ll get “Model … is not allowed”.

If you paste:

your openclaw --version
and the exact error you get when you /model xai/grok-4-1-fast-reasoning

…I can tell you whether this is just a catalog lag (needs OpenClaw update / catalog update) vs xAI not actually serving that model id yet.

#New Grok Modelsdefault agent