1. OpenClaw与Qwen OAuth集成概述
OpenClaw作为一款开源的AI代理框架,提供了与多种大模型服务集成的能力。其中,Qwen(通义千问)作为阿里巴巴推出的重要AI模型服务,通过官方插件形式与OpenClaw深度集成。这种集成主要包含四种认证方式:
- Coding Plan:面向开发者的订阅制访问方案
- Standard Plan:按量付费的标准版服务
- Token Plan:团队版的额度制订阅
- OAuth/Portal:基于令牌的认证流程
Qwen OAuth认证特别适合需要灵活控制访问权限的场景。与API Key直接认证不同,OAuth流程通过令牌(token)进行授权,具有以下优势:
- 可设置细粒度的访问权限
- 支持令牌的定期轮换
- 便于实现多租户场景下的权限隔离
- 符合企业级安全规范
重要提示:Token Plan仅适用于交互式会话,不可用于无人值守的脚本或后台服务,否则可能导致账号被封禁。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与插件安装
2.1 系统要求
在开始集成前,请确保满足以下基础环境要求:
- OpenClaw核心框架已安装(版本≥0.8.0)
- Node.js运行环境(建议LTS版本)
- 可访问Qwen服务的网络环境(国内/国际端点选择正确)
2.2 Qwen插件安装
Qwen提供商作为官方插件,需要单独安装:
bash复制openclaw plugins install @openclaw/qwen-provider
openclaw gateway restart
安装完成后,可通过以下命令验证插件状态:
bash复制openclaw plugins list | grep qwen
2.3 认证信息准备
根据使用场景选择对应的认证方式:
| 计划类型 | 认证选项 | 适用场景 |
|---|---|---|
| Coding Plan | qwen-api-key/qwen-api-key-cn | 开发者订阅 |
| Standard Plan | qwen-standard-api-key | 按量付费的标准服务 |
| Token Plan | qwen-token-plan | 团队版额度订阅 |
| Qwen Portal | qwen-oauth | 令牌认证流程 |
对于OAuth方式,需要先在Qwen Portal(portal.qwen.ai)创建应用并获取客户端凭证。
3. OAuth认证流程详解
3.1 初始化认证配置
执行新手引导命令开始OAuth配置:
bash复制openclaw onboard --auth-choice qwen-oauth
根据提示输入以下信息:
- Client ID:Qwen Portal中创建应用时分配的客户端ID
- Client Secret:对应的客户端密钥
- 回调地址:应用配置的合法回调URL
3.2 令牌获取流程
OAuth认证的核心是获取访问令牌,完整流程包含:
-
授权请求:引导用户跳转到Qwen授权页面
code复制https://portal.qwen.ai/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&scope=openai -
获取授权码:用户授权后,Qwen会将授权码(code)返回到回调地址
-
交换令牌:使用授权码换取访问令牌
bash复制curl -X POST https://portal.qwen.ai/oauth/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=auth
