# OpenClaw 在软件开发过程中，开发者经常面临代码编写效率低、调试困难等问题。OpenClaw是一款开源的个人AI助手平台，通过接入大模型可帮助开发者高效完成代码开发、调测。然而，如何将这些先进的AI能力快速集成到现有的开发环境中，成为了一个新的挑战。您可通过简单配置，把MaaS模型API接入OpenClaw，从而轻松实现AI能力的集成，提高开发效率。本文档旨在帮助开发者快速配置并高效、安全地在OpenClaw环境中集成MaaS模型的API。 #### 前提条件 - 已注册华为云账号，并进行实名认证。具体操作，请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。 - 已开通预置服务，或已创建接入点。具体操作，请参见[开通预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html)或[创建自定义接入点](https://support.huaweicloud.com/model-call-maas/model-call-048.html)。 #### 计费说明 在调用MaaS模型服务时，将根据实际使用的Tokens数量进行计费。计费详情请参见[MaaS文本生成模型](https://support.huaweicloud.com/price-maas/price-maas-0002.html)。 #### 约束限制 该功能仅支持"西南-贵阳一"区域。 #### 步骤一：安装OpenClaw 安装OpenClaw包括Windows以及MacOS/Linux两种方式。 - [Windows] 1. 安装[Node.js 22或更高版本](https://nodejs.org/en/download/)。 ``` node --version # 运行该命令可验证Node.js版本 ``` 2. 在命令行界面中执行以下命令，安装OpenClaw。 ``` iwr -useb https://openclaw.ai/install.ps1 | iex ``` 或通过npm全局安装： ``` npm install -g openclaw@latest ``` - [MacOS/Linux] 1. 安装[Node.js 22或更高版本](https://nodejs.org/en/download/)。 ``` node --version #运行该命令可验证Node.js版本 ``` 2. 执行以下命令，安装OpenClaw。 ``` curl -fsSL https://openclaw.ai/install.sh | bash ``` 或通过npm全局安装： ``` npm install -g openclaw@latest ``` #### 步骤二：完成初始配置（首次安装） 表1OpenClaw配置 | 配置类型 | 配置项 | 配置示例 | |:---|:---|:---| | 基本配置 | 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 请按需选择以下操作。 - [Web UI方式] 1. 在终端执行以下命令，打开OpenClaw Web UI。 ``` openclaw dashboard ``` 2. 在Web UI的左侧菜单栏中选择"配置 \> RAW（或Config \> RAW）"，查看并修改配置信息。 表2配置参数说明 | 参数 | 说明 | |:---|:---| | baseUrl | https://api.modelarts-maas.com/v2 | | apiKey | [获取API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 | | models | 支持的模型及model参数值，请参见[支持模型](https://support.huaweicloud.com/model-call-maas/model-call-021.html#section2)。 | - 首次配置：复制以下内容到Raw JSON5输入框，替换已有内容。 ``` { "models": { "providers": { "hw-maas-pan": { "baseUrl": "https://api.modelarts-maas.com/v2", "apiKey": "", "api": "openai-completions", "models": [ { "id": "glm-5.2", "name": "glm-5.2", "contextWindow": 64000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "deepseek-v4-flash", "name": "deepseek-v4-flash", "contextWindow": 96000, "maxTokens": 96000, "input": [ "text" ] } ] } } }, "agents": { "defaults": { "model": { "primary": "hw-maas-pan/glm-5.2" }, "models": { "hw-maas-pan/glm-5.2": {}, "hw-maas-pan/deepseek-v4-flash": {} } } }, "gateway": { "mode": "local" } } ``` - 已有配置：如果您已经配置过OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。 3. 配置完成后，单击右上角"Save"保存，然后单击"Update"使配置生效。 保存成功后，apiKey将显示为"__OPENCLAW_REDACTED__"。仅用于前端界面隐藏，不影响实际调用。 - [终端方式] 1. 在终端编辑openclaw.json配置文件。 ``` cat ~/.openclaw/openclaw.json ``` 2. 按下表修改配置信息。 表3配置参数说明 | 参数 | 说明 | |:---|:---| | baseUrl | https://api.modelarts-maas.com/v2 | | apiKey | [获取API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 | | models | 支持的模型及model参数值，请参见[支持模型](https://support.huaweicloud.com/model-call-maas/model-call-021.html#section2)。 | - 首次配置：复制以下内容到配置文件。 ``` { "models": { "providers": { "hw-maas-pan": { "baseUrl": "https://api.modelarts-maas.com/v2", "apiKey": "", "api": "openai-completions", "models": [ { "id": "glm-5.2", "name": "glm-5.2", "contextWindow": 64000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "deepseek-v4-flash", "name": "deepseek-v4-flash", "contextWindow": 96000, "maxTokens": 96000, "input": [ "text" ] } ] } } }, "agents": { "defaults": { "model": { "primary": "hw-maas-pan/glm-5.2" }, "models": { "hw-maas-pan/glm-5.2": {}, "hw-maas-pan/deepseek-v4-flash": {} } } }, "gateway": { "mode": "local" } } ``` - 已有配置：如果您已经配置过OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。 3. 保存文件并退出，执行以下命令使配置生效。 ``` openclaw gateway restart ``` #### 步骤四：使用OpenClaw 1. 您可以任选以下方式使用OpenClaw。 - **Web UI** ： 新开一个终端，执行以下命令，浏览器将自动打开OpenClaw的操作界面（Web UI），然后在Web UI中开始对话。 ``` openclaw dashboard ``` - **TUI** ： 新开一个终端，执行以下命令，进入TUI界面，然后开始对话。 ``` openclaw tui ``` 2. 切换模型 - **在当前会话切换模型（临时有效）** 在终端输入openclaw tui，进入TUI界面，使用/model \<模型名称\>在当前会话中切换模型。修改示例如下： ``` /model hw-maas-pan/glm-5.2 ``` 界面返回提示"model set to \<模型名称\>" ，表示生效。 - **切换默认模型（永久有效）** 如需在每次新会话中使用指定模型，修改agents.defaults.model.primary字段为目标模型，请参考[步骤二：完成初始配置]。修改示例如下： ``` { "agents": { "defaults": { "model": { "primary": "hw-maas-pan/glm-5.2" } } } } ``` 3. OpenClaw会话效果如图所示： ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002683504264.png "点击放大") #### 常见问题 - **OpenClaw如何开启深度思考模式？** ![](https://support.huaweicloud.com/model-call-maas/public_sys-resources/note_3.0-zh-cn.png) OpenClaw支持设置的深度思考level：off、minimal、low、medium、high、xhigh。具体参见 [Thinking Levels](https://docs.openclaw.ai/tools/thinking#thinking-levels)。 有三种方式： 方式一：在**消息**前面添加内联指令：/think:\ 或/t \，示例如下： ``` /think:high 你的问题 # 或者使用简写模式 /t high 你的问题 ``` 方式二：在**会话级别** 开启深度思考模式，单独发送一条指令：/think:\ 或/t \，示例如下： ``` /think:high # 或者使用简写模式 /t high ``` 方式三：**全局设置** 开启深度思考模式。使用 config 命令修改全局配置：openclaw config set agents.defaults.thinkingDefault \，示例如下： ``` 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 ``` ![](https://support.huaweicloud.com/model-call-maas/figure/zh-cn_image_0000002569015960.png "点击放大")