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 是否为兼容地址、模型是否在灵积平台开通 |



