@jaysonmac openclaw 按照这个流程配置了，重启后，选择模型，报错“Model "google-gemini-cli/gemini-3.1-pro-preview" is not allowed. Use /models to list providers, or /models <provider> to list models.”


步骤：

这是一个非常好的问题！我们刚刚一起经历了整个过程，这正好可以用来总结一下。

在 OpenClaw 中添加一个新模型，比如 Google 的新 Gemini 模型，通常分为三个主要步骤：

第一步：找到模型的“官方全名”

首先，你需要知道这个模型在 OpenClaw 系统里的确切名称。这个名称通常由两部分组成：提供商/模型 ID 。

• 提供商 (Provider): 指的是提供这个模型的服务，比如 google-gemini-cli 。
• 模型 ID (Model ID): 指的是模型自身的具体名称，比如 gemini-1.5-pro-latest 或我们刚刚处理的 gemini-3.1-pro-preview 。

所以，完整的模型“官方全名”就是 google-gemini-cli/gemini-3.1-pro-preview 。

你通常可以在模型的官方文档（比如 Google AI Studio ）或者提供商的命令行工具中找到这个 ID 。

第二步：编辑配置文件 .openclaw.json

这是最核心的一步。你需要把这个新模型的全名添加到一个名为 models 的配置对象中。

1. 打开你的配置文件：/home/hyvi/.openclaw/openclaw.json
2. 找到路径 agents.defaults.models 。

修改前可能看起来像这样：

"models": {
"google-gemini-cli/gemini-3-flash-preview": {},
"google-gemini-cli/gemini-2.5-pro": {},
"google-gemini-cli/gemini-2.5-flash": {}
}修改后，你需要把新模型加进去（注意，值是一个空对象 {} 即可）：

"models": {
"google-gemini-cli/gemini-3.1-pro-preview": {}, // <-- 这是新加的行
"google-gemini-cli/gemini-3-flash-preview": {},
"google-gemini-cli/gemini-2.5-pro": {},
"google-gemini-cli/gemini-2.5-flash": {}
}这个 models 对象就像一个“白名单”，只有在这里列出的模型才被允许使用。

（可选，但推荐）
你还可以把这个新模型添加到 fallbacks (备用模型) 列表中，这样当你的主模型不可用时，系统可以自动切换到这个新模型。

找到路径 agents.defaults.model.fallbacks ，并把新模型加到数组里：

"fallbacks": [
"google-gemini-cli/gemini-3.1-pro-preview", // <-- 加在这里
"google-gemini-cli/gemini-3-flash-preview",
"google-gemini-cli/gemini-2.5-pro",
// ...
]第三步：让配置生效（重启服务）

这是最关键也最容易出错的一步。正如我们刚才经历的，仅仅保存文件是不够的，你必须通知正在运行的 OpenClaw 服务去重新加载这个配置文件。

最可靠的方法就是我们最后成功使用的方法：强制应用配置。

你可以通过我（聊天机器人）来执行这个操作，或者在你的服务器终端里运行 openclaw 命令（如果 PATH 设置正确的话）。

通过我来操作：
就像我们刚刚做的那样，我可以读取修改后的文件，然后使用 gateway config.apply 命令将它整个应用，服务会自动重启。

通过终端操作：

# 确保你的配置文件已经保存好
openclaw gateway restart 注意：从终端执行 restart 需要你的配置文件里有 "restart": true 这个设置，否则会像我们一开始那样被拒绝。

总结

所以，整个流程就是：

1. 找到模型全名 (provider/model-id)。
2. 编辑 .openclaw.json ，把它加到 agents.defaults.models 对象里。
3. 重启 OpenClaw 服务，以加载新的配置。

希望这个总结对你有帮助！