Model & Aliases | Friends of the Crustacean 🦞🤝 | Page 1

eternal bay May 17, 2026, 9:07 AM

#

I want to add aliases, to those models. Do it step by step one step at a time

tulip fableBOT May 17, 2026, 9:07 AM

#

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

lunar lakeBOT May 17, 2026, 9:07 AM

#

eternal bay I want to add aliases, to those models. Do it step by step one step at a time

Step 1: please run this on the machine where OpenClaw is installed:

openclaw --version

Send me the output, then I’ll give you the next step for adding the aliases. I’m asking version first because model/alias commands changed over time.

Docs I’m following: https://docs.openclaw.ai/concepts/models

eternal bay May 17, 2026, 9:10 AM

#

OpenClaw 2026.5.4 (325df3e)   ``` 

Running on WSL2

lunar lakeBOT May 17, 2026, 9:11 AM

#

eternal bay ``` OpenClaw 2026.5.4 (325df3e) ``` Running on WSL2

Step 2: list the model refs OpenClaw currently knows about:

openclaw models list --plain

Send me the output. After that I’ll tell you the exact openclaw models aliases add ... command for the first alias.

eternal bay May 17, 2026, 9:14 AM

#

openclaw models list --plain                                                                                                                                                                                                                    🦞 OpenClaw 2026.5.4 (325df3e) — If you can describe it, I can probably automate it—or at least make it funnier.                                                                                                                                                        openai/gpt-5.4-mini                                                                                                                 openai/gpt-4o-mini-transcribe

lunar lakeBOT May 17, 2026, 9:15 AM

#

eternal bay ``` openclaw models list --plain ...

Step 3: pick the first alias name.

Which alias do you want for this model?

openai/gpt-5.4-mini

Example alias: mini

Send just the alias word you want, then I’ll give you the exact add command.

eternal bay May 17, 2026, 9:15 AM

#

These names are perfect. Wait ill add codex models and then we set

lunar lakeBOT May 17, 2026, 9:16 AM

#

eternal bay These names are perfect. Wait ill add codex models and then we set

Sounds good. After you add the Codex models, run this again:

openclaw models list --plain

Paste the output here and we’ll set the aliases one at a time.

eternal bay May 17, 2026, 9:23 AM

#

openclaw models list --plain 🦞 OpenClaw 2026.5.4 (325df3e) — One CLI to rule them all, and one more restart because you changed the port. openai/gpt-5.4-mini openai/gpt-4o-mini-transcribe openai-codex/gpt-5.5 openai-codex/gpt-5.4 openai-codex/gpt-5.4-mini openai-codex/gpt-5.4-pro openai-codex/gpt-5.5-pro

lunar lakeBOT May 17, 2026, 9:23 AM

#

eternal bay ``` openclaw models list --plain ...

Step 4: add the first alias:

openclaw models aliases add mini openai/gpt-5.4-mini

Run that and paste the output. Then we’ll verify it before adding the Codex aliases.

eternal bay May 17, 2026, 9:24 AM

#

openclaw models aliases add mini openai/gpt-5.4-mini 🦞 OpenClaw 2026.5.4 (325df3e) — Give me a workspace and I'll give you fewer tabs, fewer toggles, and more oxygen. Config overwrite: /home/wrakeeb/.openclaw/openclaw.json (sha256 464f3fe2b0de3716790e4416192d0c98f1a43c93de413c8a20bdbc463258d24e -> 87e9a12847088cb4956489218bb35ff8fbc8b77cd126eb1f4248ece6e80a2bdf, backup=/home/wrakeeb/.openclaw/openclaw.json.bak) Updated ~/.openclaw/openclaw.json Alias mini -> openai/gpt-5.4-mini

lunar lakeBOT May 17, 2026, 9:25 AM

#

eternal bay ```openclaw models aliases add mini openai/gpt-5.4-mini ...

Good, first alias is written.

Step 5: verify aliases now:

openclaw models aliases list

Paste the output. If mini -> openai/gpt-5.4-mini shows up, next we’ll add the first Codex alias.

eternal bay May 17, 2026, 9:25 AM

#

openclaw models aliases list 🦞 OpenClaw 2026.5.4 (325df3e) — Alexa, but with taste. Aliases (1): - mini -> openai/gpt-5.4-mini

lunar lakeBOT May 17, 2026, 9:25 AM

#

eternal bay openclaw models aliases list ...

Verified: mini is good.

Step 6: add the main Codex alias:

openclaw models aliases add codex openai-codex/gpt-5.5

Run that and paste the output.

eternal bay May 17, 2026, 9:26 AM

#

UI don't want aliases with these names

lunar lakeBOT May 17, 2026, 9:26 AM

#

eternal bay UI don't want aliases with these names

Got it. Step 6 instead: choose your alias names first.

Current alias is:

mini -> openai/gpt-5.4-mini

If you don’t want mini, remove it with:

openclaw models aliases remove mini

Then send me the exact alias name you want for openai/gpt-5.4-mini, and we’ll add that one.

eternal bay May 17, 2026, 9:52 AM

#

I want this exact same names as aliases

