欢迎光临
我们一直在努力

OpenClaw 接入阿里云永久免费模型方案

Qwen2.5-7B-Instruct 模型为例


一、前置准备工作

1. 阿里云灵积账号与 API 准备

  • 注册与实名认证:

    • 打开 阿里云灵积 DashScope 平台,注册/登录账号。

    • 完成个人实名认证(推荐支付宝刷脸,1分钟完成,无需绑卡),这是解锁永久免费模型的唯一门槛。 如下图所示: 在这里插入图片描述

  • 开通模型服务:

    • 进入「模型广场」,搜索 qwen2.5-7b-instruct,点击模型卡片进入详情页,如下图所示: 在这里插入图片描述
  • 生成 API Key:

    • 进入控制台左侧「API-KEY 管理」,点击「创建新的 API-KEY」,自定义名称后点击确定。

    • 立即复制并保存 API Key(可以随时复制)。 如下图所示: 在这里插入图片描述

  • 开启防扣费开关(必做):

    • 回到 qwen2.5-7b-instruct 模型详情页,找到「免费额度用完即停」开关,切换为开启状态(紫色),确保额度耗尽后自动进入永久免费通道,不会扣费。
  • 另外免费额度说明:

    • 当前页面的 100 万 tokens 免费额度,是平台给多模态模型的新用户专属限时体验额度,仅能用于这个 Qwen2.5-VL-32B-Instruct 模型,90日后就会过期,过期后未用完的额度也会直接清零,和永久免费文本模型的额度不互通、不通用。
    • 如果你的核心需求是 OpenClaw 的网页抓取、长文档汇总、竞品调研,纯文本的qwen2.5-7b-instruct永久免费款完全够用,不会有额度和时间限制;只有当你需要用到图片理解、图文解析能力时,才需要用到 VL 系列多模态模型,这部分没有永久免费权益。
  • 2. OpenClaw 环境与权限预处理

  • 确保 OpenClaw 已正确安装并能基本运行。

  • 修复潜在权限问题(避免后续浏览器/文件访问报错):

    # 停止当前 OpenClaw 服务
    openclaw stop
    # 递归修正配置目录所有者为当前用户(将 tht 替换为你的实际用户名)
    sudo chown -R tht:tht /home/tht/.openclaw
    # 修正目录读写权限
    chmod -R 755 /home/tht/.openclaw


  • 二、配置方法(三种可选)

    方法一:Web UI 界面配置

    全程鼠标操作,自动处理配置格式,不会出错。

  • 启动 OpenClaw 并打开 UI:

    openclaw gateway start

    浏览器访问 http://127.0.0.1:18789 或 http://localhost:18789。

  • 进入配置页面:

    • 点击左侧菜单「配置」或「Settings」,选择「Models」(模型)选项卡。
  • 添加模型提供商:

    • 点击「Add Provider」(添加提供商),选择 OpenAI Compatible(OpenAI 兼容模式)。

    • 按以下表格严格填写参数:

  • 配置项填写内容
    Provider Name(提供商名称) 自定义,如 Aliyun-Qwen
    Base URL(接口地址) 必须填:https://dashscope.aliyuncs.com/compatible-mode/v1
    API Key 粘贴你之前复制的阿里云 API Key
  • 添加模型:

    • 在刚添加的提供商下,点击「Add Model」(添加模型),按以下表格填写:
  • 配置项填写内容
    Model ID(模型ID) qwen2.5-7b-instruct
    Model Name(模型名称) 自定义,如 Qwen2.5-7B (永久免费)
    Context Window(上下文窗口) 必须填≥16000,推荐直接填 32768(模型原生最大值)
    Max Output Tokens(最大输出) 推荐填 8192
    Cost(费用) 全填 0
  • 保存并应用配置:

    • 点击「Save」(保存),再点击「Apply」(应用),让配置实时生效。
  • (可选)设为默认模型:

    • 进入「Agents」(智能体)设置,在「Default Model」(默认模型)下拉菜单中选择刚添加的 qwen2.5-7b-instruct,保存即可。

  • 方法二:命令行向导配置(openclaw configure)

    适合偏好命令行的用户,工具自动处理配置合并。

  • 备份配置文件(以防万一):

    cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

  • 运行配置向导:

    openclaw configure

  • 按向导提示操作:

    • 选择 Model (Pick provider + credentials),按回车确认。

    • 选择 Add a new model provider。

    • 提供商类型选择 OpenAI-compatible。

    • 按以下内容填写关键参数(其他步骤按需填写):

  • 向导步骤填写内容
    Provider Name aliyun-qwen
    API Key 粘贴你的阿里云 API Key
    Base URL https://dashscope.aliyuncs.com/compatible-mode/v1
    Model ID qwen2.5-7b-instruct
    Context Window Size 32768(必须≥16000)
    Max Output Tokens 8192
    Model Alias(模型别名) qwen(后续用 /model qwen 快速切换)
    Set as default model? 按需选 y(是)或 n(否)
  • 保存并退出向导,重启 OpenClaw 生效:

    openclaw stop && openclaw start


  • 方法三:手动修改 JSON 配置

    仅当前两种方法不生效时使用,需严格注意语法。

  • 备份配置文件:

    cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup

  • 用编辑器打开配置文件:

    nano ~/.openclaw/openclaw.json

  • 按以下结构修改/添加配置(仅展示核心修改部分,保留原有的 Kimi 等配置):

    {
    "auth": {
    "profiles": {
    "aliyun:default": {
    "provider": "openai",
    "mode": "api_key"
    }
    }
    },
    "models": {
    "mode": "merge",
    "providers": {
    "aliyun": {
    "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "api": "openai-chat",
    "models": [
    {
    "id": "qwen2.5-7b-instruct",
    "name": "Qwen2.5-7B-Instruct",
    "reasoning": false,
    "input": ["text"],
    "cost": {
    "input": 0,
    "output": 0,
    "cacheRead": 0,
    "cacheWrite": 0
    },
    "contextWindow": 32768,
    "maxTokens": 8192
    }
    ]
    }
    }
    },
    "agents": {
    "defaults": {
    "model": {
    "primary": "aliyun/qwen2.5-7b-instruct"
    },
    "models": {
    "aliyun/qwen2.5-7b-instruct": {
    "alias": "Qwen"
    }
    }
    }
    }
    }

  • 保存并退出:按 Ctrl+O 保存,按 Ctrl+X 退出。 如下图所示: 在这里插入图片描述

  • 校验 JSON 语法(必须做,避免 invalid config 报错):

    jq . ~/.openclaw/openclaw.json

    输出完整 JSON 内容且无报错,代表语法正确。

  • 通过命令行配置 API Key(不要写在 JSON 里,不安全):

    openclaw config set auth.profiles.aliyun:default.apiKey "你的阿里云API-KEY"

  • 重启 OpenClaw 生效:

    openclaw gateway restart


  • 三、核心避坑指南(必须阅读,避免重复踩坑)

  • 接口地址红线:

    • 必须使用 OpenAI 兼容地址:https://dashscope.aliyuncs.com/compatible-mode/v1

    • 严禁使用灵积原生 API 域名,否则 OpenClaw 无法适配。

  • 上下文窗口红线:

    • contextWindow 必须 ≥ 16000,推荐直接填 32768(Qwen2.5-7B 原生最大值),否则会报 Model context window too small 错误。
  • JSON 语法红线:

    • 所有标点必须是英文半角字符,严禁使用中文逗号 ,、中文引号 “”。

    • 手动修改后必须用 jq 或在线 JSON 校验工具检查语法。

  • 权限问题:

    • 若之前用 sudo/root 运行过 OpenClaw,必须按前置准备中的步骤修复目录权限,否则会出现 EACCES: permission denied 报错。
  • API Key 安全:

    • 优先通过 Web UI 或 openclaw config set 命令配置 API Key,不要直接写在 JSON 文件里。

  • 四、验证配置成功

  • 重启 OpenClaw 服务:

    openclaw gateway restart

  • 切换模型并测试:

    • 打开 Web UI 对话界面,输入 /model Qwen(或你设置的模型别名)切换到 Qwen 模型。

    • 发送测试消息,如“你好,请介绍一下自己”,确认能正常收到回复。

    • (可选)发送一个长文本或网页抓取任务,确认不再出现上下文窗口报错。 如下图所示: 在这里插入图片描述

  • 在千问中消耗的tokens如下图所示: 在这里插入图片描述 神奇的是在kimi claw中居然还可以继续使用,不过用的是Qwen模型了,如下图所示: 在这里插入图片描述 在这里插入图片描述


    五、常见问题快速排查

    报错信息核心原因解决方法
    invalid config JSON 语法错误(中文标点、括号不匹配等) 用 jq . ~/.openclaw/openclaw.json 检查语法,修正错误标点
    Model context window too small (4096 tokens). Minimum is 16000. 上下文窗口配置值过小 将 contextWindow 修改为 32768,保存并重启
    EACCES: permission denied 配置文件/目录权限被锁定 按前置准备中的步骤执行 chown 和 chmod 命令修复权限
    模型连接失败/无响应 API Key 错误、接口地址错误或模型未开通 检查 API Key 是否正确、Base URL 是否为兼容地址、模型是否在灵积平台开通
    赞(0)
    未经允许不得转载:171主机测评 » OpenClaw 接入阿里云永久免费模型方案
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址