OpenClaw 新手必读：安装后第一步——配置 AI 模型

OpenClaw 是什么？

OpenClaw 是一个开源的 AI 助手网关。它的作用是把各种 AI 大模型（如 ChatGPT、Claude、通义千问等）和各种聊天平台（如微信、飞书、钉钉等）连接起来。你可以理解为：

聊天平台（微信、飞书、钉钉...）  ←→  OpenClaw 网关  ←→  AI 大模型（GPT、Claude、千问...）

OpenClaw 负责中间的"桥梁"工作：接收聊天消息、转发给 AI 模型、把 AI 的回复发回聊天平台。

几个基础概念

在开始配置之前，先了解几个你会经常看到的术语：

• 网关（Gateway）：OpenClaw 的核心服务进程，负责接收和转发消息。启动命令是 openclaw gateway。
• 模型提供商（Provider）：提供 AI 模型服务的平台，比如阿里的通义千问、字节的豆包、OpenAI 等。
• API Key：平台颁发给你的"通行证"，用来证明你有权使用该平台的 AI 模型。每个平台需要单独申请。
• 频道（Channel）：OpenClaw 对接的聊天平台，比如微信、飞书、钉钉、网页聊天等。
• Skill（技能）：给 AI 助手扩展能力的插件，比如搜索网页、读取 PDF、生成图片等。
• onboard：OpenClaw 提供的交互式初始化命令，引导你完成首次配置。

安装后为什么不能直接聊天？

因为 OpenClaw 本身不包含 AI 模型。它就像一个"万能遥控器"——买回来了，但你得告诉它要控制哪台电视。

安装完 OpenClaw 后启动网关，你会看到类似这样的提示：

[gateway] ⚠ No model configured. Please run: openclaw onboard

这意味着你需要选择一个 AI 模型提供商，获取 API Key，然后告诉 OpenClaw 使用它。

支持的平台

OpenClaw 支持接入 30+ 模型平台，以下是完整列表（按类别分组）：

国产大模型平台：

海外模型平台：

推理加速与路由平台：

云服务商托管：

本地/自托管：

各平台的价格、免费额度等信息请以各平台最新公告为准。

通用配置流程

第一步：到平台官网注册并获取 API Key

前往你选择的平台官网，注册账号并在开发者控制台创建 API Key。

重要：API Key 通常只显示一次，请务必妥善保存。API Key 等同于密码，不要提交到 Git 或分享给他人。

第二步：使用 onboard 命令配置

OpenClaw 提供了交互式配置命令，按提示操作即可：

openclaw onboard

你也可以直接指定提供商，跳过选择步骤：

# 通义千问 / Model Studio
openclaw onboard --auth-choice modelstudio-api-key

# 火山引擎（豆包）
openclaw onboard --auth-choice volcengine-api-key

# Moonshot / Kimi
openclaw onboard --auth-choice moonshot-api-key

# Kimi Coding
openclaw onboard --auth-choice kimi-code-api-key

# 智谱 GLM
openclaw onboard --auth-choice zai-cn

# OpenAI
openclaw onboard --auth-choice openai-api-key

# Ollama 本地模型
openclaw onboard --auth-choice ollama

onboard 更多参数：--flow quickstart（最简配置）、--non-interactive（非交互式，用于脚本）、--secret-input-mode ref（使用环境变量引用而非明文密钥）。

第三步：验证配置

openclaw models status

看到 connected 说明配置成功。

第四步：启动网关

openclaw gateway

看到以下输出说明一切就绪：

[gateway] OpenClaw started
[gateway] Dashboard: http://127.0.0.1:18789/
[gateway] Waiting for messages...

快速测试

如果还没配置频道，可以直接命令行测试：

openclaw chat --message "你好，介绍一下你自己"

各平台配置详解

配置文件位于 ~/.openclaw/openclaw.json，使用 JSON5 格式。网关会监视此文件变更并自动应用，无需重启。

