必须升级至OpenClaw v2026.3.24稳定版并配置DashScope官方接口，否则持续401错误；需确认版本、强制升级、补全config.yaml中dashscope配置、替换AGENTS.md中model_provider为dashscope及对应model_id，并通过命令行或网关验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在OpenClaw v2026.3.24稳定版中启用通义千问DashScope官方接口，而非百炼平台旧路径，否则模型调用会持续返回401错误且无法自动重试。
确认当前版本并升级到v2026.3.24
打开终端，进入OpenClaw主目录执行：openclaw --version。若显示版本低于v2026.3.24，运行openclaw update --force强制升级——这一步必须完成，旧版不识别DashScope新认证头字段。
升级后检查core/config.yaml是否存在dashscope:顶层键，有则说明已就绪；无则需手动补全基础结构。
获取DashScope API Key并配置
登录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配额中心提升额度或切换至个人版密钥。
