更新时间:2026-04-02 GMT+08:00
分享

OpenClaw对接自定义AI模型

Flexus L实例提供的OpenClaw应用镜像支持对接多种主流AI模型,可以与飞书、QQ、企业微信或钉钉结合共同搭建个人AI助手。更多场景最佳实践请参见OpenClaw最佳实践汇总

如果华为云MaaS提供对接的AI模型中没有您需要的模型,可以参考本文档对接自定义的AI模型。

Flexus L实例提供的OpenClaw应用镜像使用官方开源脚本安装,部署前请阅读OpenClaw风险说明及安全建议

约束与限制

自定义模型仅支持OpenAI兼容协议的API地址,例如:https://api.openai.com/v1。请向模型供应商获取OpenAI兼容协议的API地址。

前提条件

已购买安装了OpenClaw应用镜像的Flexus L实例。

操作步骤

  1. 登录Flexus应用服务器L实例控制台
  2. 单击目标L实例资源卡片上的“立即配置”,进入应用管理页面。

    如果页面未显示“立即配置”,请单击资源卡片,进入资源详情页面,在左侧列表中单击“应用管理”。

    OpenClaw应用镜像的部分功能(如查询网关状态、更新模型及应用配置等)依赖云运维中心(Cloud Operations Center,简称COC),需要先授权并开通COC服务。如果出现下图提示,请按界面提示授权并开通。

  3. 在基础信息模块中可以查看以下信息,当UniAgent状态、网关状态均为运行中时,可进行下一步。
    表1 应用详情基础信息

    参数

    示例

    说明

    UniAgent状态

    运行中

    OpenClaw网关状态查询以及配置脚本下发等操作依赖应用运维管理(Application Operations Management,简称AOM)的统一数据采集Agent(简称UniAgent)。购买L实例后系统会自动安装UniAgent插件。UniAgent状态如下:

    • 运行中:UniAgent插件状态正常。
    • 安装中:UniAgent插件安装中,请耐心等待,安装完成后再对L实例进行操作。
    • 异常:UniAgent插件状态异常。
    • 安装失败:UniAgent插件安装失败。
    • 未安装:UniAgent插件未安装。
    说明:

    如果UniAgent状态为异常、安装失败或未安装,请参考安装UniAgent进行手动安装。

    网关状态

    运行中

    OpenClaw网关状态。

    • 运行中:OpenClaw网关状态为运行中时表示OpenClaw服务正常。
    • 未知/异常:OpenClaw网关初始状态为加载中,如果等待几分钟后变更为未知或异常,请单击“重启”,重启需要一定时间,请耐心等待,重启成功后将变更为运行中。
    说明:

    如果单击“重启”后,网关状态依旧为未知或者异常,请提交工单

  4. 在配置信息模块,单击“配置模型”,单击“添加模型”,在右侧半屏页面中配置模型信息。

  5. 模型供应商选择自定义模型,在自定义模型下方的代码框中,按照json格式填入以下模型参数信息。
    {
      "base_url": "https://api.openai.com/v1",
      "api_key": "your_api_key",
      "model_id": "gpt-5.2"
    }
    表2 自定义模型参数信息

    参数

    说明

    示例

    base_url

    模型的API地址。

    https://api.siliconflow.cn/v1

    api_key

    模型提供商的API密钥。

    your_api_key

    model_id

    模型的唯一标识符。

    deepseek-ai/DeepSeek-V3.2

    以配置硅基流动DeepSeekv3.2模型为例:

    {
      "base_url": "https://api.siliconflow.cn/v1",
      "api_key": "your_api_key",
      "model_id": "deepseek-ai/DeepSeek-V3.2"
    }
  6. 模型别名可以按需配置,配置完成后单击“确定”。

    模型添加成功后可以在模型列表中查看已配置的模型。

相关文档