人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载本篇技术指南聚焦 OpenClaw 项目中 Qwen 提供方的接入方案通过免费层的 OAuth 设备码流程在qwen-portal提供方下使用 Qwen Coder 与 Qwen Vision 模型每日约 2,000 次请求具体受 Qwen 速率限制约束。读完本文你将掌握启用qwen-portal-auth插件、执行openclaw models auth login设备码认证、写入models.json提供方条目、创建qwen别名快速切换以及复用 Qwen Code CLI 已有登录、覆盖baseUrl等完整实战能力。一、整体认知Qwen 提供方在 OpenClaw 中的定位OpenClaw 对 LLM/模型提供方的抽象遵循provider/model的引用规则参见 模型提供方总览。Qwen 属于通过 OAuth 免费层接入的提供方与其他需要API_KEY的提供方如 OpenAI、Anthropic、Gemini不同它走的是「设备码device-codeOAuth 流程」你在终端触发登录后浏览器完成授权凭证被写入本机认证存储之后无需再持有/轮换 API Key。从源码结构看本仓库对 Qwen 的支持分两条线qwen-portal提供方本文主体走 Qwen Portal 官方免费层 OAuth基础 URL 为https://portal.qwen.ai/v1对应模型qwen-portal/coder-model与qwen-portal/vision-modelWeb 免 Token 通道同一仓库内的兄弟实现集中在 src/zero-token/其中qwen-web阿里国内与qwen-cn-web阿里国际通过浏览器会话认证不需要 API Token见 Web Models 支持文档。本文严格围绕官方文档 docs/providers/qwen.md 所讲解的qwen-portal免费层 OAuth 展开。二、第一步启用qwen-portal-auth插件Qwen 的 OAuth 能力由随 OpenClaw 捆绑发布的插件qwen-portal-auth提供。与大多数捆绑插件一样它默认是禁用状态必须显式启用参见 插件文档 中「Bundled extensions」一节。openclaw plugins enable qwen-portal-auth启用后必须重启 Gateway 网关使插件生效。这一点与 OpenClaw 的插件机制一致插件加载与配置变更都需要重启 Gateway 后才能被运行时识别configuration-reference.md 中也明确指出「Config changes require a gateway restart」。如果是在服务化部署场景daemon/service 模式可以用openclaw gateway restart或通过服务管理器重启本地开发场景直接重启openclaw gateway进程即可。三、第二步执行设备码 OAuth 认证启用插件后使用models auth login子命令完成认证openclaw models auth login --provider qwen-portal --set-default这条命令做了什么可以从 CLI 参考文档 与模型提供方总览得到印证models auth login会调用对应提供方插件的认证流程OAuth/API key--provider qwen-portal指定走 Qwen 的设备码流程运行过程中终端会展示设备码并引导你在浏览器中完成 Qwen 账户授权认证完成后OpenClaw 会把一个qwen-portal提供方条目写入你的models.json配置存放位置为~/.openclaw/agents/agentId/agent/models.json或 agent 目录下的models.json参见 configuration-reference.md同时生成一个qwen别名便于后续快速切换模型--set-default将该提供方设为默认后续openclaw models set model不带提供方前缀时也会优先解析到它。认证结果的查看与校验openclaw models status # 查看默认模型、fallbacks 与认证概况 openclaw models auth list # 查看已配置的认证 profile openclaw models aliases list # 查看 qwen 别名补充说明models status的认证输出中Qwen OAuth 这类非密钥占位符会以qwen-oauth之类的marker(value)形式展示而不是像OPENAI_API_KEY那样被当作密钥脱敏——这是正常的因为 OAuth 会话凭证与静态 API Key 的敏感等级不同见 docs/cli/models.md。四、模型 ID 与切换qwen-portal提供方在免费层暴露两个模型模型引用说明qwen-portal/coder-modelQwen Coder代码生成/编程场景qwen-portal/vision-modelQwen Vision视觉理解场景切换模型使用openclaw models setopenclaw models set qwen-portal/coder-modelmodels set model-or-alias同时接受provider/model完整引用或别名两种形式docs/cli/models.md。因此认证时自动生成的qwen别名可以让你用更短的命令切换openclaw models set qwen在需要把某个 Agent 固定到 Qwen 的场景也可以在openclaw.json中通过agents.defaults.model.primary指定{ agents: { defaults: { model: { primary: qwen-portal/coder-model } } }, }注意模型引用按第一个/分割 provider 与 model iddocs/cli/models.md所以qwen-portal/coder-model中 provider 是qwen-portalmodel id 是coder-model中间不得再出现未转义的斜杠。五、复用 Qwen Code CLI 的已有登录如果你之前已经用 Qwen Code CLI 登录过阿里官方编程 CLIOpenClaw 会在加载认证存储auth store时自动同步其凭证同步来源~/.qwen/oauth_creds.json同步时机每次加载 auth store即 Gateway 启动 / 认证状态刷新时自动进行无需手动导入但有两点必须注意仍需存在models.providers.qwen-portal条目。自动同步的只是凭证本身OpenClaw 仍然需要一个 provider 配置条目才能知道如何用它。请用上面的openclaw models auth login --provider qwen-portal --set-default生成该条目该命令会写入models.json并提供qwen别名凭证同步后如果失效或访问被撤销重新执行登录命令即可刷新。六、令牌自动刷新与失败恢复Qwen Portal 的 OAuth 令牌支持自动刷新因此日常使用中无需手动维护 access token。需要人工介入的情形包括刷新失败令牌自动刷新流程报错例如刷新凭证过期、网络问题导致 Refresh Token 失效访问被撤销你在 Qwen 账户侧撤销了该应用的授权长期未使用会话过期后再次调用模型报认证错误。以上情况统一处理方式重新运行登录命令即可重建会话openclaw models auth login --provider qwen-portal --set-default另外如果终端在执行 webauth/onboard 类浏览器授权流程后长时间未返回提示符可按CtrlC退出进程——凭证通常已在退出前写入auth-profiles.json/openclaw.json该提示同样适用于 Qwen 的浏览器认证路径见 web-models-support.md。七、默认 Base URL 与覆盖方式Qwen Portal 的默认 API 基础地址为https://portal.qwen.ai/v1正常情况下无需任何额外配置。若 Qwen 官方后续提供不同的端点例如区域化网关或新版本入口通过配置覆盖{ models: { mode: merge, providers: { qwen-portal: { baseUrl: https://portal.qwen.ai/v1 } } } }覆盖后需要重启 Gateway 使配置生效。models.providers.*.baseUrl是 OpenClaw 自定义/兼容提供方的通用配置项同时支持models.providers.*.api请求适配器如openai-completions、models.providers.*.apiKey、models.providers.*.auth等字段完整清单见 configuration-reference.md。Qwen Portal 走 OAuth因此该条目通常不需要 apiKey。八、扩展阅读Qwen Web 免 Token 通道同一仓库内的兄弟能力qwen-portal是官方免费层 OAuth 入口而本仓库OpenClaw Zero-Token还在 src/zero-token/ 中实现了Qwen Web 浏览器会话通道属于「所有主流模型无需 API Token」路线的一部分Provider IDqwen-web阿里国内、qwen-cn-web阿里国际见 web-models-support.md认证方式启动 Chrome 调试模式./start-chrome-debug.sh默认 CDP 端口 9222然后运行pnpm openclaw webauth或pnpm openclaw onboard在打开的https://chat.qwen.ai页面登录OpenClaw 通过 CDP 捕获 session cookie / authorization token实现见 qwen-web-auth.ts流式调用createQwenWebStreamFn会把浏览器会话凭证转换为标准 StreamFn并从响应流中解析文本、think思考块与tool_call工具调用实现见 qwen-web-stream.ts浏览器客户端见 qwen-web-client-browser.ts。这条 Web 通道与qwen-portal互为补充前者面向「完全没有 API Key、直接用浏览器会话」的场景后者面向「官方免费层 OAuth、带每日请求配额」的场景。若在浏览器认证中遇到 Session detected but token expired说明会话已过期需要重新登录见 web-models-support.md 的故障排除小节。九、常见问题速查现象处理openclaw plugins enable qwen-portal-auth后仍报 provider 未知未重启 Gateway插件尚未加载重启后再试认证后models set提示找不到模型确认使用了完整引用qwen-portal/coder-model或别名qwen而非只有coder-model模型调用报 401/认证失败令牌可能过期或已被撤销重新运行openclaw models auth login --provider qwen-portal --set-default已经登录过 Qwen Code CLI但 OpenClaw 仍不认凭证自动同步自~/.qwen/oauth_creds.json但仍需models.providers.qwen-portal条目用登录命令生成想换端点在models.providers.qwen-portal.baseUrl覆盖https://portal.qwen.ai/v1并重启 Gateway十、小结Qwen 免费层 OAuth 在 OpenClaw 中的接入路径非常清晰openclaw plugins enable qwen-portal-auth启用捆绑插件 → 重启 Gateway →openclaw models auth login --provider qwen-portal --set-default完成设备码认证 →openclaw models set qwen-portal/coder-model或vision-model切换模型。认证凭证写入models.json并附带qwen别名令牌自动刷新若已使用 Qwen Code CLIOpenClaw 还会从~/.qwen/oauth_creds.json自动同步凭证。默认端点https://portal.qwen.ai/v1可通过models.providers.qwen-portal.baseUrl覆盖。结合仓库中的 qwen.md 文档、模型提供方总览 与 CLI 参考即可在 OpenClaw 中稳定使用 Qwen Coder 与 Qwen Vision 的免费额度。赞分享人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载相关推荐qwen-code-action把 qwen-code 终端 Agent 接入 GitHub Actions 的完整实战指南qwen code action把 qwen code 终端 Agent 接入 GitHub Actions 的完整实战指南 本文基于 qwen code 官人工智能AI Agent代码智能体工具调用交互助手CLIQwenccusage Qwen 数据源接入指南用 Qwen Code 聊天 JSONL 统计 Token 用量与费用ccusage Qwen 数据源接入指南用 Qwen Code 聊天 JSONL 统计 Token 用量与费用 本文面向使用 Qwen Code https:AI 应用CLI开发工具快速上手 TVBoxOSC 主题开发四步做出属于你的电视盒子换肤快速上手 TVBoxOSC 主题开发四步做出属于你的电视盒子换肤 照着做完你能把 TVBoxOSC 的默认界面改成自己设计的皮肤深色背景、统一的导航栏颜色上一篇Docker CLI 实战docker network connect 完整指南——容器接入网络的连接、静态 IP、别名与 sysctl 配置下一篇ReadCat安全最佳实践终极插件安全与用户数据保护指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
