1. OpenClaw 与 AI 模型配置概述OpenClaw 是一个开源的 AI 助手网关它的核心功能是将各种 AI 大模型如 ChatGPT、Claude、通义千问等与各类聊天平台如微信、飞书、钉钉等连接起来。你可以把它想象成一个万能遥控器——买回来后你需要告诉它要控制哪台电视。安装完 OpenClaw 后配置 AI 模型就是这关键的第一步。这个工具特别适合需要在不同平台统一管理 AI 交互的开发者或者想要搭建个性化 AI 助手的进阶用户。通过 OpenClaw你可以在微信对话中使用通义千问在飞书群里调用 Claude为不同场景配置不同的 AI 模型实现多模型自动切换和故障转移2. 核心概念解析2.1 基础组件理解在开始配置前需要先了解几个核心概念网关(Gateway)OpenClaw 的核心服务进程负责接收和转发消息。启动命令是openclaw gateway。模型提供商(Provider)提供 AI 模型服务的平台比如阿里的通义千问、字节的豆包、OpenAI 等。API Key平台发放的通行证用来证明你有权使用该平台的 AI 模型。每个平台都需要单独申请。频道(Channel)OpenClaw 对接的聊天平台比如微信、飞书、钉钉、网页聊天等。技能(Skill)给 AI 助手扩展能力的插件比如搜索网页、读取 PDF、生成图片等。2.2 支持的主流模型平台OpenClaw 支持 30 模型平台主要分为几类国产大模型平台通义千问 / Model Studio火山引擎(豆包)DeepSeekMoonshot(Kimi)智谱 AI(GLM)百度千帆MiniMax小米 MiMo海外模型平台Anthropic(Claude)OpenAI(GPT)Google(Gemini)MistralxAI(Grok)PerplexityVenice AI推理加速与路由平台GroqTogether AIOpenRouterNVIDIAHugging Face云服务托管Amazon BedrockCloudflare AI GatewayVercel AI GatewayGitHub Copilot本地/自托管OllamavLLMSGLangLiteLLM3. 模型配置详细流程3.1 通用配置步骤配置 AI 模型的基本流程如下获取 API Key前往你选择的平台官网注册账号在开发者控制台创建 API Key重要API Key 通常只显示一次务必妥善保存使用 onboard 命令配置openclaw onboard这个交互式命令会引导你完成配置。你也可以直接指定提供商# 通义千问 openclaw onboard --auth-choice modelstudio-api-key # 火山引擎(豆包) openclaw onboard --auth-choice volcengine-api-key # Moonshot/Kimi openclaw onboard --auth-choice moonshot-api-key验证配置openclaw models status看到connected表示配置成功。启动网关openclaw gateway3.2 配置详解通义千问通义千问通过 Model Studio(DashScope)接入。环境变量MODELSTUDIO_API_KEYonboard 命令openclaw onboard --auth-choice modelstudio-api-key-cn配置示例{ env: { MODELSTUDIO_API_KEY: sk-your-key }, agents: { defaults: { model: { primary: modelstudio/qwen3.5-plus } } } }可选模型qwen3.5-plusqwen3-coder-plusqwen3-coder-next3.3 配置详解火山引擎(豆包)火山引擎提供两个 Providervolcengine(通用任务)volcengine-plan(代码专项)环境变量VOLCANO_ENGINE_API_KEYonboard 命令openclaw onboard --auth-choice volcengine-api-key非交互式配置openclaw onboard --non-interactive --mode local \ --auth-choice volcengine-api-key \ --volcengine-api-key $VOLCANO_ENGINE_API_KEY配置示例{ env: { VOLCANO_ENGINE_API_KEY: sk-your-key }, agents: { defaults: { model: { primary: volcengine/doubao-seed-1-8 } } } }代码专项使用volcengine-plan/ark-code-latest可选模型doubao-seed-1-8doubao-seed-code-previewark-code-latestdeepseek-v3-2Kimi-K2.5glm-4.73.4 配置详解Ollama 本地模型Ollama 无需 API Key无需联网。先安装 Ollama 并下载模型ollama pull qwen3.5:27bonboard 命令openclaw onboard --auth-choice ollama非交互式配置openclaw onboard --non-interactive \ --auth-choice ollama \ --custom-base-url http://127.0.0.1:11434 \ --custom-model-id qwen3.5:27b \ --accept-risk配置示例{ agents: { defaults: { model: { primary: ollama/qwen3.5:27b } } } }重要提示Ollama 的 baseUrl 不要加 /v1要使用原生 Ollama API。4. 高级配置技巧4.1 多模型组合与故障切换你可以同时配置多个 Provider设置自动故障切换{ env: { MODELSTUDIO_API_KEY: sk-xxx, VOLCANO_ENGINE_API_KEY: sk-xxx }, agents: { defaults: { model: { primary: modelstudio/qwen3.5-plus, fallbacks: [volcengine/doubao-seed-1-8] } } } }4.2 配置热更新OpenClaw 的配置文件位于~/.openclaw/openclaw.json使用 JSON5 格式。网关会监视文件变更并自动应用无需重启。4.3 非交互式配置对于自动化部署可以使用非交互模式openclaw onboard --non-interactive \ --auth-choice volcengine-api-key \ --volcengine-api-key $VOLCANO_ENGINE_API_KEY \ --primary-model volcengine/doubao-seed-1-85. 常见问题排查5.1 配置模型后仍不能聊天检查以下几点运行openclaw models status确认模型状态确认网关已启动(openclaw gateway)如果使用频道聊天确认频道也已正确配置5.2 API Key 泄露怎么办立即到对应平台的控制台删除旧 Key创建新 Key。切勿将 Key 提交到 Git 或分享给他人。5.3 不想注册任何平台可以使用 Ollama 运行本地模型完全离线可用无需注册和 API Key。5.4 修改配置后需要重启吗不需要。OpenClaw 网关会自动监视配置文件的变更并应用。6. 各平台配置参数速查表平台Provider ID环境变量示例模型 ID通义千问modelstudioMODELSTUDIO_API_KEYmodelstudio/qwen3.5-plus火山引擎volcengineVOLCANO_ENGINE_API_KEYvolcengine/doubao-seed-1-8DeepSeekdeepseekDEEPSEEK_API_KEYdeepseek/deepseek-chatMoonshotmoonshotMOONSHOT_API_KEYmoonshot/kimi-k2.5智谱 GLMzaiZAI_API_KEYzai/glm-5OpenAIopenaiOPENAI_API_KEYopenai/gpt-5.4ClaudeanthropicANTHROPIC_API_KEYanthropic/claude-sonnet-4-6Ollamaollama-ollama/qwen3.5:27b7. 个人实操建议在实际使用中我有几个特别推荐的做法国产模型优先通义千问和豆包的中文理解能力已经非常出色且价格通常比海外模型更优惠。本地测试先用 Ollama在开发调试阶段先用 Ollama 本地模型快速验证流程再切换至云端模型。设置合理的 fallbacks为主模型配置备用模型确保服务连续性。例如fallbacks: [ volcengine/doubao-seed-1-8, modelstudio/qwen3.5-plus, ollama/qwen3.5:27b ]关注上下文窗口不同模型的上下文长度差异很大通义千问和 DeepSeek 通常提供较大的上下文窗口(128K)适合长文档处理。成本监控虽然 OpenClaw 本身开源免费但使用的云模型可能产生费用建议在各大平台设置用量告警。