OpenClaw ​

说明

订阅套餐（Token Plan / Coding Plan）专属 API Key 仅限在 AI 编程工具中使用，不可用于 API 调试、工作流平台等非交互式场景。Key 与 Base URL 请参见 快速开始 → 接入方式一览。

步骤一: 在模型API服务中创建API Key ​

1. 打开 模型API 服务页面。 ​

image1.png

2. 创建API Key。 ​
：服务类型请选择模型。

image2.png

3. 复制保存API Key。 ​

点击复制，并将它们保存到安全的地方（例如记事本）。

image3.png

步骤二: OpenClaw配置SCNet模型API Key（方案一） ​

1. 粘贴您的模型API Key到下列配置中。 ​

可以在 模型列表 查看SCNet平台提供的模型名称。
找到以下位置，补充必要的信息，如baseUrl、apiKey、api等。

json
"models": {
    "mode": "merge",
    "providers": {
      "scnet": {
      "baseUrl": "https://api.scnet.cn/api/llm/v1",
      "apiKey": "您的模型API Key",
      "api": "openai-completions",
      "models": [
        {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 196608,
            "maxTokens": 8192
        }
      ]
    }
  }
},

以及如下位置，修改primary为相应的模型名称

json
"agents": {
    "defaults": {
      "model": {
        "primary": "scnet/MiniMax-M2.5"
      },
      "models": {
        "scnet/MiniMax-M2.5": {}
      },
      "workspace": "~/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

重要说明：

  • baseUrl: API 基础地址，不要包含 /chat/completions 路径
  • apiKey: 您的 API 密钥
  • id: 模型 ID，与 API 请求中的 model 字段一致
  • name: 模型名称
  • contextWindow: 上下文窗口大小
  • maxTokens: 最大输出 tokens
2. 打开OpenClaw的Config页面，选择Raw方式。 ​

image4.png

3. 修改保存配置 ​

根据2.1步骤中的配置项修改OpenClaw的Config。并依次点击Save、Reload按钮保存配置。

image5.png

步骤二: OpenClaw配置SCNet模型API Key（方案二） ​

在OpenClaw会话框里输入以下提示词，OpenClaw会自动添加模型：

text
帮我添加一下模型：
baseUrl: https://api.scnet.cn/api/llm/v1
apiKey: 您的模型API Key
api: openai-completions
模型ID：MiniMax-M2.5

image5.png

步骤三: 模型对话 ​

image6.png

方式一：在界面中配置 ​

openclaw.png

  1. 登录并打开 OpenClaw。
  2. 进入模型或提供商配置页面。
  3. 新增一个自定义模型服务，或在已有服务中编辑接入参数。
  4. 填写以下信息：
    • API Key：sk-tp-xxxxxxxx
    • Base URL：https://api.scnet.cn/api/llm/v1
    • Model：填写套餐内可用模型名称
  5. 保存配置后，在模型列表中选择对应模型开始使用。

方式二：通过本地配置文件接入 ​

若使用本地部署的 OpenClaw，可在配置文件中设置模型提供方与模型映射。配置文件通常位于：

text
~/.openclaw/openclaw.json

参考配置如下：

json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "scnet/MiniMax-M2.5"
      },
      "models": {
        "scnet/MiniMax-M2.5": {
          "alias": "SCNet MiniMax-M2.5"
        }
      }
    }
  }
}

如需进一步配置提供方、鉴权方式或模型目录，请结合 OpenClaw 当前版本的配置方式补充对应字段。

常见问题 ​

  • 保存后模型不可选：请检查模型名称是否填写正确。
  • 请求失败：请检查 API Key 是否误用了通用 Key 或 Coding Plan Key，或 Base URL 是否填写错误。
  • 工具无自定义入口：请确认当前版本是否支持自定义模型服务接入。