OpenClaw如何切換不同AI模型?2026年OpenClaw模型配置與切換指南
支持的模型列表
OpenClaw 目前支持以下國產(chǎn)大模型:
通義千問系列(阿里云百煉)
| 模型別名 | 完整模型 ID | 輸入類型 | 上下文長度 | 特點 |
|---|---|---|---|---|
qwen | bailian/qwen3.5-plus | 文本+圖像 | 977k tokens | 通用型,支持圖像理解 |
qwen-max | bailian/qwen3-max-2026-01-23 | 文本 | 256k tokens | 高性能旗艦版 |
qwen-coder | bailian/qwen3-coder-next | 文本 | 256k tokens | 編程專用 Next 版 |
qwen-coder-plus | bailian/qwen3-coder-plus | 文本 | 977k tokens | 編程專用 Plus 版 |
智譜 GLM 系列
| 模型別名 | 完整模型 ID | 輸入類型 | 上下文長度 | 特點 |
|---|---|---|---|---|
glm | bailian/glm-5 | 文本 | 198k tokens | 最新 GLM-5 模型 |
glm-4 | bailian/glm-4.7 | 文本 | 198k tokens | GLM-4.7 版本 |
Kimi 系列(月之暗面)
| 模型別名 | 完整模型 ID | 輸入類型 | 上下文長度 | 特點 |
|---|---|---|---|---|
kimi | moonshot/kimi-k2.5 | 文本+圖像 | 250k tokens | Kimi K2.5 官方版 |
kimi | bailian/kimi-k2.5 | 文本+圖像 | 256k tokens | Kimi K2.5 百煉版 |
kimi-coding | kimi-coding/k2p5 | 文本 | - | Kimi 編程專用版 |
MiniMax 系列
| 模型別名 | 完整模型 ID | 輸入類型 | 上下文長度 | 特點 |
|---|---|---|---|---|
minimax | bailian/MiniMax-M2.5 | 文本 | 977k tokens | MiniMax M2.5 |
模型選擇建議
| 使用場景 | 推薦模型 | 原因 |
|---|---|---|
| 日常對話 | glm 或 qwen | 平衡性能與成本 |
| 編程開發(fā) | qwen-coder-plus 或 kimi-coding | 專業(yè)編程能力 |
| 長文檔處理 | qwen 或 minimax | 超大上下文窗口 |
| 圖像理解 | qwen 或 kimi | 支持圖像輸入 |
| 復(fù)雜推理 | qwen-max | 最強推理能力 |
API Key 配置
方法一:通過 OpenClaw 配置向?qū)Вㄍ扑]新手)
運行交互式配置向?qū)В?/p>
openclaw configure
按照提示選擇模型提供商并輸入 API Key。
方法二:通過命令行配置
1. 添加 API Key 認(rèn)證
# 進入交互式配置 openclaw models auth add # 或者直接粘貼 Token openclaw models auth paste-token
2. OAuth 認(rèn)證(部分提供商支持)
# 阿里云百煉 OAuth 登錄 openclaw models auth login qwen-portal # GitHub Copilot 認(rèn)證 openclaw models auth login-github-copilot
方法三:手動編輯配置文件
配置文件位置:~/.openclaw/openclaw.json
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "your-api-key-here",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
}
}配置參數(shù)說明
| 參數(shù) | 說明 | 示例 |
|---|---|---|
baseUrl | API 服務(wù)地址 | https://coding.dashscope.aliyuncs.com/v1 |
apiKey | API 密鑰 | sk-xxxxxxxxxxxxx |
api | API 協(xié)議類型 | openai-completions |
models | 模型列表配置 | 見下方說明 |
input | 支持的輸入類型 | ["text"] 或 ["text", "image"] |
contextWindow | 上下文窗口大小 | 1000000 (1M tokens) |
maxTokens | 最大輸出 Token 數(shù) | 65536 |
獲取 API Key
| 模型提供商 | 獲取方式 |
|---|---|
| 阿里云百煉 | https://bailian.console.aliyun.com/ |
| 月之暗面 Kimi | https://platform.moonshot.cn/ |
| 智譜 GLM | https://open.bigmodel.cn/ |
| MiniMax | https://www.minimaxi.com/ |
模型切換方法
OpenClaw 提供多種模型切換方式,選擇最適合你的方式即可。
方法一:自然語言切換(最簡單)
直接告訴 OpenClaw 你想用什么模型:
切換到 Kimi 使用通義千問 換成 GLM 模型 我想用 kimi-coding 切換模型到 qwen
OpenClaw 會自動識別并執(zhí)行切換。
方法二:命令行切換
查看當(dāng)前模型狀態(tài)
openclaw session_status
輸出示例:
Runtime: agent=main | model=bailian/glm-5 | default_model=bailian/glm-5
列出所有可用模型
openclaw models list
輸出示例:
Model Input Ctx Local Auth Tags bailian/glm-5 text 198k no yes default,configured bailian/qwen3.5-plus text+image 977k no yes configured bailian/qwen3-max-2026-01-23 text 256k no yes configured ...
設(shè)置默認(rèn)模型
# 使用完整模型 ID openclaw models set bailian/qwen3.5-plus # 或使用別名 openclaw models set qwen
設(shè)置圖像模型
openclaw models set-image bailian/qwen3.5-plus
方法三:使用切換腳本
Model Switcher 技能提供了便捷的切換腳本:
# 查看當(dāng)前模型和可用列表 python3 ~/.openclaw/workspace/skills/model-switcher/scripts/switch_model.py # 切換到指定模型 python3 ~/.openclaw/workspace/skills/model-switcher/scripts/switch_model.py kimi python3 ~/.openclaw/workspace/skills/model-switcher/scripts/switch_model.py qwen python3 ~/.openclaw/workspace/skills/model-switcher/scripts/switch_model.py glm # 列出所有可用模型 python3 ~/.openclaw/workspace/skills/model-switcher/scripts/switch_model.py --list
方法四:配置文件修改
直接編輯 ~/.openclaw/openclaw.json:
{
"agents": {
"defaults": {
"model": {
"primary": "bailian/glm-5" // 修改這里
}
}
}
}模型別名管理
添加自定義別名簡化切換:
# 添加別名 openclaw models aliases add my-favorite bailian/qwen3.5-plus # 列出所有別名 openclaw models aliases list # 刪除別名 openclaw models aliases remove my-favorite
多模型使用場景
場景一:編程任務(wù)切換到編程專用模型
# 開始編程任務(wù)前切換 openclaw models set bailian/qwen3-coder-plus # 完成編程任務(wù)后切回通用模型 openclaw models set bailian/glm-5
場景二:處理長文檔
# 切換到超大上下文模型 openclaw models set bailian/qwen3.5-plus # 977k tokens # 或使用 MiniMax openclaw models set bailian/MiniMax-M2.5
場景三:圖像理解任務(wù)
# 切換到支持圖像的模型 openclaw models set bailian/qwen3.5-plus # 或使用 Kimi openclaw models set moonshot/kimi-k2.5
配置備用模型(Fallback)
當(dāng)主模型不可用時自動切換到備用模型:
# 查看當(dāng)前 fallback 配置 openclaw models fallbacks list # 添加 fallback openclaw models fallbacks add bailian/qwen3.5-plus # 圖像模型 fallback openclaw models image-fallbacks add moonshot/kimi-k2.5
會話級模型切換
注意:模型切換通常對新會話生效。當(dāng)前對話會繼續(xù)使用原模型。
如需在當(dāng)前會話切換模型,可以:
- 結(jié)束當(dāng)前會話,開始新會話
- 或使用
/reasoning命令臨時切換(如支持)
常見問題解答
Q1: 如何查看當(dāng)前使用的模型?
openclaw session_status
或查看 OpenClaw 啟動時的輸出,包含 model=xxx 信息。
Q2: 切換模型后需要重啟嗎?
通常不需要。新的對話會話會自動使用新模型。但某些情況下可能需要重啟 Gateway:
openclaw gateway restart
Q3: API Key 配置錯誤怎么辦?
運行診斷命令:
openclaw doctor
檢查配置并修復(fù)問題。
Q4: 如何知道哪些模型已配置?
openclaw models list
輸出中的 Tags 列會顯示 configured 表示已配置。
Q5: 模型切換失敗怎么辦?
檢查模型 ID 是否正確
openclaw models list
檢查 API Key 是否配置
openclaw models auth order get
查看詳細(xì)錯誤信息
openclaw models set <model-id> --verbose
Q6: 如何同時使用多個模型?
OpenClaw 支持多模型配置:
{
"agents": {
"defaults": {
"models": {
"bailian/qwen3.5-plus": {},
"bailian/glm-5": {},
"bailian/qwen3-coder-plus": {}
}
}
}
}
切換時指定模型即可,無需每次重新配置。
Q7: 模型響應(yīng)速度慢怎么辦?
不同模型響應(yīng)速度不同:
- 快速響應(yīng):
qwen3.5-plus、glm-5 - 中等速度:
qwen3-max、kimi-k2.5 - 較慢但更智能:大型模型推理時間更長
根據(jù)任務(wù)緊急程度選擇合適的模型。
快速參考卡片
常用命令速查
# 查看狀態(tài) openclaw session_status # 列出模型 openclaw models list # 切換模型 openclaw models set <model-id> # 配置認(rèn)證 openclaw models auth add # 運行診斷 openclaw doctor # 配置向?qū)? openclaw configure
模型快速切換別名
| 別名 | 完整 ID | 說明 |
|---|---|---|
qwen | bailian/qwen3.5-plus | 通義千問通用版 |
qwen-max | bailian/qwen3-max-2026-01-23 | 通義千問旗艦版 |
qwen-coder | bailian/qwen3-coder-next | 通義千問編程版 |
glm | bailian/glm-5 | 智譜 GLM-5 |
kimi | moonshot/kimi-k2.5 | Kimi K2.5 |
minimax | bailian/MiniMax-M2.5 | MiniMax M2.5 |
總結(jié)
OpenClaw 提供了靈活的模型配置和切換機制:
- 配置簡單:支持命令行、配置文件、交互向?qū)Ф喾N方式
- 切換便捷:自然語言、命令行、腳本任選
- 多模型支持:涵蓋主流國產(chǎn)大模型
- 按需選擇:根據(jù)任務(wù)類型選擇最適合的模型
建議根據(jù)日常使用場景設(shè)置一個默認(rèn)模型,并在特殊任務(wù)時臨時切換。這樣可以兼顧效率和功能需求。
到此這篇關(guān)于OpenClaw如何切換不同AI模型?2026年OpenClaw模型配置與切換指南的文章就介紹到這了,更多相關(guān)OpenClaw模型配置和切換內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章

