XylemNode

接入指南

OpenClaw

自托管的 AI 网关，把 Telegram、Discord、Slack 等聊天入口接到编码代理；模型来源可自定义，填成 XylemNode 即可。

获取 API Key
官网 / 下载
  1. 01

    安装

    用 npm 全局安装（建议 Node 22.14 以上）。装完先跑一次 openclaw setup 做基础初始化，再看版本号确认。

    npm install -g openclaw
openclaw --version
  2. 02

    找到配置文件

    OpenClaw 的配置集中在一个 JSON5 文件里（支持注释和尾逗号）。文件不存在就先跑 openclaw setup 生成；想换位置可用 OPENCLAW_CONFIG_PATH 指定。

    Windows
    %USERPROFILE%\.openclaw\openclaw.json
    macOS
    ~/.openclaw/openclaw.json
    Linux
    ~/.openclaw/openclaw.json
  3. 03

    写入服务商配置

    把 XylemNode 加成一个模型来源，并设为默认模型。baseUrl 走 OpenAI 兼容格式、要带 /v1；api 固定填 openai-completions；密钥可直接写，也可用 ${环境变量} 引用。

    {
  "agents": {
    "defaults": {
      "model": { "primary": "xylemnode/gpt-5.6-sol" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "xylemnode": {
        "baseUrl": "https://api.xylemnode.com/v1",
        "apiKey": "sk-你的密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.6-sol", "name": "GPT-5.6 Sol" }
        ]
      }
    }
  }
}
  4. 04

    重启网关并验证

    改完配置重启网关让它生效，再列一下模型确认 XylemNode 已加载；openclaw doctor 可帮你体检配置。

    openclaw gateway restart
openclaw models list

# 体检配置
openclaw doctor

配置提醒

其一，baseUrl 必须带 /v1、api 固定填 openai-completions，这是 OpenAI 兼容格式的硬性要求。 其二，单个字段也可以用命令改，如 openclaw config set models.providers.xylemnode.baseUrl "…"；但 models 数组只能在文件里手动加。

常见问题

OpenClaw 报 No API provider registered，或改了地址和密钥却不生效？

这是两个独立的坑。第一个是配置写漏了：provider 块少了 api 字段，它会抛 No API provider registered for api: undefined——仓库里专门有 issue 抱怨这个报错不告诉你缺什么。自定义服务商必须写全 api: "openai-completions"，并且 models 外层要有 mode: "merge"。第二个更隐蔽：agent 首次运行会把服务商落到 ~/.openclaw/agents/<agentId>/agent/models.json，而 merge 模式下这份文件里已有的 apiKey 和 baseUrl 会被无条件保留，你后来在全局 openclaw.json 里改的新值传不进去，表现就是莫名其妙的 401——已有 issue 定位到这段合并逻辑。把对应 agent 目录下的 models.json 删掉、让它按新配置重新生成即可。另外别指望环境变量：有反馈称内置 agent 不读 OPENAI_BASE_URL 这类变量，配置只认配置文件。