openclaw-大模型配置

一、OpenClaw 配置添加大模型-Model本章节详细介绍 OpenClaw 的大模型配置流程从启动配置向导开始一步步说明 Gateway 运行位置选择、配置项选择、模型提供商选择以智谱AI Z.AI 为例、认证方式选择、API Key 输入、可用模型选择直到完成配置的完整过程。每个步骤都包含配置界面展示、选项含义说明、选择建议以及实际配置记录帮助你快速完成 OpenClaw 的大模型配置。步骤 1: 运行openclaw的配置向导C:\Users\Administratoropenclaw config|o OpenClaw2026.6.10(aa69b12)— Opensourcemeans you can see exactly how I judge your config. T OpenClaw configure|o Existing config detected --------------|||Workspace:$OPENCLAW_HOME\workspace||Model: ollama/qwen3.5:4b||Gateway:localvia loopback on :18789|||-----------------------------------------|步骤 2选择Gateway 运行位置配置界面* Where will the Gateway run? | Local (this machine) (Gateway reachable (ws://127.0.0.1:18789)) | Remote (info-only)选项说明选项含义选择建议Local (this machine)Gateway 在你的电脑本地运行可以使用完整功能✅推荐选择绝大多数用户选这个Remote (info-only)仅连接到远程 Gateway本地功能受限只有你有专门的远程 Gateway 服务器时才选选择Local步骤 3选择配置项配置界面* What do you want to configure? | Workspace (Set workspace sessions) | Model | Web tools | Gateway | Daemon | Channels | Plugins | Skills | Health check | Skip for now选项说明选项含义选择建议Workspace设置工作目录和会话管理首次可用先不选Model配置 AI 模型提供商和 API 密钥✅首次配置选这个这是核心Web tools启用网页搜索等网络工具后续可以再配置GatewayGateway 服务器的高级设置一般用默认即可Daemon后台服务配置后续可以再配置Channels配置 Discord、Telegram 等通讯渠道后续可以再配置Plugins管理插件后续可以再配置Skills配置技能库后续可以再配置Health check健康监控设置后续可以再配置Skip for now暂时跳过什么都不配置不建议选择Model步骤 3模型提供商选择第一轮配置界面* Model/auth provider | OpenAI | Anthropic | xAI (Grok) | Google | OpenRouter (OAuth or API key) | More… | Skip for now选项说明选项含义选择建议OpenAIGPT 系列模型GPT-4o、GPT-4 等如果你有 OpenAI API Key 可以选AnthropicClaude 系列模型如果你有 Anthropic API Key 可以选xAI (Grok)Grok 模型如果你有 xAI API Key 可以选GoogleGemini 系列模型如果你有 Google API Key 可以选OpenRouter模型聚合平台支持多个提供商如果你用 OpenRouter 可以选More…查看更多模型提供商✅推荐选择可以看到国内提供商Skip for now暂时跳过模型配置不建议选择More…步骤 4模型提供商选择第二轮 - More…配置界面* Model/auth provider | | Search: | ... | LM Studio | Microsoft Foundry | MiniMax | Mistral AI | Moonshot AI (Kimi K2.6) | NovitaAI | NVIDIA | Ollama | OpenCode | Qianfan | Qwen Cloud | SGLang | StepFun | Synthetic | Tencent Cloud | Together AI | Venice AI | Vercel AI Gateway | vLLM | Volcano Engine | Xiaomi | Z.AI (GLM Coding Plan / Global / CN) | Back主要国内选项说明选项含义特点MiniMaxMiniMax 提供商国产模型Moonshot AI (Kimi K2.6)Kimi 月之暗面国产模型Ollama本地运行模型完全免费但需要本地资源Qwen Cloud阿里云通义千问国产模型Volcano Engine火山引擎字节跳动旗下Z.AI (GLM Coding Plan / Global / CN)智谱AI✅推荐中文优化好有免费额度选择Z.AI (GLM Coding Plan / Global / CN)步骤 5Z.AI 认证方式选择配置界面* Z.AI auth method | CN (Z.AI CN (open.bigmodel.cn)) | Coding-Plan-CN | Coding-Plan-Global | Global | Z.AI API key | Back选项说明选项含义选择建议CN (Z.AI CN)智谱AI国内标准版没有购买包月计划的选这个Coding-Plan-CN智谱AI国内编码计划版✅如果你购买了编码包月计划选这个Coding-Plan-Global智谱AI全球编码计划版购买了全球版的选这个Global智谱AI全球版需要国际版的选这个Z.AI API key直接输入 API Key最灵活的方式选择Coding-Plan-CN步骤 6输入 API Key配置界面o Enter Z.AI API key | •••••••••••••••••••••••••••••••••••••••••••••••••操作说明在此输入你的智谱AI API Key输入后按回车确认如何获取 API Key访问 https://www.bigmodel.cn/注册/登录账号点击右上角用户图标 → “API KEY”或直接访问https://www.bigmodel.cn/usercenter/proj-mgmt/apikeys点击添加新的API Key复制生成的 Key安全提示⚠️ 不要分享你的 API Key 给他人可以在平台上随时撤销和重新生成 Key选择已输入 API Key步骤 7选择可用模型多选配置界面* Models in /model picker (multi-select) | | Search: | [] zai/glm-5.2 (GLM-5.2 · ctx 977k · reasoning · alias: GLM) | [ ] zai/glm-5.1 | [ ] zai/glm-5 | [ ] zai/glm-5-turbo | [ ] zai/glm-5v-turbo | [ ] zai/glm-4.7 | [ ] zai/glm-4.7-flash | [ ] zai/glm-4.7-flashx | [ ] zai/glm-4.6 | [ ] zai/glm-4.6v | [ ] zai/glm-4.5 | [ ] zai/glm-4.5-air | [ ] zai/glm-4.5-flash | [ ] zai/glm-4.5v | ↑/↓ to navigate Tab: select Enter: confirm Type: to search操作说明↑/↓ 键上下移动选择Tab 键选中/取消选中可以多选Enter 键确认可以直接输入搜索模型详细说明模型ID名称特点适用场景zai/glm-5.2GLM-5.2最新版本能力最强977k上下文✅ 复杂任务、深度思考zai/glm-5.1GLM-5.1稳定版本日常工作、通用任务zai/glm-5GLM-5基础版本普通对话zai/glm-5-turboGLM-5 Turbo高速版需要快速响应的场景zai/glm-5v-turboGLM-5V Turbo多模态版支持图片需要理解图片的任务zai/glm-4.7GLM-4.7稳定版本稳定可靠zai/glm-4.7-flashGLM-4.7 Flash免费/低成本版✅ 日常使用节省成本zai/glm-4.7-flashxGLM-4.7 FlashX增强版更高需求zai/glm-4.6GLM-4.6旧版本兼容性场景zai/glm-4.6vGLM-4.6V多模态版图片理解zai/glm-4.5GLM-4.5旧版本兼容性场景zai/glm-4.5-airGLM-4.5 Air轻量版轻量级任务zai/glm-4.5-flashGLM-4.5 Flash免费版✅ 免费使用日常对话zai/glm-4.5vGLM-4.5V多模态版图片理解模型命名规则数字越大版本越新5.2 5.1 5 4.7Flash免费/低成本版本速度快Air轻量版性价比高V多模态版支持图片理解Turbo高速版选择建议✅必选glm-5.2能力最强✅推荐glm-4.5-flash免费建议至少选择 2-3 个不同定位的模型选择zai/glm-5.2步骤 8完成配置配置界面* What do you want to configure? | Workspace | Model | Web tools | Gateway | Daemon | Channels | Plugins | Skills | Health check | Done选项说明选项含义其他选项继续配置其他功能Done保存当前配置并退出向导选择建议配置完 Model 后选择Done后续需要配置其他功能时再运行openclaw config选择Done9、完整流程配置记录C:\Users\Administratoropenclaw config|o OpenClaw2026.6.10(aa69b12)— Opensourcemeans you can see exactly how I judge your config. T OpenClaw configure|o Existing config detected --------------|||Workspace:$OPENCLAW_HOME\workspace||Model: ollama/qwen3.5:4b||Gateway:localvia loopback on :18789|||-----------------------------------------|o Where will the Gateway run?|Local(this machine)|o Whatdoyou want to configure?|Model|o Model/auth provider|More…|* Model/auth provider||Search:|OpenAI|Anthropic|xAI(Grok)|Google|OpenRouter|Arcee AI|BytePlus|Cerebras|Chutes|Cloudflare AI Gateway|Cohere|Copilot|Custom Provider|DeepInfra|DeepSeek|Fireworks|GMI Cloud|o Model/auth provider|Z.AI|o Z.AI auth method|Coding-Plan-CN|o Enter Z.AI API key|•••••••••••••••••••••••••••••••••••••••••••••••••|o Provider notes --------------------------|||Verified GLM-5.2 on coding-cn endpoint.|||-------------------------------------------|o Model configured ---------------------------------------------------------|||Kept existing default model ollama/qwen3.5:4b;zai/glm-5.2 is available.|||----------------------------------------------------------------------------||o Modelsin/model picker(multi-select)|1items selected Updated config:$OPENCLAW_HOME\config\openclaw.json Backup:$OPENCLAW_HOME\config\openclaw.json.bak|o Whatdoyou want to configure?|Done|o Control UI ---------------------------------------------------|||Web UI: http://127.0.0.1:18789/||Gateway WS: ws://127.0.0.1:18789||Gateway: not detected(connect ECONNREFUSED127.0.0.1:18789)||Docs: https://docs.openclaw.ai/web/control-ui|||----------------------------------------------------------------|— Configuration updated.二、通过命令行添加模型认证openclaw models auth add本章节介绍使用openclaw models auth add命令添加模型认证的完整流程。与openclaw config配置向导不同该命令专门用于添加额外的 API Key 或认证配置适合已有模型配置后需要新增多个 API Key 的场景。步骤 1运行添加认证命令命令openclaw models authadd|o OpenClaw2026.6.10(aa69b12)— One CLI to rule them all, and onemorerestart because you changed the port.|步骤 2选择 Token 提供商配置界面* Token provider | anthropic (Docs: /providers/models) | custom (type provider id)选项说明选项含义选择建议anthropicAnthropic Claude 模型提供商如果你有 Anthropic API Key 可以选custom (type provider id)自定义输入提供商 ID✅推荐选择可以输入任意提供商说明列表中可能还会显示其他已配置的提供商如果列表中有你需要的提供商直接选择即可如果没有选择custom手动输入。常见提供商 ID提供商 ID对应平台zai智谱AIvolcengine-plan火山引擎包月版deepseekDeepSeekmoonshot月之暗面Kimiqwen通义千问xiaomi小米ollama本地模型openaiOpenAIanthropicAnthropic ClaudeopenrouterOpenRouter 聚合平台选择custom (type provider id)步骤 3输入提供商 ID配置界面o Provider id | zai操作说明输入你想要添加的模型提供商 ID参考上表中的常见提供商 ID输入完成后按回车确认输入zai步骤 4设置 Profile ID配置界面o Profile id | zai-my-zai-2选项说明字段含义命名建议Profile ID认证配置的唯一标识名称用于区分同一提供商的不同 API Key用清晰的命名方便后续管理命名规范建议提供商:用途→ 如zai:work、zai:personal提供商-自定义名→ 如zai-my-zai-2提供商:manual→ 如volcengine-plan:manual⚠️ 注意同一个提供商的 Profile ID 不能重复否则会覆盖已有配置输入zai-my-zai-2步骤 5设置 Token 是否过期配置界面* Does this token expire? | Yes / No选项说明选项含义选择建议YesToken 有过期时间如果你的 API Key 有有效期选这个NoToken 永不过期如果 API Key 长期有效选这个选择Yes步骤 6设置过期时长配置界面* Expires in (duration) | 365d常见选项选项含义30d30天过期90d90天过期365d365天过期一年Custom...自定义天数输入365d步骤 7输入/粘贴 API Key配置界面* Paste token for zai | •••••••••••••••••••••••••••••••••••••••••••••••••操作说明直接粘贴你的 API Key输入完成后按回车确认如何获取 API Key访问对应平台的 API Key 管理页面创建新的 API Key复制生成的 Key常见平台 API Key 获取地址平台获取地址智谱AIhttps://www.bigmodel.cn/usercenter/proj-mgmt/apikeysDeepSeekhttps://platform.deepseek.com/api_keys火山引擎https://console.volcengine.com/ark/region:arkcn-beijing/apiKey月之暗面https://platform.moonshot.cn/console/api-keys通义千问https://dashscope.console.aliyun.com/apiKey安全提示⚠️ 不要分享你的 API Key 给他人可以在平台上随时撤销和重新生成 Key输入已粘贴 API Key步骤 8完成添加成功输出Updated config: $OPENCLAW_HOME\config\openclaw.json Backup: $OPENCLAW_HOME\config\openclaw.json.bak Auth profile: zai-my-zai-2 (zai/token)输出说明字段含义Updated config配置文件已更新Backup自动备份了原配置文件Auth profile认证配置已创建成功显示 Profile ID 和类型✅ 看到以上输出说明添加成功完整操作流程记录C:\Users\Administratoropenclaw models authadd|o OpenClaw2026.6.10(aa69b12)— One CLI to rule them all, and onemorerestart because you changed the port.|o Token provider|custom(type providerid)|o Providerid|zai|o Profileid|zai-my-zai-2|o Does this token expire?|Yes|o Expiresin(duration)|365d|o Paste tokenforzai|••••••••••••••••••••••••••••••••••••••••••••••••• Updated config:$OPENCLAW_HOME\config\openclaw.json Backup:$OPENCLAW_HOME\config\openclaw.json.bak Auth profile: zai-my-zai-2(zai/token)四、models模型管理命令(新增、删除、查询、设置)1、查看模型列表# 查看所有已配置模型openclaw models list2、查看当前使用的模型# 查看当前默认模型openclaw models current3、切换模型# 切换默认模型(set后面的名称对应的是查询到已安装列表的Model全称)openclaw modelssetdeepseek/deepseek-v4-pro4、查看切换结果# 查看当前模型状态openclaw models status# 临时切换单次对话不改变默认openclaw chat--modelyuanbao/hunyuan-turbo--prompt测试五、添加模型提供方的多个 API Key 管理当你为同一个模型提供商添加了多个 API Key 时可以使用以下命令进行管理。主要作用管理多个认证配置- 允许你为同一个模型提供商添加多个不同的 API Key 或认证方式切换认证配置- 可以在不同的认证配置之间快速切换团队/多账号管理- 如果你有多个 API Key比如个人账号和公司账号可以分别配置1、查看所有 Auth ProfilesC:\Users\Administratoropenclaw models auth list|o OpenClaw2026.6.10(aa69b12)— Ive seen your commit messages. Well work on that together. Agent: main Auth state store:$OPENCLAW_HOME\state\agents\main\agent\openclaw-agent.sqlite Profiles: - deepseek:default[deepseek/api_key;disableduntil2026-06-24T13:55:58.152Z]- ollama-local[ollama/token;cooldownuntil2026-06-20T12:54:55.432Z]- ollama:default[ollama/api_key]- ollama:manual[ollama/token]- volcengine-plan:manual[volcengine/token;expires2027-06-17T01:54:38.520Z]- volcengine-plan/doubao-seed-code:manual[volcengine-plan/doubao-seed-code/token;expires2027-06-17T01:27:38.740Z]- zai-my-zai-2[zai/token;expires2027-06-27T13:19:55.622Z]- zai:default[zai/api_key]2、设置优先级顺序关键# 格式openclaw models auth order set --provider provider profile1 profile2...# 排在前面的 profile 优先使用# 示例设置 zai-my-zai-2 为第一优先级openclaw models auth orderset--providerzai zai-my-zai-2 zai:default成功输出C:\Users\Administratoropenclaw models auth order set --provider zai zai-my-zai-2 zai:default | o OpenClaw 2026.6.10 (aa69b12) — Shell yeah—Im here to pinch the toil and leave you the glory. Agent: main Provider: zai Order override: zai-my-zai-2, zai:default3、查看当前优先级顺序openclaw models auth order get--providerzai输出示例Agent: main Provider: zai Auth state store: $OPENCLAW_HOME\state\agents\main\agent\openclaw-agent.sqlite Order override: zai-my-zai-2, zai:default4、切换回原来的 profile# 把顺序反过来即可openclaw models auth orderset--providerzai zai:default zai-my-zai-25、清除优先级设置恢复默认openclaw models auth orderclear--providerzai6、完整实战示例添加第二个智谱 API Key已有一个 zai key现在再添加一个新 key步骤 1添加第二个 zai API Keyopenclaw models authadd然后按提示Provider:custom→ 输入zaiProfile id:zai-my-zai-2注意要用不同的名称是否过期:365dToken: 粘贴新的 API KeyC:\Users\Administratoropenclaw models authadd|o OpenClaw2026.6.10(aa69b12)— One CLI to rule them all, and onemorerestart because you changed the port.|o Token provider|custom(type providerid)|o Providerid|zai|o Profileid|zai-my-zai-2|o Does this token expire?|Yes|o Expiresin(duration)|365d|o Paste tokenforzai|••••••••••••••••••••••••••••••••••••••••••••••••• Updated config:$OPENCLAW_HOME\config\openclaw.json Backup:$OPENCLAW_HOME\config\openclaw.json.bak Auth profile: zai-my-zai-2(zai/token)步骤 2查看添加的 profileopenclaw models auth list应该能看到两个 profilezai:default- 原来的zai-my-zai-2- 新添加的步骤 3设置新 key 为第一优先级openclaw models auth orderset--providerzai zai-my-zai-2 zai:default步骤 4验证设置成功openclaw models auth order get--providerzai输出应该显示zai-my-zai-2, zai:default步骤 5测试一下是否正常工作openclaw chat--prompt测试一下