必须填https://dashscope.aliyuncs.com/compatible-mode/v1,填错会导致Invalid endpoint或404错误;可通过控制面板、config/model.yaml或环境变量TONGYI_BASE_URL三种方式配置,并以日志中INFO记录和模型标识验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw配置通义千问免费版时,TONGYI_BASE_URL填错会导致模型连接失败、提示“Invalid endpoint”或直接返回空响应,必须严格匹配阿里云DashScope兼容模式的固定地址,不能用百炼平台URL或旧版API地址。
确认当前应使用的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 → Save → 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中存在重复定义,需删除冗余配置项再重试。


















