
# 在Notebook中安装配置OpenClaw
对于AI开发人员来说，如果需要在华为云ModelArts Notebook中高效地编写和管理AI模型，可能会遇到代码编写效率低、模型管理复杂的问题。本文介绍如何在华为云ModelArts Notebook中部署并使用OpenClaw。OpenClaw是一个开源的AI编程助手，可以运行在ModelArts Notebook实例中，通过浏览器访问Web UI进行交互。借助内置的ModelArts Skill可以快速使用和管理ModelArts服务，从而提高开发效率和简化模型管理。
![](https://support.huaweicloud.com/bestpractice-modelarts/public_sys-resources/warning_3.0-zh-cn.png)
Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install、apt-get install、yum install、pip install和OpenClaw安装后的配置对话等，以避免Notebook运行环境中的数据或对话session丢失。关于如何保存镜像，请参见[保存镜像](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_0008.html)。
#### 约束限制
- Notebook OpenClaw功能仅支持"华北-北京四"、"西南-贵阳一"、"华北-乌兰察布一"、"华东-上海一"和"华南-广州"区域。
- 您创建的[Notebook实例](https://support.huaweicloud.com/devtool-modelarts/devtool-modelarts_3495.html)需满足如下条件，才能正常使用OpenClaw。
  表1Notebook实例约束限制 
  | 类型   | 限制                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  |:---|:---|
  | 环境配置 | - **容器镜像的操作系统** ：暂不支持ubuntu_18.04及以下。 说明： 假设预置镜像的地址为pytorch_cuda: pytorch_2.7.0-cuda_12.8-py_3.11.10-ubuntu_22.04-x86_64-20251215163925-4e5422a，其中"ubuntu_22.04"为镜像的操作系统。   - **JupyterLab版本**：仅支持4.4.x版本。   图1创建Notebook实例-环境配置 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002630220984.png "点击放大")  |
  | 资源配置 | 仅支持**专属资源池** ，以确保安全使用。关于如何创建专属资源池，请参见[创建专属资源池](https://support.huaweicloud.com/resmgmt-modelarts/resmgmt-modelarts_0004.html)。 由于GPU、NPU资源受限购买，需联系客户经理或[提交工单](https://console.huaweicloud.com/ticket/?#/ticketindex/createTicketService)申请开通相应的资源规格；如果您所在的区域无CPU规格，请尝试切换至其他区域，例如华东-上海一、华北-北京四、亚太-曼谷、中东-利雅得等。 图2创建Notebook实例-资源配置 ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002630379978.png)                                                                                                   |
     
  
 
#### 计费说明
- 在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见[开发环境计费项](https://support.huaweicloud.com/price-modelarts/price-modelarts-0010.html)。
- OpenClaw本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。
 
#### 在Notebook配置OpenClaw
1. 登录[ModelArts管理控制台](https://console.huaweicloud.com/modelarts/)，在左侧导航栏按需选择以下操作。
   - 新版控制台：选择"模型开发与训练 \> Notebook"，进入"Notebook"页面。
   
   - 旧版控制台：选择"开发空间 \> Notebook"，进入"Notebook"页面。
    
2. 在"状态"为"运行中"的Notebook实例的操作列，单击"接入环境"，在"接入方式"对话框的"WebIDE"页签，单击"JupyterLab 接入"右侧的"接入"。
3. 在"ModelArts Launcher"页面的"AI Agent"区域，单击"OpenClaw"。
   图3AI Agent   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002602528045.png) 
4. 在"OpenClaw 控制面板"，单击"安装配置 OpenClaw"，在Terminal中选择"完整安装 OpenClaw"，按Enter确认。
   图4安装配置OpenClaw   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002618538591.png "点击放大")
   图5完整安装OpenClaw   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002588138944.png) 
5. 安装版本选择推荐版本，安装完成后，会显示"安装成功"。
   图6选择安装版本   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002602733567.png) 
6. 按实际情况配置模型信息，并重启Gateway。 如果您需要配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。查看MaaS模型能力，请参见[推荐模型](https://support.huaweicloud.com/model-list-maas/model_list_0001.html)；查看ModelArts模型能力，请参见[模型调用功能介绍](https://support.huaweicloud.com/model-call-modelarts/model-call-modelarts-0001.html)。
   下文以配置华为云MaaS为例。第三方模型配置信息请参见对应的模型提供商指导文档。
   表2首次配置向导-MaaS配置示例 
   | 配置项                | 说明                                                                                                                                 | 配置示例                                                                                          |
   |:---|:---|:---|
   | 是否现在配置华为云MaaS      | 选择配置MaaS或其他服务，本文以MaaS为例。                                                                                                           | y                                                                                             |
   | 请输入MaaS API地址      | 使用MaaS API地址时，需删除地址末尾的/chat/completions，修改示例参见[表3]。                              | https://api.modelarts-maas.com/v2                                                             |
   | 请输入您的API Key       | 输入在MaaS创建的API Key。关于如何在MaaS创建API Key，请参见[创建API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html#section2)。 | D1Jy5b4n_JOKGSDEbhmNTZxpX5Obk6asJrA4bS660GZ_nrKFL-NSU2wv13AuliG_tbIz7i0wiY7\*\*\*\*\*\*\*\*\* |
   | 选择默认模型             | 按需选择使用的模型。                                                                                                                         | deepseek-v3.2（DeepSeek-V3.2，支持推理）                                                             |
   | 配置完成，是否立即启动Gateway | 启动Gateway，使配置生效。                                                                                                                   | y                                                                                             |
      
    表3MaaS API地址说明 
   | 接口           | 原MaaS API地址                                        | 修改后的MaaS API地址                    | 相关文档                                                                             |
   |:---|:---|:---|:---|
   | MaaS标准API V2 | https://api.modelarts-maas.com/v2/chat/completions | https://api.modelarts-maas.com/v2 | [模型API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-019.html) |
   | OpenAI兼容接口   | https://api.modelarts-maas.com/openai/v1           | 与原MaaS API地址一致                    | [模型API调用规范](https://support.huaweicloud.com/model-call-maas/model-call-019.html) |
      
   图7配置华为云MaaS   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002618458685.png "点击放大")
   Gateway启动后，在"ModelArts Launcher"页面的"AI Agent"区域，单击"OpenClaw"，打开OpenClaw。
   图8打开OpenClaw   
   ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002587979032.png "点击放大") 
 
#### 验证OpenClaw是否配置成功
- 在OpenClaw左侧导航栏，单击"聊天"，输入任意语句，开始问答。
  图9在OpenClaw中进行对话   
  ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002602743235.png "点击放大") 
- 在OpenClaw左侧导航栏，选择"代理 \> 技能"，查看modelarts-skill安装情况。 modelarts-skill开关打开，表示华为云ModelArts平台已集成，您可以在OpenClaw中使用和管理ModelArts服务，详情请参见[ModelArts Skill最佳实践](https://support.huaweicloud.com/bestpractice-modelarts/modelarts_20_00024.html)。
  图10查看ModelArts Skill   
  ![](https://support.huaweicloud.com/bestpractice-modelarts/figure/zh-cn_image_0000002587979030.png "点击放大") 
 