openclaw models list --plain 🦞 OpenClaw 2026.5.4 (325df3e) — I'm not AI-powered, I'm AI-possessed. Big difference. openai/gpt-5.4-mini openai/gpt-4o-mini-transcribe openai-codex/gpt-5.5 openai-codex/gpt-5.4 openai-codex/gpt-5.4-mini openai-codex/gpt-5.4-pro openai-codex/gpt-5.5-pro

lunar lakeBOT May 17, 2026, 9:52 AM

#

eternal bay I want this exact same names as aliases ```openclaw models list --plain ...

Small correction: an alias can’t be the exact full provider/model string because / is not allowed in alias names. The full names already work directly, so aliases are only for shortcuts.

Closest valid option is to replace / with -, like:

openai-gpt-5.4-mini
openai-codex-gpt-5.5

Also, gpt-5.4-mini alone would collide because you have both OpenAI and Codex variants.

Step 7: do you want to use the provider-model style above? If yes, first remove the old alias:

openclaw models aliases remove mini

lunar lakeBOT May 17, 2026, 9:52 AM

#

eternal bay I want this exact same names as aliases ```openclaw models list --plain ...

Paste the output and we’ll add the first new alias. Docs: https://docs.openclaw.ai/concepts/models

eternal bay May 17, 2026, 9:53 AM

#

done next

lunar lakeBOT May 17, 2026, 9:53 AM

#

eternal bay done next

Step 8: add the first replacement alias:

openclaw models aliases add openai-gpt-5.4-mini openai/gpt-5.4-mini

Run it and paste the output.

eternal bay May 17, 2026, 9:53 AM

#

openclaw models aliases add openai-gpt-5.4-mini openai/gpt-5.4-mini 🦞 OpenClaw 2026.5.4 (325df3e) — Deployed locally, trusted globally, debugged eternally. Config overwrite: /home/wrakeeb/.openclaw/openclaw.json (sha256 13209f1a961c863f3bf1cf65176e73f2e752a55f099cc0d59d77f60396dc79c5 -> 84aab5a849deb0a61efbdf3c5ee1ab6250a16b3a2f8c4933766f9e1cce1bd3e7, backup=/home/wrakeeb/.openclaw/openclaw.json.bak) Updated ~/.openclaw/openclaw.json Alias openai-gpt-5.4-mini -> openai/gpt-5.4-mini

lunar lakeBOT May 17, 2026, 9:54 AM

#

eternal bay ``` openclaw models aliases add openai-gpt-5.4-mini openai/gpt-5.4-mini ...

Good.

Step 9: add the transcribe alias:

openclaw models aliases add openai-gpt-4o-mini-transcribe openai/gpt-4o-mini-transcribe

Run it and paste the output.

eternal bay May 17, 2026, 9:56 AM

#

openclaw models aliases add openai-gpt-4o-mini-transcribe openai/gpt-4o-mini-transcribe 🦞 OpenClaw 2026.5.4 (325df3e) — Somewhere between 'hello world' and 'oh god what have I built.' Config overwrite: /home/wrakeeb/.openclaw/openclaw.json (sha256 84aab5a849deb0a61efbdf3c5ee1ab6250a16b3a2f8c4933766f9e1cce1bd3e7 -> f7fc761e83ccf4f44232b57c472df614865f895e8f21309e57d900cee385e2e3, backup=/home/wrakeeb/.openclaw/openclaw.json.bak) Updated ~/.openclaw/openclaw.json Alias openai-gpt-4o-mini-transcribe -> openai/gpt-4o-mini-transcribe

lunar lakeBOT May 17, 2026, 9:56 AM

#

eternal bay ```openclaw models aliases add openai-gpt-4o-mini-transcribe openai/gpt-4o-mini-...

Good.

Step 10: add the first Codex alias:

openclaw models aliases add openai-codex-gpt-5.5 openai-codex/gpt-5.5

Run it and paste the output.

eternal bay May 17, 2026, 9:56 AM

#

let's do all codex at once

lunar lakeBOT May 17, 2026, 9:56 AM

#

eternal bay let's do all codex at once

Yep. Run these five lines as one paste:

openclaw models aliases add openai-codex-gpt-5.5 openai-codex/gpt-5.5
openclaw models aliases add openai-codex-gpt-5.4 openai-codex/gpt-5.4
openclaw models aliases add openai-codex-gpt-5.4-mini openai-codex/gpt-5.4-mini
openclaw models aliases add openai-codex-gpt-5.4-pro openai-codex/gpt-5.4-pro
openclaw models aliases add openai-codex-gpt-5.5-pro openai-codex/gpt-5.5-pro

Paste the output. If the first one already ran, it may just update the same alias again, which is fine.

eternal bay May 17, 2026, 9:59 AM

#

📎 message.txt

lunar lakeBOT May 17, 2026, 10:00 AM

#

eternal bay

Looks good: all five Codex aliases were added.

Final check:

openclaw models aliases list

You should see 7 aliases total:

