首先明确几个核心判断：如果仍在使用OpenClaw旧版本调用通义千问，近期频繁出现的401错误多半与模型本身无关——根本原因在于接口迁移导致的认证机制变更。自从从百炼平台切换到DashScope新接口后，旧版本完全无法识别新的认证头字段，自然无法正常通信。

唯一有效的解决方案，是升级至OpenClaw v2026.3.24稳定版，并严格按照要求完成DashScope的配置。接下来的步骤，每步都必须执行，不可跳过。

因此，必须在OpenClaw v2026.3.24稳定版中启用通义千问DashScope的最新接口，而非继续使用百炼平台的旧路径。否则模型调用将不断返回401错误，并且不会触发自动重试机制——这在生产环境中几乎是致命的隐患。

检查当前版本并升级到v2026.3.24稳定版

旧版本无法识别DashScope的新认证头，因此首要任务是确认当前版本。打开终端，切换到OpenClaw主目录，运行命令：openclaw --version。如果显示的版本号低于v2026.3.24，则立即执行openclaw update --force进行强制升级——这一步不容妥协。

升级完成后，检查core/config.yaml文件中是否包含dashscope:这个顶级键。如果存在，表明配置已就绪；若不存在，则需要手动添加完整的配置框架。切勿嫌麻烦，这是最基础的关键步骤。

获取DashScope API密钥并完成配置

登录DashScope控制台，导航至「API密钥管理」页面，生成一个新的密钥，获取sk-xxxxx格式的密钥字符串。接着编辑core/config.yaml，在dashscope:节点下添加以下配置：

api_key: "sk-xxxxx"
base_url: "https://dashscope.aliyuncs.com/compatible-mode/v1"

此处有一个极易出错的细节：base_url必须严格使用上述兼容模式地址。如果贪图方便直接填写https://dashscope.aliyuncs.com/api/v1，OpenClaw网关将解析失败并返回Invalid endpoint path错误。经验之谈，曾有用户因此耗费了整个下午。

将默认模型切换为DashScope Qwen系列

第一步：打开workspace/default/AGENTS.md文件，定位到model_provider:字段。

第二步：将原有的值（无论是baillan还是qwen）通通修改为dashscope。

第三步：在同一文件中找到model_id:行，将其替换为以下合法ID之一。请严格注意大小写和连字符，任何错误都会导致调用失败：

• qwen-qwq-32b-instruct（多模态推理）
• qwen-max-202604（强逻辑+长上下文）
• qwen-coder-plus-202603（编程专用）

第四步：保存文件并关闭编辑器。至此，模型切换完成。

验证DashScope接口是否正常连通

提供两种验证方式，选择你习惯的一种即可。

方法一：命令行快速测试。运行命令openclaw test --provider dashscope --model qwen-max-202604，观察是否返回✅ Live and responsive。如果出现该提示，说明接口已连通。

方法二：启动网关后发送测试请求。先执行openclaw gateway start，随后在浏览器中打开http://localhost:18789/debug/model-test，选择dashscope，点击「Run」按钮，检查响应体中是否包含"finish_reason":"stop"。若有此字段，则表示一切正常。

如果返回rate_limit_exceeded错误，意味着你的API Key关联了企业账号，并且已超出月度免费额度。此时，需前往DashScope配额中心申请提升额度，或改用个人版密钥来解决。