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

以 Qwen2.5-7B-Instruct 模型为例，完整走一遍配置流程——从账号准备到模型跑通，再到避坑验证，每一步都配了截图。如果你正好在用 OpenClaw 又缺一个免费好用的文本模型，这篇指南可以直接照着抄。

一、前置准备工作

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

1. 注册与实名认证
   ：
   • 打开阿里云灵积 DashScope 平台，注册或登录账号。
   • 完成

     个人实名认证
     （推荐支付宝刷脸，1分钟搞定，无需绑卡）。这是解锁永久免费模型的唯一门槛。
     如下图所示：

   

2. 开通模型服务
   ：
   • 进入「模型广场」，搜索 qwen2.5-7b-instruct，点击模型卡片进入详情页，如下图所示：

   

3. 生成 API Key
   ：
   • 进入控制台左侧「API-KEY 管理」，点击「创建新的 API-KEY」，自定义名称后确定。

   • 立即复制并保存
     API Key（后续随时可以复制）。
     如下图所示：

   

4. 开启防扣费开关（必做）
   ：
   • 回到 qwen2.5-7b-instruct 模型详情页，找到「免费额度用完即停」开关，

     切换为开启状态
     （紫色）。这样额度耗尽后会自动进入永久免费通道，不会扣费。

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

2. OpenClaw 环境与权限预处理

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

2. 修复潜在权限问题
   （避免后续浏览器/文件访问报错）：

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

二、配置方法（三种可选）

方法一：Web UI 界面配置

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

1. 启动 OpenClaw 并打开 UI
   ：

openclaw gateway start

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

2. 进入配置页面
   ：点击左侧菜单「配置」或「Settings」，选择「Models」（模型）选项卡。

3. 添加模型提供商
   ：
   • 点击「Add Provider」（添加提供商），选择 OpenAI Compatible（OpenAI 兼容模式）。
   • 按以下表格严格填写参数：

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

4. 添加模型
   ：在刚添加的提供商下，点击「Add Model」（添加模型），按以下表格填写：

配置项	填写内容
Model ID（模型ID）	qwen2.5-7b-instruct
Model Name（模型名称）	自定义，如 Qwen2.5-7B (永久免费)
Context Window（上下文窗口）	必须填 ≥ 16000 ，推荐直接填 32768（模型原生最大值）
Max Output Tokens（最大输出）	推荐填 8192
Cost（费用）	全填 0

5. 保存并应用配置
   ：点击「Sa ve」（保存），再点击「Apply」（应用），配置实时生效。

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

方法二：命令行向导配置（openclaw configure）

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

1. 备份配置文件
   （以防万一）：

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

2. 运行配置向导
   ：

openclaw configure

3. 按向导提示操作
   ：
   • 选择 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

4. 保存并退出向导
   ，重启 OpenClaw 生效：

openclaw stop && openclaw start

方法三：手动修改 JSON 配置

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

1. 备份配置文件
   ：

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

2. 用编辑器打开配置文件
   ：

nano ~/.openclaw/openclaw.json

3. 按以下结构修改/添加配置
   （仅展示核心部分，保留原有的 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"
        }
      }
    }
  }
}

4. 保存并退出
   ：按 Ctrl+O 保存，按 Ctrl+X 退出。
   如下图所示：

5. 校验 JSON 语法
   （必须做，避免 invalid config 报错）：

jq . ~/.openclaw/openclaw.json

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

6. 通过命令行配置 API Key
   （不要写在 JSON 里，不安全）：

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

7. 重启 OpenClaw 生效
   ：

openclaw gateway restart

三、核心避坑指南（必须阅读，避免重复踩坑）

1. 接口地址红线
   ：必须使用 OpenAI 兼容地址 https://dashscope.aliyuncs.com/compatible-mode/v1。严禁使用灵积原生 API 域名，否则 OpenClaw 无法适配。

2. 上下文窗口红线
   ：contextWindow 必须 ≥ 16000，推荐直接填 32768（Qwen2.5-7B 原生最大值），否则会报 Model context window too small 错误。

3. JSON 语法红线
   ：所有标点必须是

   英文半角字符
   ，严禁使用中文逗号、中文引号。手动修改后必须用 jq 或在线 JSON 校验工具检查语法。

4. 权限问题
   ：若之前用 sudo/root 运行过 OpenClaw，必须按前置准备中的步骤修复目录权限，否则会出现 EACCES: permission denied 报错。

5. API Key 安全
   ：优先通过 Web UI 或 openclaw config set 命令配置 API Key，不要直接写在 JSON 文件里。

四、验证配置成功

1. 重启 OpenClaw 服务
   ：

openclaw gateway restart

2. 切换模型并测试
   ：
   • 打开 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 是否为兼容地址、模型是否在灵积平台开通

六、接入了模型后，一切就感觉不可控了

你可以直接在 chat 窗口告诉它你想要配置的模型信息，让它自己配置——只要动动嘴皮子，它就可以自己搞定。
如下图所示：

也可以在 Kimi Claw 中搞一把，如下图所示：

同时可以看到配置文件：

总结