OpenClaw 完整配置教程:模型接入與通訊渠道對接全流程詳解
本文介紹了OpenClaw的兩種配置模式、自定義大模型接入全流程及通訊軟件對接方法,Onboard模式適合快速配置主流模型,Dashboard模式支持自定義模型接入與可視化管理,感興趣的2026-04-08
OpenClaw怎么換大模型?3步免費切換各種大模型配置教程
文章詳細(xì)介紹了OpenClaw如何通過靈活配置對接各類模型服務(wù),支持免費或低成本使用云端、本地私有化模型及自定義模型,通過三步配置更換模型,實現(xiàn)智能降級切換,需要的朋友可以2026-04-02
OpenClaw是一款開源的AI智能體網(wǎng)關(guān)工具,它允許用戶在本地部署AI助手,并通過網(wǎng)關(guān)將聊天應(yīng)用連接到AI智能體,從而實現(xiàn)功能的本地化部署,這篇文章主要介紹了OpenClaw模型配置與2026-03-23
本文主要介紹了配置OpenClaw的模型參數(shù)的兩種方法,包括接入模型提供商和調(diào)整模型運行參數(shù),文中通過示例代碼介紹的非常詳細(xì),需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2026-03-23
OpenClaw國內(nèi)五個主流大模型配置與接入指南:MiniMax、GLM、Kimi、Doubao、Qwen
OpenClaw(原名Moltbot、Clawdbot)是2026年初爆火的開源個人AI助手項目,支持本地部署,兼容多種消息平臺,本文將基于最新官方文檔,提供五個主流國內(nèi)大模型的完整配置方2026-03-15
Mac mini上部署配置OpenClaw并接入國產(chǎn)大模型與飛書
本文詳細(xì)介紹了在Macmini上部署OpenClaw的全過程,包括配置安裝及國產(chǎn)大模型接入以及飛書機器人集成,搭建一個的AI助手,滿足日常自動化需求,需要的朋友們下面隨著小編來一起2026-03-09
OpenClaw使用Ollama本地模型的實現(xiàn)(支持工具調(diào)用))
Ollama 是一個本地 LLM 運行時,可以輕松在你的機器上運行開源模型,OpenClaw 通過 Ollama 的 OpenAI 兼容 API 進行集成,下面就來詳細(xì)的介紹一下,感興趣的可以了解一下2026-03-06
Linux環(huán)境下配置openclaw并連接到局域網(wǎng)ollama模型
本文介紹了如何在Linux環(huán)境下配置OpenClaw并連接到局域網(wǎng)內(nèi)的ollama模型,包括環(huán)境準(zhǔn)備、部署步驟、配置provider和model、飛書插件安裝與配置,以及消息測試和定時任務(wù)設(shè)置,2026-03-04
這篇文章給大家介紹OpenClaw 使用教程跨平臺安裝部署、配置大模型 Provider、接入 Ollama、本地 Skills/插件、瀏覽器控制、搜索 API、Obsidian Skills的相關(guān)操作,感興趣的2026-03-05
OpenClaw千帆模型切換:精準(zhǔn)配置步驟與關(guān)鍵命令詳解
本文圍繞OpenClaw千帆模型切換展開,系統(tǒng)梳理從環(huán)境準(zhǔn)備到配置落地的全流程,精準(zhǔn)拆解關(guān)鍵配置步驟與核心命令,涵蓋模型選擇、授權(quán)登錄、配置生效等環(huán)節(jié),為開發(fā)者提供實操2026-03-02











