更新时间:2026-06-04 GMT+08:00
分享

OpenClaw

OpenClaw是一个开源的个人AI助手,能够连接到多种消息平台。通过Token Plan等渠道,用户可以配置并使用MaaS平台上的模型。

前提条件

已订阅MaaS Token Plan套餐。具体操作,请参见快速开始

约束限制

该功能仅支持“西南-贵阳一”区域。

核心配置

接入工具的核心参数如下:

核心参数

说明

Model Name

在工具配置文件中指定Model Name,可实时切换模型。支持配置的Model Name:

  • GLM-5
  • GLM-5.1
  • Kimi-K2.6
  • DeepSeek-V3.2
  • DeepSeek-V4-Flash

配置Model Name时,支持使用全小写格式。

Base URL

兼容OpenAI接口协议工具:https://api.modelarts-maas.com/plan/v2/chat/completions

注意:

如未使用指定的专属Base URL,将无法使用Token Plan额度,并可能产生额外API请求的费用。

API Key

获取API Key

步骤一:安装OpenClaw

  1. 安装Node.js 22或更高版本

    您可以在终端执行node -v命令,查看Node.js的版本。如果提示“找不到命令”,说明未安装;如果显示版本号低于v22.0,说明需要更新。

  2. 在命令行界面,执行以下命令安装OpenClaw。
    • macOS/Linux
      curl -fsSL https://openclaw.ai/install.sh | bash
    • Windows

      以管理员身份打开CMD,执行以下命令安装OpenClaw。

      iwr -useb https://openclaw.ai/install.ps1 | iex
  3. 根据提示信息完成OpenClaw配置,参考配置如下:

    类型

    提示信息

    配置内容

    基本配置

    I understand this is powerful and inherently risky. Continue?

    选择 ”Yes”。

    Onboarding mode

    选择 “QuickStart”。

    模型配置

    Model/auth provider

    选择 “Skip for now”,后续可以配置。

    Filter models by provider

    选择 “All providers”。

    Default model

    使用默认配置。

    功能配置

    Select channel (QuickStart)

    选择 “Skip for now”,后续可以配置。

    Configure skills now? (recommended)

    选择 “No”,后续可以配置。

    Enable hooks?

    按空格键选中 “Skip for now”,按回车键进入下一步。

    How do you want to hatch your bot?

    选择 “Hatch in TUI”。

步骤二:在OpenClaw中配置Token Plan

请按需选择以下操作。

  • Web UI方式
    1. 在终端执行以下命令,打开OpenClaw Web UI。
      openclaw dashboard
    2. 在Web UI的左侧菜单栏中选择配置 > RAW(或Config > RAW),查看并修改配置信息。
      • 首次配置:复制以下内容到Raw JSON5输入框,替换已有内容。
        {
            "models": {
                "providers": {
                    "hw-maas-pan": {
                        "baseUrl": "https://api.modelarts-maas.com/plan/v2/chat/completions",
                        "apiKey": "<API_KEY>",
                        "api": "openai-completions",
                        "models": [
                            {
                                "id": "glm-5",
                                "name": "glm-5",
                                "contextWindow": 64000,
                                "maxTokens": 64000,
                                "input": [
                                    "text"
                                ]
                            },
                            {
                                "id": "deepseek-v3.2",
                                "name": "deepseek-v3.2",
                                "contextWindow": 32000,
                                "maxTokens": 32000
                            },
                            {
                                "id": "kimi-k2",
                                "name": "kimi-k2",
                                "contextWindow": 32000,
                                "maxTokens": 32000,
                                "input": [
                                    "text"
                                ]
                            }
                        ]
                    }
                }
            },
            "agents": {
                "defaults": {
                    "model": {
                        "primary": "hw-maas-pan/glm-5"
                    },
                    "models": {
                        "hw-maas-pan/glm-5": {},
                        "hw-maas-pan/deepseek-v3.2": {},
                        "hw-maas-pan/kimi-k2": {}
                    }
                }
            },
            "gateway": {
                "mode": "local"
            }
        }
      • 已有配置:如果您已经配置过OpenClaw,请勿直接覆盖原有配置,建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。
    3. 配置完成后,单击右上角Save保存,然后单击Update使配置生效。

      保存成功后,apiKey将显示为“__OPENCLAW_REDACTED__”。仅用于前端界面隐藏,不影响实际调用。

  • 终端方式
    1. 在终端编辑openclaw.json配置文件。
    2. 修改配置信息。
      • 首次配置:复制以下内容到配置文件。
        {
            "models": {
                "providers": {
                    "hw-maas-pan": {
                        "baseUrl": "https://api.modelarts-maas.com/plan/v2/chat/completions",
                        "apiKey": "<API_KEY>",
                        "api": "openai-completions",
                        "models": [
                            {
                                "id": "glm-5",
                                "name": "glm-5",
                                "contextWindow": 64000,
                                "maxTokens": 64000,
                                "input": [
                                    "text"
                                ]
                            },
                            {
                                "id": "deepseek-v3.2",
                                "name": "deepseek-v3.2",
                                "contextWindow": 32000,
                                "maxTokens": 32000
                            },
                            {
                                "id": "kimi-k2",
                                "name": "kimi-k2",
                                "contextWindow": 32000,
                                "maxTokens": 32000,
                                "input": [
                                    "text",
                                    "image"
                                ]
                            }
                        ]
                    }
                }
            },
            "agents": {
                "defaults": {
                    "model": {
                        "primary": "hw-maas-pan/glm-5"
                    },
                    "models": {
                        "hw-maas-pan/glm-5": {},
                        "hw-maas-pan/deepseek-v3.2": {},
                        "hw-maas-pan/kimi-k2": {}
                    }
                }
            },
            "gateway": {
                "mode": "local"
            }
        }
      • 已有配置:如果您已经配置过OpenClaw,请勿直接覆盖原有配置,建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。
    3. 保存文件并退出,执行以下命令使配置生效。
      openclaw gateway restart

步骤三:使用OpenClaw

您可以任选以下方式使用OpenClaw。

  • Web UI:

    新开一个终端,执行以下命令,浏览器将自动打开OpenClaw的操作界面(Web UI),然后在Web UI中开始对话。

    openclaw dashboard
  • TUI:

    新开一个终端,执行以下命令,进入TUI界面,然后开始对话。

    openclaw tui

切换模型

支持的模型信息参见核心配置

  • 在当前会话切换模型(临时有效)

    在终端输入openclaw tui,进入TUI界面,使用/model <模型名称>在当前会话中切换模型。修改示例如下:

    /model hw-maas-pan/glm-5

    界面返回提示“model set to <模型名称>” ,表示生效。

  • 切换默认模型(永久有效)

    如需在每次新会话中使用指定模型,修改agents.defaults.model.primary字段为目标模型,请参考步骤二:在OpenClaw中配置Token Plan。修改示例如下:

    {
        "agents": {
            "defaults": {
                "model": {
                    "primary": "hw-maas-pan/glm-5"
                }
            }
        }
    }

相关文档