夜雨聆风第5篇：OpenClaw模型配置指南｜对接国内外模型，零成本解锁全部技能
上一篇我们给OpenClaw安装了10个必装技能，让“龙虾”拥有了“干活的工具”。但很多朋友反馈：明明装了技能，发送指令后却没响应，甚至提示“模型未配置，无法执行”——这就是核心问题：技能是“工具”，AI模型是“动力源”，没有动力源，再好用的工具也无法运转。
今天这篇，就带大家彻底搞定OpenClaw的模型配置，手把手教你对接Claude、GPT、通义千问等国内外主流模型，还有零成本免费模型推荐，新手也能轻松上手，让你的“龙虾”真正动起来，解锁所有技能的全部功能！
全程零基础友好，步骤清晰可复制，重点避开所有新手踩坑点，看完就能配置完成，立马测试技能效果～
先划重点：模型配置的核心认知
很多新手会混淆“模型”和“技能”的关系，这里用一句话讲透：
技能负责“做什么”（比如生成周报、调试代码），模型负责“怎么做”（理解指令、执行逻辑、输出结果）。没有模型，技能只是一段“沉睡的脚本”；配置好模型，技能才能被激活，真正帮你干活。
1OpenClaw的核心优势：不绑定任何单一模型，支持“国际模型+国产模型+本地模型”自由切换，还能设置“模型兜底链”，主模型不可用时自动切换备选模型，兼顾效果和成本；
1配置核心前提：确保OpenClaw已正常启动（终端输入openclaw gateway status显示running），且已安装至少1个技能（比如“周报生成”），方便配置后测试效果；
1成本可控：可选择免费模型（零成本）、低成本模型（Claude 3.5 Sonnet），无需额外付费，新手优先从免费模型入手。
第一步：模型配置入口（2种方式，新手首选Web界面）
OpenClaw的模型配置有两种方式，Web界面直观易懂，新手首选；终端命令适合开发者，高效快捷，按需选择即可。
方式一：Web管理界面配置（推荐★★★★★，零基础首选）
全程鼠标操作，无需输命令，步骤如下：
1打开OpenClaw Web管理界面（云部署：http://你的服务器IP:3000；本地部署：http://127.0.0.1:3000）；
1点击左侧导航栏「模型管理」，进入配置页面，默认显示“未配置任何模型”；
1点击「添加模型」，选择你要对接的模型类型（国际模型/国产模型/本地模型），进入配置页面；
1填写模型相关信息（API Key、模型版本等，后续会详细讲），点击「保存」，系统自动加载模型，无需重启网关。
方式二：终端命令配置（开发者首选，高效快捷）
适合习惯用终端的开发者，输入一条命令即可进入配置界面，步骤如下：
1打开终端，输入命令openclaw model configure，回车后进入模型配置交互界面；
1按终端提示，选择模型类型、输入API Key、设置模型优先级，全程按回车键确认，无需手动编写配置文件；
1配置完成后，输入openclaw model list，查看已配置的模型，显示“active”即配置成功。
常用终端命令补充（复制可用）：
bash # 进入模型配置界面 openclaw model configure # 查看已配置模型 openclaw model list # 启用/禁用模型 openclaw model enable 模型ID openclaw model disable 模型ID # 设置默认模型（优先使用） openclaw model set-default 模型ID # 删除模型配置 openclaw model delete 模型ID |
第二步：3类模型配置实操（新手优先免费模型）
OpenClaw支持所有主流AI模型，按“免费易配置”排序，给大家整理了3类最常用的模型配置方法，覆盖新手、性价比党、开发者所有需求，步骤详细可复制。
类别1：免费国产模型（零成本，新手首选）
适合新手、不想付费的朋友，推荐「通义千问免费版」「豆包免费版」，无需付费，注册即可获取API Key，配置简单，足够满足日常技能使用（生成周报、文案、简单代码）。
以「通义千问免费版」为例，步骤如下：
1获取API Key： 打开通义千问官网（https://tongyi.aliyun.com/），注册并登录账号； 进入「控制台」→「AccessKey管理」，创建AccessKey，复制「AccessKey ID」和「AccessKey Secret」（保存好，后续会用到）。
1Web界面配置： 打开OpenClaw Web管理界面→「模型管理」→「添加模型」，选择「国产模型」→「通义千问」； 粘贴刚才复制的「AccessKey ID」和「AccessKey Secret」，选择模型版本（免费版选「qwen-turbo」）； 设置优先级（默认1级即可，数字越小优先级越高），点击「保存」，配置完成。
1测试效果： 在飞书/钉钉发送指令「帮我生成本周周报」，若能正常生成，说明模型配置成功。
新手避坑：通义千问免费版有调用限额（每天1000次），足够日常使用；若提示“调用超限”，可切换「豆包免费版」，配置步骤完全一致。
类别2：国际模型（Claude/GPT，性价比首选）
适合对效果有要求、需要处理复杂任务（比如代码调试、复杂文案、数据建模）的朋友，推荐「Claude 3.5 Sonnet」（性价比最高），配合之前讲的Batch API，可进一步降低成本。
以「Claude 3.5 Sonnet」为例，步骤如下：
1获取API Key： 打开Claude官网（https://www.anthropic.com/），登录账号； 进入「Settings」→「API Keys」，点击「Create Key」，生成API Key，复制保存（不要泄露给他人）。
1模型配置： OpenClaw Web界面→「模型管理」→「添加模型」，选择「国际模型」→「Claude」； 粘贴API Key，选择模型版本「claude-3-5-sonnet-20241022」（最新稳定版）； 勾选「启用Batch优化」（降低Token消耗，省50%成本），点击「保存」。
1测试效果： 发送指令「帮我调试一段Java代码，找出Bug并优化」，粘贴代码片段，若能正常分析并给出优化方案，即配置成功。
补充说明：GPT-4o配置步骤完全一致，仅需在「添加模型」时选择「GPT」，粘贴OpenAI的API Key即可，适合习惯用GPT的朋友。
类别3：本地模型（隐私优先，零网络依赖）
适合隐私敏感度高、不想将数据上传到云端的朋友，需本地安装Ollama/LM Studio，配置后可离线使用，无需API Key，步骤如下：
1安装本地模型工具： 下载Ollama（官网：https://ollama.com/），安装完成后，终端输入ollama pull qwen:7b（下载免费的通义千问7B模型）；
1OpenClaw配置本地模型： Web界面→「模型管理」→「添加模型」，选择「本地模型」→「Ollama」； 填写本地模型地址（默认：http://127.0.0.1:11434），选择模型名称「qwen:7b」，点击「保存」；
1测试效果： 断开网络，发送指令「帮我整理一份技能使用清单」，若能正常响应，说明本地模型配置成功。
新手提示：本地模型对电脑配置有要求（建议8G以上内存），若电脑配置较低，优先选择免费国产模型，无需占用本地资源。
第三步：模型管理技巧（新手必学，避免踩坑）
配置好模型后，做好管理，能避免出现“模型失效”“技能无法执行”等问题，3个核心技巧记好：
1设置默认模型和兜底链： 在「模型管理」中，将常用模型（比如Claude 3.5）设为「默认模型」，再添加1-2个免费模型作为「备选」，设置兜底规则——当默认模型调用失败（比如API Key过期），自动切换到备选模型，避免技能中断。
1定期检查API Key有效性： 免费模型的API Key可能会过期（比如通义千问免费版AccessKey有效期1年），建议每月检查一次，若技能无法执行，先排查API Key是否过期，重新生成并更新配置即可。
1根据技能类型切换模型： 不同模型的优势不同，按需切换效率更高： - 办公技能（周报、文案）：用免费国产模型（通义千问/豆包），足够用且零成本； - 编程技能（代码调试、重构）：用Claude 3.5/GPT-4o，效果更好； - 隐私敏感任务（处理个人数据）：用本地模型，数据不泄露。
常见问题排查（新手必看）
配置完成后，若技能无法执行，大概率是以下3个问题，对照排查，快速解决：
1模型未启用：进入「模型管理」，查看模型状态是否为「active」，若为「disable」，点击「启用」即可；
1API Key错误/过期：重新生成API Key，更新模型配置，保存后测试；
1网络问题：国际模型（Claude/GPT）需确保服务器能访问外网，国内云服务器可配置代理；免费国产模型无需外网，直接可用。
文末预告
今天我们搞定了OpenClaw的模型配置，不管是免费国产模型、高性价比国际模型，还是本地隐私模型，都能轻松对接，现在你的“龙虾”已经能正常执行所有技能，帮你处理办公、编程、生活等各类任务了。
但还有一个关键问题：技能和模型都配置好了，如何让“龙虾”自动干活，不用你手动发指令？下一篇我们就讲OpenClaw自动化任务配置指南，手把手教你设置定时任务、触发式任务，让“龙虾”24小时自动工作，彻底解放双手～
