文档首页/ 魔坊（ModelArts）模型训推平台/ 最佳实践/ Notebook OpenClaw最佳实践/ 在Notebook中安装配置OpenClaw
更新时间：2026-06-02 GMT+08:00
查看PDF
分享

在Notebook中安装配置OpenClaw

对于AI开发人员来说，如果需要在华为云ModelArts Notebook中高效地编写和管理AI模型，可能会遇到代码编写效率低、模型管理复杂的问题。本文介绍如何在华为云ModelArts Notebook中部署并使用OpenClaw。OpenClaw是一个开源的AI编程助手，可以运行在ModelArts Notebook实例中，通过浏览器访问Web UI进行交互。借助内置的ModelArts Skill可以快速使用和管理ModelArts服务，从而提高开发效率和简化模型管理。

Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留npm install、apt-get install、yum install、pip install和OpenClaw安装后的配置对话等，以避免Notebook运行环境中的数据或对话session丢失。关于如何保存镜像，请参见保存镜像。

约束限制

  • Notebook OpenClaw功能仅支持“华北-北京四”区域。
  • 您创建的Notebook实例需满足如下条件，才能正常使用OpenClaw。
    表1 Notebook实例约束限制

    类型

    限制

    环境配置
    • 容器镜像的操作系统：暂不支持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版本。

    资源配置

    仅支持专属资源池，以确保安全使用。关于如何创建专属资源池，请参见创建专属资源池。

    由于GPU、NPU资源受限购买，需联系客户经理或提交工单申请开通相应的资源规格；如果您所在的区域无CPU规格，请尝试切换至其他区域，例如华东-上海一、华北-北京四、亚太-曼谷、中东-利雅得等。
    图1 创建Notebook实例配置示例

计费说明

在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见开发环境计费项。

在Notebook配置OpenClaw

  1. 登录ModelArts管理控制台，在左侧导航栏选择“开发空间 > Notebook”，进入“Notebook”页面。
  2. 在“状态”为“运行中”的Notebook实例的操作列，单击“接入环境”，在“接入方式”对话框，单击“JupyterLab 接入”右侧的“接入”。
  3. 在“ModelArts Launcher”页面的“AI Agent”区域，单击“OpenClaw”。
    图2 AI Agent
  4. 在“OpenClaw 控制面板”，单击“安装配置 OpenClaw”，在Terminal中选择“完整安装 OpenClaw”，按Enter确认。
    图3 安装配置OpenClaw
    图4 完整安装OpenClaw
  5. 安装版本选择推荐版本，安装完成后，会显示“OpenClaw 安装完成”。
    图5 选择安装版本
  6. 按实际情况配置模型信息，并重启Gateway。

    如果您需要配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。查看MaaS模型能力，请参见推荐模型；查看ModelArts模型能力，请参见模型调用功能介绍。

    下文以配置华为云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。

    D1Jy5b4n_JOKGSDEbhmNTZxpX5Obk6asJrA4bS660GZ_nrKFL-NSU2wv13AuliG_tbIz7i0wiY7*********

    选择默认模型

    按需选择使用的模型。

    deepseek-v3.2（DeepSeek-V3.2，支持推理）

    配置完成，是否立即启动Gateway

    启动Gateway，使配置生效。

    y
    表3 MaaS API地址说明

    接口

    原MaaS API地址

    修改后的MaaS API地址

    相关文档

    MaaS标准API V2

    https://api.modelarts-maas.com/v2/chat/completions

    https://api.modelarts-maas.com/v2

    模型API调用规范

    OpenAI兼容接口

    https://api.modelarts-maas.com/openai/v1

    与原MaaS API地址一致
    图6 配置华为云MaaS
  7. Gateway启动后，在“ModelArts Launcher”页面的“AI Agent”区域，单击“OpenClaw”，打开OpenClaw。
    图7 打开OpenClaw

验证OpenClaw是否配置成功

  • 在OpenClaw左侧导航栏，单击“聊天”，输入任意语句，开始问答。
    图8 在OpenClaw中进行对话
  • 在OpenClaw左侧导航栏，选择“代理 > 技能”，查看modelarts-skill安装情况。

    modelarts-skill开关打开，表示华为云ModelArts平台已集成，您可以在OpenClaw中使用和管理ModelArts服务，例如使用OpenClaw在线管理Notebook、使用OpenClaw自动保存Notebook镜像等。

    图9 查看modelarts-skill

相关文档