在OpenClaw中使用MaaS模型API

在软件开发过程中，开发者经常面临代码编写效率低、调试困难等问题。OpenClaw是一款开源的个人AI助手平台，通过接入大模型可帮助开发者高效完成代码开发、调测。然而，如何将这些先进的AI能力快速集成到现有的开发环境中，成为了一个新的挑战。您可通过简单配置，把MaaS模型API接入OpenClaw，从而轻松实现AI能力的集成，提高开发效率。本文档旨在帮助开发者快速配置并高效、安全地在OpenClaw环境中集成MaaS模型的API。

前提条件

已注册华为云账号，并进行实名认证。具体操作，请参见注册华为账号并开通华为云和实名认证。
已开通预置服务，或已创建接入点。具体操作，请参见开通预置服务或创建自定义接入点。

计费说明

在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见MaaS文本生成模型。

约束限制

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

步骤一：安装OpenClaw

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

node --version # 运行该命令可验证Node.js版本

在命令行界面中执行以下命令，安装OpenClaw。
```
iwr -useb https://openclaw.ai/install.ps1 | iex
```
或通过npm全局安装：
```
npm install -g openclaw@latest
```

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

node --version #运行该命令可验证Node.js版本

执行以下命令，安装OpenClaw。

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

或通过npm全局安装：

npm install -g openclaw@latest

步骤二：完成初始配置（首次安装）

表1 OpenClaw配置
配置类型	配置项	配置示例
基本配置	I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?	选择 "Yes"
基本配置	Setup mode	选择 “QuickStart”
模型配置	Model/auth provider	选择 "Skip for now"，后续可以配置。
	Filter models by provider	选择 "All providers"
	Default model	使用默认配置
功能配置	Select channel (QuickStart)	选择 “Skip for now”，后续可以配置。
	Search provider	选择 “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中接入MaaS模型API

请按需选择以下操作。

在终端执行以下命令，打开OpenClaw Web UI。
```
openclaw dashboard
```

在Web UI的左侧菜单栏中选择“配置 > RAW（或Config > RAW）”，查看并修改配置信息。

表2 配置参数说明
参数	说明
baseUrl	https://api.modelarts-maas.com/v2
apiKey	获取API Key。
models	支持的模型及model参数值，请参见支持模型。

首次配置：复制以下内容到Raw JSON5输入框，替换已有内容。

{
    "models": {
        "providers": {
            "hw-maas-pan": {
                "baseUrl": "https://api.modelarts-maas.com/v2",
                "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,
                         "input": [
                            "text"
                         ]
                    }
                ]
            }
        }
    },
    "agents": {
        "defaults": {
            "model": {
                "primary": "hw-maas-pan/glm-5"
            },
            "models": {
                "hw-maas-pan/glm-5": {},
                "hw-maas-pan/deepseek-v3.2": {}
            }
        }
    },
    "gateway": {
        "mode": "local"
    }
}

已有配置：如果您已经配置过OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。

配置完成后，单击右上角“Save”保存，然后单击“Update”使配置生效。
保存成功后，apiKey将显示为“__OPENCLAW_REDACTED__”。仅用于前端界面隐藏，不影响实际调用。

在终端编辑openclaw.json配置文件。
```
cat ~/.openclaw/openclaw.json
```

按下表修改配置信息。

首次配置：复制以下内容到配置文件。

{
    "models": {
        "providers": {
            "hw-maas-pan": {
                "baseUrl": "https://api.modelarts-maas.com/v2",
                "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,
                        "input": [
                            "text"
                        ]
                    }
                ]
            }
        }
    },
    "agents": {
        "defaults": {
            "model": {
                "primary": "hw-maas-pan/glm-5"
            },
            "models": {
                "hw-maas-pan/glm-5": {},
                "hw-maas-pan/deepseek-v3.2": {}

            }
        }
    },
    "gateway": {
        "mode": "local"
    }
}

已有配置：如果您已经配置过OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。

保存文件并退出，执行以下命令使配置生效。
```
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字段为目标模型，请参考步骤二：完成初始配置。修改示例如下：
```
{
    "agents": {
        "defaults": {
            "model": {
                "primary": "hw-maas-pan/glm-5"
            }
        }
    }
}
```
OpenClaw会话效果如图所示：

常见问题

OpenClaw如何开启深度思考模式？

OpenClaw支持设置的深度思考level：off、minimal、low、medium、high、xhigh。具体参见 Thinking Levels。

有三种方式：

方式一：在消息前面添加内联指令：/think:<level> 或/t <level>，示例如下：
```
/think:high 你的问题
# 或者使用简写模式
/t high 你的问题
```
方式二：在会话级别开启深度思考模式，单独发送一条指令：/think:<level> 或/t <level>，示例如下：
```
/think:high
# 或者使用简写模式
/t high
```
方式三：全局设置开启深度思考模式。使用 config 命令修改全局配置：openclaw config set agents.defaults.thinkingDefault <level>，示例如下：
```
openclaw config set agents.defaults.thinkingDefault high
# 重启 gateway 才能生效
openclaw gateway restart
# 查看配置是否生效
openclaw config get agents.defaults.thinkingDefault
```
执行openclaw gateway restart命令后，显示“Gateway service disabled”，如何处理？
执行如下命令，手动启动gateway服务。启动成功之后会回显如下图所示信息：
```
openclaw gateway
```