# OpenClaw OpenClaw是一个开源的个人AI助手，能够连接到多种消息平台。通过Token Plan等渠道，用户可以配置并使用MaaS平台上的模型。 #### 前提条件 已订阅MaaS Token Plan套餐。具体操作请参见[快速开始](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html#ZH-CN_TOPIC_0000002583633128__section1953014219367)。 #### 约束限制 该功能仅支持"西南-贵阳一"区域。 #### 核心配置 接入工具的核心参数如下： | 核心参数 | 说明 | |:---|:---| | 支持的模型 | 支持模型如下： - GLM-5.1 - Kimi-K2.6 - DeepSeek-V4-Flash | | Base URL | 兼容OpenAI接口协议工具：https://api.modelarts-maas.com/plan/v2 注意： 如未使用指定的专属Base URL，将无法使用Token Plan额度，并可能产生额外API请求的费用。 | | API Key | 请前往[API Key管理页面](https://console.huaweicloud.com/modelarts/?#/model-studio/authmanage)创建。 | #### 步骤一：安装OpenClaw 1. 安装[Node.js 22或更高版本](https://nodejs.org/en/download/)。在安装过程中勾选 "Add to PATH"，自动添加环境变量。安装完成后，打开命令提示符（CMD）输入如下命令，有回显版本号，则说明Node.js安装成功。如果显示版本号低于v22.0，说明需要更新。 ``` #运行该命令可验证Node.js版本 node -v 或 npm -v ``` 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-plan": { "baseUrl": "https://api.modelarts-maas.com/plan/v2", "apiKey": "", "api": "openai-completions", "models": [ { "id": "deepseek-v4-flash", "name": "deepseek-v4-flash", "contextWindow": 1024000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "glm-5.1", "name": "glm-5.1", "contextWindow": 192000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "kimi-k2.6", "name": "kimi-k2.6", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text" ] }, ] } } }, "agents": { "defaults": { "model": { "primary": "hw-maas-plan/glm-5.1" }, "models": { "hw-maas-plan/deepseek-v4-flash": {}, "hw-maas-plan/glm-5.1": {}, "hw-maas-plan/kimi-k2.6": {}, } } }, "gateway": { "mode": "local" } } ``` - 已有配置：如果您已经配置过OpenClaw，请勿直接覆盖原有配置，建议根据提供的配置更新models、agents和gateway节点信息。其中models节点包含支持的模型列表。 3. 配置完成后，单击右上角Save保存，然后单击Update使配置生效。 保存成功后，apiKey将显示为"__OPENCLAW_REDACTED__"。仅用于前端界面隐藏，不影响实际调用。 - 终端方式 1. 在终端编辑openclaw.json配置文件。 ``` cat ~/.openclaw/openclaw.json ``` 2. 修改配置信息。 - 首次配置：复制以下内容到配置文件。 - 配置的模型为指定模型，示例如下： ``` { "models": { "providers": { "hw-maas-plan": { "baseUrl": "https://api.modelarts-maas.com/plan/v2", "apiKey": "", "api": "openai-completions", "models": [ { "id": "deepseek-v4-flash", "name": "deepseek-v4-flash", "contextWindow": 1024000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "glm-5.1", "name": "glm-5.1", "contextWindow": 192000, "maxTokens": 64000, "input": [ "text" ] }, { "id": "kimi-k2.6", "name": "kimi-k2.6", "contextWindow": 256000, "maxTokens": 32000, "input": [ "text" ] }, ] } } }, "agents": { "defaults": { "model": { "primary": "hw-maas-plan/glm-5.1" }, "models": { "hw-maas-plan/deepseek-v4-flash": {}, "hw-maas-plan/glm-5.1": {}, "hw-maas-plan/kimi-k2.6": {}, } } }, "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-plan/glm-5.1 ``` 界面返回提示"model set to \<模型名称\>" ，表示生效。 - **切换默认模型（永久有效）** 如需在每次新会话中使用指定模型，修改agents.defaults.model.primary字段为目标模型，请参考[步骤二：在OpenClaw中配置Token Plan]。修改示例如下： ``` { "agents": { "defaults": { "model": { "primary": "hw-maas-plan/glm-5.1" } } } } ``` #### 常见问题 - [OpenClaw如何开启深度思考模式？](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0007.html#ZH-CN_TOPIC_0000002613992893__section11191730101315) - [安装OpenClaw时报错"gateway connect failed: Error: pairing required"，如何处理？](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0007.html#ZH-CN_TOPIC_0000002613992893__section928611410262) - [配置OpenClaw时报错"run error: 404 The model or endpoint xxx does not exist or you do not have access to it"，如何处理？](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0007.html#ZH-CN_TOPIC_0000002613992893__section823202672616)