Models CLI

OpenClaw 在回答你的问题时，会按照一个顺序来挑选它使用的“大脑”（模型）。

1. 首先，用主要的“大脑”。这个“大脑”是你在一个叫 agents.defaults.model.primary 的地方设置好的，它是 OpenClaw 最想用的那个。
2. 如果主要的“大脑”不工作，就用备用的“大脑”。这些备用的“大脑”放在一个叫 agents.defaults.model.fallbacks 的列表里，OpenClaw 会按顺序一个一个试。
3. 在一个“大脑”供应商内部，它自己也会先试试换账号。你可以把供应商想成是卖“大脑”的商店。如果商店里一个账号不行，它会先试试用同一个商店的另一个账号，实在不行了，才会去换下一个商店（也就是下一个模型）。

一些重要的提醒：

• 有一个名单叫 agents.defaults.models，它就像一个“允许使用的小机器人名单”。OpenClaw 只能使用名单上的机器人。
• 如果你发的消息里有图片，但主要的“大脑”看不懂图片，OpenClaw 就会用一个专门看图片的“大脑”，它的名字写在 agents.defaults.imageModel 里。

怎么选“大脑”比较好呢？

• 把最主要的“大脑”设置成你能用的、最新最厉害的那个。
• 可以用一些便宜或回答快的“大脑”做备用，用来处理不太重要的事情。
• 如果让“大脑”去使用工具（比如上网查资料），或者你给它的信息不太放心，就不要用那些太老或太弱的“大脑”。

最简单的设置方法（推荐！） 如果你不想自己写那些复杂的设置，可以打开电脑上的“终端”或“命令提示符”，输入下面这个魔法咒语，然后按回车键： openclaw onboard 它会像一位向导一样，带你一步一步设置好“大脑”和登录信息，非常简单！

如果 OpenClaw 突然不说话了 有时候，你可能会看到一条消息说“Model is not allowed”（这个“大脑”不允许使用）。这是因为你想用的“大脑”不在前面说的“允许使用名单”里。这时候，OpenClaw 在开始思考前就会停下来，所以看起来就像它没回答你。要解决这个问题，你可以：

• 把这个“大脑”的名字加到 agents.defaults.models 名单里。
• 或者，干脆把整个名单清空（删掉 agents.defaults.models 这一行）。
• 或者，用 /model list 命令看看现在允许用哪些“大脑”，从里面选一个。

在聊天时换“大脑” 你可以在聊天中途换“大脑”，不用重启 OpenClaw！只要输入这些命令：

• /model 或 /model list：会显示一个带编号的列表，让你选。
• /model 3：选列表中编号是 3 的那个“大脑”。
• /model openai/gpt-5.2：直接指定要用哪个“大脑”。注意，名字要写成 供应商/大脑名字 的样子。
• /model status：看看现在用的是哪个“大脑”，以及登录信息怎么样。

用电脑命令管理“大脑” 你还可以在电脑的“终端”里，用更厉害的命令来管理“大脑”。下面是一些常用的命令，你只需要在 openclaw 后面加上它们：

• models list：列出所有“大脑”。
• models status：查看当前“大脑”的详细情况。
• models set <供应商/大脑名字>：换一个新的主要“大脑”。
• models set-image <供应商/大脑名字>：换一个专门看图片的“大脑”。
• 还有 models aliases（给“大脑”起外号）、models fallbacks（管理备用“大脑”）等很多命令。

找一个免费的“大脑”来用 有一个叫 OpenRouter 的地方有很多免费的“大脑”。你可以用这个命令让 OpenClaw 去那里找找看： openclaw models scan 这个命令会去查看哪些免费“大脑”最好用，比如哪个能看懂图片，哪个回答问题快。它需要一个 OpenRouter 的钥匙（API Key）才能仔细检查。如果没有钥匙，你可以加上 --no-probe 这个选项，它就只看看名单，不深入检查了。

“大脑”的登记本 你给 OpenClaw 添加的自己定制的“大脑供应商”，会被写进一个叫 models.json 的文件里。这个文件就像是一个“大脑登记本”。通常，新加的信息会和旧的信息合并在一起，除非你特别说明要全部替换掉。