通义千问 / Model Studio

通义千问通过 Model Studio（DashScope）接入。

环境变量：MODELSTUDIO_API_KEY

onboard 命令：

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-plus、qwen3-coder-plus、qwen3-coder-next。

火山引擎（豆包）

火山引擎提供两个 Provider：volcengine（通用任务）和 volcengine-plan（代码专项）。

环境变量：VOLCANO_ENGINE_API_KEY

onboard 命令：

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-8、doubao-seed-code-preview、ark-code-latest、deepseek-v3-2、Kimi-K2.5、glm-4.7。

DeepSeek

环境变量：DEEPSEEK_API_KEY

配置示例：

{
  env: {
    DEEPSEEK_API_KEY: "sk-your-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "deepseek/deepseek-chat"
      }
    }
  }
}

可选模型：deepseek-chat（通用聊天，128K 上下文）、deepseek-reasoner（推理模式，带思维链）。

Moonshot / Kimi

两个独立 Provider：moonshot（标准 API）和 kimi-coding（Kimi Coding 专用）。

环境变量：MOONSHOT_API_KEY / KIMI_API_KEY

onboard 命令：

# Moonshot 标准
openclaw onboard --auth-choice moonshot-api-key

# Kimi Coding
openclaw onboard --auth-choice kimi-code-api-key

配置示例：

{
  env: {
    MOONSHOT_API_KEY: "sk-your-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "moonshot/kimi-k2.5"
      }
    }
  }
}

可选模型：kimi-k2.5、kimi-k2-turbo-preview、kimi-k2-thinking。Kimi Coding 使用 kimi-coding/k2p5。

上下文窗口 256K，最大输出 8192 tokens。

智谱 AI（GLM）

环境变量：ZAI_API_KEY

onboard 命令：

openclaw onboard --auth-choice zai-cn

配置示例：

{
  env: {
    ZAI_API_KEY: "sk-your-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "zai/glm-5"
      }
    }
  }
}

可选模型：glm-5、glm-4.7、glm-4.6。

OpenAI

环境变量：OPENAI_API_KEY

onboard 命令：

openclaw onboard --auth-choice openai-api-key

配置示例：

{
  env: {
    OPENAI_API_KEY: "sk-your-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "openai/gpt-5.4"
      }
    }
  }
}

Anthropic

环境变量：ANTHROPIC_API_KEY

配置示例：

{
  env: {
    ANTHROPIC_API_KEY: "sk-ant-your-key"
  },
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-6"
      }
    }
  }
}

可选模型：claude-opus-4-6、claude-sonnet-4-6。

Ollama（本地模型）

无需 API Key，无需联网。先安装 Ollama 并下载模型：

ollama pull qwen3.5:27b

onboard 命令：

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"
      }
    }
  }
}

配置示例（显式声明）：

{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://127.0.0.1:11434",
        apiKey: "ollama-local",
        api: "ollama",
        models: [
          {
            id: "qwen3.5:27b",
            contextWindow: 8192,
            maxTokens: 81920,
            cost: { input: 0, output: 0 }
          }
        ]
      }
    }
  }
}

重要：Ollama 的 baseUrl 不要加 /v1，否则工具调用会失效。使用原生 Ollama API。

进阶：多模型组合与故障切换

你可以同时配置多个 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"]
      }
    }
  }
}

常见问题

Q：配置完模型后还是不能聊天？

检查以下几点：

1. 运行 openclaw models status 确认模型状态
2. 确认网关已启动（openclaw gateway）
3. 如果用频道聊天，确认频道也已正确配置

Q：API Key 泄露了怎么办？

立即到对应平台的控制台删除旧 Key 并创建新的。

Q：不想注册任何平台怎么办？

使用 Ollama 运行本地模型，完全离线可用，无需注册和 API Key。

Q：配置文件修改后需要重启吗？

不需要。OpenClaw 网关会监视配置文件变更并自动应用。