#OpenClaw 接入万模API

适用工具：OpenClaw / Clawdbot | 适合：想搭建个人 AI 助手、连接 IM 渠道、让模型执行工具和自动化任务的用户

OpenClaw 是一个开源个人智能体工具。它会在本机或服务器上运行 Gateway，把模型、聊天渠道、工具调用、配对权限和会话状态统一管理起来。接入万模API时，核心是把万模API配置成 OpenClaw 的自定义模型 provider，然后让默认智能体使用这个 provider 下的模型。

#你最终要填什么

OpenClaw 的自定义 provider 支持多种 API 适配器。万模API 的 OpenAI Chat 兼容模型优先使用 openai-completions。只有当你明确要接入 Responses 协议模型时，才考虑 openai-responses。

#开始前准备

建议先完成三件套与第一个请求，确认同一个 Key 和模型能通过 curl 请求成功。这样 OpenClaw 失败时，排查重点就可以放在 OpenClaw 配置上。

#第一步：创建 OpenClaw 专用令牌

进入万模API控制台，创建一个专门给 OpenClaw 使用的 API Key，例如：

openclaw-dev

这样做有三个好处：

1. 可以在调用日志里快速过滤 OpenClaw 请求。
2. 可以单独设置额度，避免智能体长时间运行造成异常消耗。
3. 如果消息渠道或服务器泄露，只需要停用这个令牌。

创建后复制完整 sk-...。不要把完整 Key 写进截图、公开文档、Git 仓库或 OpenClaw 共享配置。

#第二步：安装 OpenClaw

OpenClaw 官方推荐使用安装脚本。安装脚本会检测系统环境，在需要时处理 Node，并启动新手引导。

#macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

#Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

如果你已经自己管理 Node，也可以使用 npm：

npm install -g openclaw@latest
openclaw onboard --install-daemon

安装完成后，打开新的终端确认命令可用：

openclaw --version
openclaw doctor

如果提示 openclaw: command not found，通常是全局包路径没有进入 PATH。先确认：

node -v
npm prefix -g
echo "$PATH"

macOS / Linux 用户可以把全局 bin 路径加入 ~/.zshrc 或 ~/.bashrc。Windows 用户要确认是在 PowerShell、CMD 还是 WSL 中安装，不同环境的路径不共享。

#第三步：运行新手引导

安装后运行：

openclaw onboard --install-daemon

新手引导会让你选择模型 provider、填写 API Key、配置 Gateway，并决定是否安装后台服务。接入万模API时，模型部分建议按下面方式选择。

#第四步：确认配置文件

OpenClaw 的主要配置文件通常在：

~/.openclaw/openclaw.json

如果你希望手动检查或修正 provider，可以参考下面结构。JSON5 支持注释，但这里用普通 JSON 风格展示，便于复制理解。

{
  env: {
    WANMO_API_KEY: "sk-..."
  },
  agents: {
    defaults: {
      model: {
        primary: "wanmoapi/gpt-5.4-mini"
      },
      models: {
        "wanmoapi/gpt-5.4-mini": {
          alias: "WanmoAPI GPT"
        }
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      wanmoapi: {
        baseUrl: "https://www.wanmoapi.com/v1",
        apiKey: "${WANMO_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.4-mini",
            name: "WanmoAPI GPT 5.4 Mini",
            input: ["text"],
            reasoning: false
          }
        ]
      }
    }
  }
}

为了降低泄露风险，也可以把 Key 放到环境变量里：

echo 'export WANMO_API_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

然后在配置中继续使用：

apiKey: "${WANMO_API_KEY}"

配置修改后运行：

openclaw config validate
openclaw doctor

如果 OpenClaw 提示配置无效，先修正配置再启动 Gateway。OpenClaw 对配置 schema 校验比较严格，未知字段、字段类型错误或 JSON5 语法错误都可能导致 Gateway 拒绝启动。

#第五步：启动并验证 Gateway

确认 Gateway 正在运行：

openclaw gateway status

正常情况下，你会看到 Gateway 正在监听本地端口，默认是 18789。

打开控制台 UI：

openclaw dashboard

也可以直接访问：

http://127.0.0.1:18789

进入 Control UI 后，检查模型 provider 是否显示 wanmoapi，默认模型是否为 wanmoapi/gpt-5.4-mini 或你配置的模型。

#第六步：发送第一条测试消息

在 OpenClaw 的聊天窗口发送：

你好，用一句话介绍你自己。

成功标志：

• OpenClaw 能返回模型回复。
• 万模API控制台调用日志出现请求。
• 日志中的模型名与你配置的模型一致。
• 如果能看到路径，OpenAI Chat 兼容请求通常会落到 /v1/chat/completions。

如果 OpenClaw 页面有回复，但万模API控制台没有日志，说明请求没有打到万模API，优先检查 Base URL、provider 是否启用、默认模型引用是否还是别的 provider。

