OpenClaw 配置指南 | LLMoxy 文档

网址：https://openclaw.ai/（官网单击跳转！）

源码地址

国外：GitHub openclaw/openclaw
国内：Gitee OpenClaw-CN/openclaw-cn

国内地址为 OpenClaw 中文社区仓库，适合 GitHub 访问不稳定时查看源码和文档。需要提交 Issue 或参与上游开发时，优先使用 GitHub 官方仓库。

⚠️ 注意 因为 Clawdbot 改名，有些插件 SDK 安装的时候注意如果安装失败，注意要改成 OpenClaw

配置文件下载

openclaw.json（点击下载完整配置文件 - Windows版）

openclaw.json（点击下载完整配置文件 - Mac版）

阿里云配置教程

📖 官方文档 阿里云官方配置教程： https://help.aliyun.com/zh/model-studio/openclaw

配置 JSON 文件

使用以下 JSON 配置模板，替换教程中的文本为下方文本，并替换自己的密钥：

"models": {
  "providers": {
    "claude": {
      "baseUrl": "https://llmoxy.com",
      "apiKey": "sk-xxxxxxx秘钥",
      "api": "anthropic-messages",
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "claude-opus-4-6",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
},
"agents": {
  "defaults": {
    "model": {
      "primary": "claude/claude-opus-4-6"
    },
    "models": {
      "claude/claude-opus-4-6": {
        "alias": "claude-opus-4-6"
      }
    }
  }
}

配置说明：

将 sk-xxxxxxx秘钥替换为您从 LLMoxy 网站获取的实际令牌

baseUrl 使用 https://llmoxy.com

api 协议选择 anthropic-messages

模型使用 claude-opus-4-6

腾讯云配置教程

在自定义服务器里面选择自定义模型配置

打开 OpenClaw，进入自定义服务器设置，选择自定义模型配置选项。

选择自定义模型配置

配置自定义 JSON 文件

使用以下 JSON 配置模板：

{
  "provider": "openai",
  "base_url": "https://llmoxy.com",
  "api": "anthropic-messages",
  "api_key": "<LLMOXY_API_KEY>x",
  "model": {
    "id": "claude-opus-4-6",
    "name": "claude-opus-4-6"
  }
}

通用配置模板

如果需要其他模型，可以使用以下通用模板接入任何兼容 OpenAI/Anthropic (openai-completions/anthropic-messages) 协议的模型：

{
  "provider": "openai",
  "base_url": "https://llmoxy.com",
  "api": "anthropic-messages",
  "api_key": "<LLMOXY_API_KEY>x",
  "model": {
    "id": "claude-opus-4-6",
    "name": "claude-opus-4-6"
  }
}

参数说明：

provider: 提供商名称（可自定义）

base_url: API 接入点

api: API 协议类型（openai-completions 或 anthropic-messages）

api_key: 您的 LLMoxy 令牌

model.id: 模型标识符

model.name: 模型显示名称

一、本地部署

安装 Node.js

访问 nodejs.org 下载 LTS 长期支持版（稳定性强，适合开发/生产环境）。页面会自动识别你的系统，直接点下载按钮就行。

💡 Node.js 安装包自带 npm（包管理器），不用单独下载。

安装 Git

访问 git-scm.com 下载安装。Windows 建议选 64 位版本，安装时默认选项基本够用。

验证安装

安装完成后，打开命令行（Windows 用 CMD/PowerShell，Mac/Linux 用终端），分别输入以下命令，能显示版本号就是安装成功：

node -v
npm -v

安装 OpenClaw

npm i -g openclaw

二、核心配置流程

定位配置文件

OpenClaw 的配置在 openclaw.json中。请根据您的操作系统找到它：

操作系统	默认路径
Windows	`C:\Users\<Your_Username>\.openclaw\openclaw.json`
macOS / Linux	`~/.openclaw/openclaw.json`

添加自定义 Provider（关键步骤）

在配置文件中，将以下 JSON 代码片段加入到 models.providers块中。根据您的需求选择配置：

"models": {
  "providers": {
    "claude": {
      "baseUrl": "https://llmoxy.com",
      "apiKey": "sk-xxxxxx你的 LLMoxy API Key",
      "api": "anthropic-messages",
      "models": [
        {
          "id": "claude-opus-4-6",
          "name": "claude-opus-4-6",
          "reasoning": false,
          "input": ["text"],
          "cost": {
            "input": 0,
            "output": 0,
            "cacheRead": 0,
            "cacheWrite": 0
          },
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

添加 agents.defaults（关键步骤）

还需要告知 OpenClaw 优先使用该节点。根据上面选择的 Provider 配置对应的 defaults：

"agents": {
  "defaults": {
    "model": {
      "primary": "claude/claude-opus-4-6"
    },
    "models": {
      "claude/claude-opus-4-6": {
        "alias": "claude-opus-4-6"
      }
    }
  }
}

配置文件下载

在配置文件中，将以下 JSON 代码片段加入到 models.providers块中：

📦 openclaw.json（点击下载完整配置文件 - Windows版）

📦 openclaw.json（点击下载完整配置文件 - Mac版）

三、启动服务

启动网关服务

openclaw gateway

打开链接

还需要告知 OpenClaw 优先使用该节点：

URL: http://localhost:18789

💡 提示 请使用 auto 分组的令牌。详细配置步骤请观看上方视频教程。

环境变量配置（替代方案）

如果不使用 CC-Switch 或配置文件，可以直接设置环境变量。

OpenClaw 地址带 /v1。

[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL","https://llmoxy.com/v1","User")
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY","你的LLMoxy API Key","User")

关闭 PowerShell，重新打开一个新窗口，然后验证：

echo $env:OPENAI_BASE_URL

应显示： https://llmoxy.com/v1

~/.zshrc是 macOS 的 Shell 配置文件，每次打开终端都会自动加载。下面的命令会自动创建（如果不存在）并追加配置，直接复制粘贴到终端运行即可。

{
echo ''
echo '# LLMoxy (OpenClaw)'
echo 'export OPENAI_BASE_URL="https://llmoxy.com/v1"'
echo 'export OPENAI_API_KEY="你的LLMoxy API Key"'
} >> ~/.zshrc

使配置生效：

source ~/.zshrc

验证：

echo "$OPENAI_BASE_URL"

应显示： https://llmoxy.com/v1

不确定自己用的是哪个 Shell？运行 echo $SHELL，看到 /bin/bash就是 Bash，看到 /bin/zsh就是 Zsh。

~/.bashrc（Bash）和 ~/.zshrc（Zsh）是 Shell 配置文件，每次打开终端都会自动加载。下面的命令会自动创建（如果不存在）并追加配置，直接复制粘贴运行即可。

Bash 用户 （大部分 Linux 默认）：

{
echo ''
echo '# LLMoxy (OpenClaw)'
echo 'export OPENAI_BASE_URL="https://llmoxy.com/v1"'
echo 'export OPENAI_API_KEY="你的LLMoxy API Key"'
} >> ~/.bashrc

Zsh 用户：

{
echo ''
echo '# LLMoxy (OpenClaw)'
echo 'export OPENAI_BASE_URL="https://llmoxy.com/v1"'
echo 'export OPENAI_API_KEY="你的LLMoxy API Key"'
} >> ~/.zshrc

使配置生效：

source ~/.bashrc # Bash 用户
# 或
source ~/.zshrc # Zsh 用户

你必须将 你的LLMoxy API Key替换为从 LLMoxy 控制台复制的真实 Key。

推荐为 OpenClaw 单独创建一把 Key，避免与个人工具混用。