配置OpenClaw接入通义千问免费版时，有个地址特别容易踩坑——必须填https://dashscope.aliyuncs.com/compatible-mode/v1，填错就会报"Invalid endpoint"或者干脆404。这个地址和早期版本不一样，2025年Q3之后全面切换成了DashScope兼容接口，不支持旧版百炼平台的/v1路径，也不支持直接用根域名。

如果填成https://dashscope.aliyuncs.com/api/v1或https://dashscope.aliyuncs.com/v1，直接触发404；要是错填了百炼地址，则因为鉴权机制不同而返回"Unauthorized"。怎么配置呢？有三种主流方式，覆盖了新手、批量部署和调试场景。

确认当前应使用的TONGYI_BASE_URL

先明确一点：通义千问免费调用走的是DashScope兼容接口，TONGYI_BASE_URL必须填https://dashscope.aliyuncs.com/compatible-mode/v1。这是2025年Q3起全量切换后的标准兼容入口，支持OpenAI格式请求，与百炼平台的/v1路径不互通。

填错成https://dashscope.aliyuncs.com/api/v1或https://dashscope.aliyuncs.com/v1会触发404错误；填成百炼地址https://dashscope.aliyuncs.com/则因鉴权机制不同而报"Unauthorized"。

在OpenClaw中设置TONGYI_BASE_URL的三种方式

方法一：通过控制面板图形界面配置（推荐新手）
进入OpenClaw管理后台 → Models → Add provider → 选择Qwen → 在Endpoint / Base URL字段粘贴https://dashscope.aliyuncs.com/compatible-mode/v1 → 输入API Key → Sa ve → Set as default

方法二：手动修改config/model.yaml（适合批量部署）
用sudo nano /opt/openclaw/config/model.yaml打开配置文件 → 找到provider: dashscope区块 → 在其下添加base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1" → 保存退出 → 执行sudo systemctl restart openclaw

方法三：通过环境变量覆盖（优先级最高，调试专用）
在OpenClaw服务启动前执行export TONGYI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1" → 确保该行写入/etc/environment或systemd service文件的Environment=字段 → 重启服务生效

验证TONGYI_BASE_URL是否生效

配置完别急着高兴，得验证一下到底生效了没。具体步骤：

第一步：在OpenClaw对话框输入测试指令"调用qwen测试"
第二步：观察日志输出（可通过journalctl -u openclaw -f实时查看）
第三步：确认日志中间出现类似[INFO] Using base_url: https://dashscope.aliyuncs.com/compatible-mode/v1的记录
第四步：检查返回内容是否含qwen-turbo或qwen-plus标识，而非"model not found"或"connection refused"

如果日志显示base_url被忽略，说明环境变量未加载或config/model.yaml中存在重复定义，需删除冗余配置项再重试。