#第七步：决定本机运行还是云服务器运行

OpenClaw 可以运行在个人电脑，也可以运行在云服务器。两种方式的目标不同。

如果你只是第一次接入万模API，建议先本机跑通 Dashboard。确认模型、Key、日志都正常后，再迁移到云服务器长期运行。

云服务器长期运行时建议：

• 使用单独的万模API令牌，并设置额度上限。
• 只开放必要端口，不要把 18789 直接暴露到公网。
• 使用系统服务、Docker、反向代理或平台托管时，确认环境变量 WANMO_API_KEY 能被 OpenClaw 进程读取。
• 备份 ~/.openclaw/openclaw.json 和必要状态文件，但不要把包含明文 Key 的配置提交到 Git。
• 开启 IM 渠道前，先用 Dashboard 验证模型。

#第八步：接入消息渠道

OpenClaw 的价值不只在本地网页聊天，还可以接入 Telegram、Feishu、Discord、Slack、WhatsApp 等渠道。建议先在 Control UI 本地跑通模型，再接消息渠道。

以飞书为例，配置前需要先在飞书开放平台准备应用，并拿到：

OpenClaw 渠道配置一般在 channels.<provider> 下维护。不同渠道字段差异较大，建议在 OpenClaw 官方渠道页面确认最新字段，再填写到 Control UI 或 openclaw.json。

安全建议：

• 第一次接入 IM 时，只允许自己的账号或测试群。
• 不要一开始就开放所有群聊。
• 如果渠道支持配对码，使用配对流程批准用户。
• 给 OpenClaw 的万模API令牌设置额度上限。

#推荐配置顺序

不要把“模型 provider 没跑通”和“飞书/Telegram 没接通”放在一起排查。先让 Dashboard 能聊天，再处理消息渠道。

#进阶：Responses 和 Claude 协议怎么选

万模API支持多种协议，但 OpenClaw 自定义 provider 里要让协议和模型能力一致。

如果你只是第一次跑通 OpenClaw，优先使用 openai-completions 和 Chat 模型。等本地 Gateway、Dashboard 和 IM 渠道都稳定后，再尝试 Responses 或 Claude 协议。

#常见问题

#安装脚本卡住或下载失败

检查网络是否能访问 GitHub、npm registry 和 openclaw.ai。如果公司网络限制较多，可以换到 WSL2、云服务器或手动 npm 安装方式。

#openclaw 命令找不到

关闭并重新打开终端。仍然找不到时，检查 Node 全局包路径是否在 PATH 中。Windows 用户确认自己运行命令的环境和安装环境一致，例如不要在 WSL 安装后到 PowerShell 里运行。

#Gateway 启动失败

先运行：

openclaw doctor
openclaw config validate
openclaw logs

常见原因是 ~/.openclaw/openclaw.json 有语法错误、字段名写错、api 值不在支持列表里，或者环境变量 ${WANMO_API_KEY} 没有实际设置。

#401 unauthorized

检查：

• API Key 是否完整复制。
• Key 是否属于万模API控制台。
• 是否把 sk-... 写成了带空格或换行。
• 配置文件里 ${WANMO_API_KEY} 是否能被 OpenClaw 进程读到。

#model not found

检查：

• models.providers.wanmoapi.models[].id 是否等于控制台模型名。
• agents.defaults.model.primary 是否写成 wanmoapi/<模型ID>。
• 令牌所属分组是否允许使用该模型。
• 是否把 Responses 模型当 Chat 模型接入，或把 Claude 模型放在 openai-completions 下。

#请求没有出现在万模API日志

通常说明 OpenClaw 没有使用 wanmoapi provider。检查默认模型、模型选择器、agent 配置和 fallback 模型。必要时先只保留一个 wanmoapi provider 和一个模型，排除其它 provider 干扰。

#IM 渠道收不到消息

先确认 Dashboard 本地聊天可用。如果 Dashboard 可用，再检查 IM 平台的事件订阅、机器人权限、App Secret、WebSocket/回调地址和配对审批。不要在模型还没跑通时排查 IM。

#消耗异常偏高

OpenClaw 可能会在一个任务中多次调用模型、读取上下文或执行工具。建议：

• 给 OpenClaw 单独 Key。
• 设置额度上限。
• 第一次只允许测试用户。
• 不要开放不必要的工具。
• 查看万模API调用日志定位具体模型和调用次数。

#下一步

• 先验证 Key 和模型：三件套与第一个请求。
• 不确定协议：看协议选择指南。
• 查看扣费：看计费说明。
• 请求失败：看常见问题排查。

#参考资料

• OpenClaw 官方入门指南：https://docs.openclaw.ai/zh-CN/start/getting-started
• OpenClaw 官方安装说明：https://docs.openclaw.ai/zh-CN/install
• OpenClaw 官方自定义 provider 配置：https://docs.openclaw.ai/zh-CN/gateway/config-tools