跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 是一个适用于 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等更多平台的任意操作系统 AI 智能体 Gateway 网关。这篇文档会带你把 LLMEasy 接入 OpenClaw，并完成基础验证。

​
安装 OpenClaw

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

​
安装接入

你可以直接运行 LLMEasy 提供的自动配置脚本。运行前请准备好 LLMEasy API Key。脚本需要 Node.js。如果你没有显式传入 API Key 或模型，脚本会按工具能力提示你交互输入。脚本执行完成后，请继续看下方“运行生效”。按你的操作系统执行对应步骤。你只需要执行其中一项。
1

如果你使用 macOS / Linux

curl -fsSL https://www.llmeasy.ru/install-openclaw-provider.sh | bash
2

如果你使用 Windows

iwr https://www.llmeasy.ru/install-openclaw-provider.ps1 -OutFile "$env:TEMP\install-openclaw-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-openclaw-provider.ps1"

​
多 Agent 与已有会话的注意事项

OpenClaw 中模型生效的优先级通常是： session override > agents.list[*].model > agents.defaults.model.primary 这意味着：
  • 如果某个 agent 在 agents.list 里显式写了 model，它不会继承全局默认模型。
  • 如果你把 LLMEasy 设为全局默认模型，但 main 仍写着旧模型，那么 Discord 私聊等默认走 main 的场景仍会继续使用旧模型。
  • 如果历史会话里残留了 providerOverride、modelOverride 或 authProfileOverride，即使你已经修改了默认模型，当前会话也可能继续使用旧渠道。
推荐做法：
  1. 想让 main 跟随全局默认时，不要给 main 单独写 model，或者把它改成 LLMEasy。
  2. 修改配置后执行 openclaw gateway restart。
  3. 在 Discord 中执行 /new 新开会话。
  4. 再用 /status 和 /model 验证当前生效模型。

​
最小配置示例

provider id 以 openclaw models list 的实际输出为准。下面用 llmeasy/gpt-5.4 举例；如果你的 provider id 不同，请按实际值替换。 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "llmeasy/gpt-5.4",
        "fallbacks": []
      },
      "models": {
        "llmeasy/gpt-5.4": {
          "alias": "llmeasy"
        }
      }
    },
    "list": [
      {
        "id": "main"
      },
      {
        "id": "fitness-coach"
      },
      {
        "id": "trade-recorder",
        "model": {
          "primary": "llmeasy/gpt-5.4",
          "fallbacks": []
        }
      }
    ]
  }
}
  • main 没写 model，所以会继承全局 LLMEasy。
  • trade-recorder 写了 model，所以它不会跟随全局默认变化。

​
运行生效

如果你在旧版 OpenClaw 上遇到 /model picker 不稳定、热刷新不及时或模型列表异常，先升级到最新版再排查。
1

先做配置层验证

运行以下命令，确认 LLMEasy provider 和默认模型已经写入配置：
openclaw models list
openclaw models status
2

重载服务

openclaw gateway restart
3

新开会话

在 Discord 中执行 /new。
4

验证当前会话实际模型

在 Discord 中执行 /status，确认当前 Agent / 当前会话已经切到 LLMEasy。
5

按需检查可选模型列表

在 Discord 中执行 /model。如果这里看不到 LLMEasy，优先检查：
  • 当前模型是否已加入 agents.defaults.models
  • provider 下该模型的显示名是否正常，必要时是否已在 agents.defaults.models 中添加 alias
  • 是否已经执行过 openclaw gateway restart
  • 是否已经通过 /new 新开会话

​
排障提示

  • 默认模型改了但实际仍是旧模型，优先检查 agents.list.main.model
  • /model 看不到 LLMEasy，优先检查它是否在 agents.defaults.models 中
  • 改完配置后 Discord 里仍是旧结果，先执行 openclaw gateway restart，再执行 /new
  • 如果模型 picker 或热刷新仍不稳定，先升级到最新版 OpenClaw 再排查

​
让 Codex 帮你兜底配置

如果你不想手动改配置，可以先在终端里设置 API Key 环境变量，然后启动 Codex： 
export LLMEASY_API_KEY="YOUR_API_KEY"
codex
然后把下面这段 prompt 发给 Codex： 
请帮我检查并修复本机 OpenClaw 的 LLMEasy 配置。要求：
1. 先读取当前 OpenClaw 配置，确认 provider id、默认模型，以及 agents.list 中哪些 agent 显式写了 model。
2. 如果 LLMEasy provider 不存在，就新增一个指向 Base URL `https://www.llmeasy.ru/v1` 的 provider，并写入 `api: "openai-responses"`。
3. 优先复用 OpenClaw 已保存的认证信息。只有当当前版本或你的上游网关明确要求额外 headers 时，才单独配置；不要默认把 `User-Agent` 当作 LLMEasy 必填项。
4. 把默认模型切到 LLMEasy，并检查 `main` 是否被显式 model 覆盖；如果我希望 `main` 跟随全局默认，就删除它的显式 model。
5. 确保当前 LLMEasy 模型出现在 `agents.defaults.models` 中，并补一个易识别的 `alias`。
6. 备份原配置，使用最小 diff 修改，修改前先告诉我会改哪些字段。
7. 修改后执行 `openclaw gateway restart`，最后提醒我在 Discord 里依次执行 `/new`、`/status`、`/model` 做验证。

约束：
- 如果需要 API Key，请从环境变量 `LLMEASY_API_KEY` 读取，不要把密钥写进聊天或日志。
- 如果当前配置里没有 LLMEasy 模型，请先提示我从 LLMEasy 模型广场提供一个 Codex 分组模型 ID。