openai-gpt-5.4-mini -> openai/gpt-5.4-mini
openai-gpt-4o-mini-transcribe -> openai/gpt-4o-mini-transcribe
openai-codex-gpt-5.5 -> openai-codex/gpt-5.5
openai-codex-gpt-5.4 -> openai-codex/gpt-5.4
openai-codex-gpt-5.4-mini -> openai-codex/gpt-5.4-mini

lunar lakeBOT May 17, 2026, 10:00 AM

#

eternal bay

openai-codex-gpt-5.4-pro -> openai-codex/gpt-5.4-pro
openai-codex-gpt-5.5-pro -> openai-codex/gpt-5.5-pro

After that, you can select one with e.g.:

openclaw models set openai-codex-gpt-5.5

eternal bay May 17, 2026, 10:00 AM

#

 openclaw models aliases list                                                                                                                                                                                                                    🦞 OpenClaw 2026.5.4 (325df3e) — If it works, it's automation; if it breaks, it's a "learning opportunity."                                                                                                                                                             Aliases (7):                                                                                                                        - openai-gpt-4o-mini-transcribe -> openai/gpt-4o-mini-transcribe                                                                    - openai-codex-gpt-5.5 -> openai-codex/gpt-5.5                                                                                      - openai-codex-gpt-5.4 -> openai-codex/gpt-5.4                                                                                      - openai-codex-gpt-5.4-mini -> openai-codex/gpt-5.4-mini                                                                            - openai-codex-gpt-5.4-pro -> openai-codex/gpt-5.4-pro                                                                              - openai-codex-gpt-5.5-pro -> openai-codex/gpt-5.5-pro                                                                              - openai-gpt-5.4-mini -> openai/gpt-5.4-mini

lunar lakeBOT May 17, 2026, 10:00 AM

#

eternal bay ``` openclaw models aliases list ...

Perfect, that’s set correctly.

To use one now:

openclaw models set openai-codex-gpt-5.5

Or in chat/session model switching, use the alias wherever you’d normally use the model ref, for example:

/model openai-codex-gpt-5.5

Glad that’s sorted. If this fixed it, please right-click the solution message → Apps → ✅ Mark Solution so Answer Overflow indexes it for future users.

eternal bay May 17, 2026, 10:02 AM

#

Thank you Krill

lunar lakeBOT May 17, 2026, 10:02 AM

#

eternal bay Thank you Krill

Happy to help! 🦞

eternal bay May 17, 2026, 10:03 AM

#

Share a summury of whole conversation with the actual commands to set and things we did

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

Summary of what we did:

Checked your OpenClaw version:

openclaw --version

You were on:

OpenClaw 2026.5.4 (325df3e)

Listed the configured models:

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

openclaw models list --plain

Models found:

openai/gpt-5.4-mini
openai/gpt-4o-mini-transcribe
openai-codex/gpt-5.5
openai-codex/gpt-5.4
openai-codex/gpt-5.4-mini
openai-codex/gpt-5.4-pro
openai-codex/gpt-5.5-pro

We learned aliases cannot contain /, so exact full names like openai/gpt-5.4-mini cannot be aliases. We used the closest valid style by replacing / with -.

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

Removed the first test alias:

openclaw models aliases remove mini

Added the OpenAI aliases:

openclaw models aliases add openai-gpt-5.4-mini openai/gpt-5.4-mini
openclaw models aliases add openai-gpt-4o-mini-transcribe openai/gpt-4o-mini-transcribe

Added all Codex aliases:

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

openclaw models aliases add openai-codex-gpt-5.5 openai-codex/gpt-5.5
openclaw models aliases add openai-codex-gpt-5.4 openai-codex/gpt-5.4
openclaw models aliases add openai-codex-gpt-5.4-mini openai-codex/gpt-5.4-mini
openclaw models aliases add openai-codex-gpt-5.4-pro openai-codex/gpt-5.4-pro
openclaw models aliases add openai-codex-gpt-5.5-pro openai-codex/gpt-5.5-pro

Verified the aliases:

openclaw models aliases list

Final aliases:

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

openai-gpt-4o-mini-transcribe -> openai/gpt-4o-mini-transcribe
openai-codex-gpt-5.5 -> openai-codex/gpt-5.5
openai-codex-gpt-5.4 -> openai-codex/gpt-5.4
openai-codex-gpt-5.4-mini -> openai-codex/gpt-5.4-mini
openai-codex-gpt-5.4-pro -> openai-codex/gpt-5.4-pro
openai-codex-gpt-5.5-pro -> openai-codex/gpt-5.5-pro
openai-gpt-5.4-mini -> openai/gpt-5.4-mini

To set a model using an alias:

openclaw models set openai-codex-gpt-5.5

Or inside a chat/session:

lunar lakeBOT May 17, 2026, 10:03 AM

#

eternal bay Share a summury of whole conversation with the actual commands to set and things...

/model openai-codex-gpt-5.5

Docs reference: https://docs.openclaw.ai/concepts/models

eternal bay May 17, 2026, 10:04 AM

#

Ty

lunar lakeBOT May 17, 2026, 10:04 AM

#

eternal bay Ty

Anytime 🦞

#Model & Aliases