直接用飞书机器要与openclaw对话，不使用群组里@。默认的千问qwen-max没有免费额度

# 在
OpenClaw中手动添加
Qwen3系列大模型的完整指南
问题分析
与解决方案概述 在
使用
OpenClaw过程中，用户经常面临官方模型列表有限的困扰，特别是对于
Qwen3系列的最新模型无法
直接
使用的
问题。通过分析参考资料[ref_1]中的技术细节，我们可以通过手动配置的方式扩展
OpenClaw支持的模型范围。 核心
问题识别
– 模型可用性限制：
OpenClaw
默认只提供`
qwen
–portal/coder
–model`和`
qwen
–portal/vision
–model`两种
Qwen模型
– 认证方式差异：官方模型
使用OAuth认证，而
Qwen3系列模型需要
使用API Key认证
– 多模态支持缺失：无法
使用
Qwen3的视觉、语音等多模态模型 详细配置步骤 1. 定位配置文件 首先需要找到
OpenClaw的核心配置文件： bash # 进入
OpenClaw配置目录 cd ~/.
openclaw # 编辑主配置文件 vim
openclaw.json 或者
直接在文件管理器中导航至`.
openclaw/
openclaw.json`文件位置[ref_1]。 2. 添加
Qwen3模型配置 在配置文件的`models`数组中添加新的
Qwen3模型配置块： json { “baseUrl”: “https://dashscope.aliyuncs.com/compatible
–mode/v1″, “apiKey”: “{{your
–apiKey}}”, “api”: “openai
–completions”, “models”: [ { “id”: ”
qwen
–turbo”, “name”: ”
Qwen3 Turbo”, “reasoning”: false, “input”: [“text”], “cost”: { “input”: 0, “output”: 0, “cacheRead”: 0, “cacheWrite”: 0 }, “contextWindow”: , ”
maxTokens”: 8192 }, { “id”: ”
qwen
–plus”, “name”: ”
Qwen3 Plus”, “reasoning”: false, “input”: [“text”], “cost”: { “input”: 0, “output”: 0, “cacheRead”: 0, “cacheWrite”: 0 }, “contextWindow”: , ”
maxTokens”: 8192 }, { “id”: ”
qwen
–
max“, “name”: ”
Qwen3
Max“, “reasoning”: false, “input”: [“text”], “cost”: { 千问 Qwen 教程 “input”: 0, “output”: 0, “cacheRead”: 0, “cacheWrite”: 0 }, “contextWindow”: , ”
maxTokens”: 8192 }, { “id”: ”
qwen
–flash”, “name”: ”
Qwen3 Flash”, “reasoning”: false, “input”: [“text”], “cost”: { “input”: 0, “output”: 0, “cacheRead”: 0, “cacheWrite”: 0 }, “contextWindow”: , ”
maxTokens”: 8192 } ] } 3. 配置参数详解 | 参数名 | 说明 | 示例值 | 注意事项 | |
–
–
–
–
–
–
–
–|
–
–
–
–
–
–|
–
–
–
–
–
–
–
–|
–
–
–
–
–
–
–
–
–
–| | `baseUrl` | API端点地址 | `https://dashscope.aliyuncs.com/compatible
–mode/v1` | 必须
使用阿
里云百炼的兼容模式端点 | | `apiKey` | 认证密钥 | 阿
里云百炼获取的API Key | 需要替换为实际可用的密钥 | | `api` | API类型 | `openai
–completions` | 保持固定值确保兼容性 | | `id` | 模型标识 | `
qwen
–
max` | 必须
与阿
里云百炼中的模型ID一致 | | `name` | 显示名称 | `
Qwen3
Max` | 在
OpenClaw界面中显示的名称 | | `contextWindow` | 上下文长度 | | 根据模型实际能力设置 | | `
maxTokens` | 最大生成长度 | 8192 | 控制单次生成的最大token数 | 4. 获取API Key的步骤 要成功配置
Qwen3模型，需要先在阿
里云百炼平台获取有效的API Key： python # 示例：阿
里云百炼API调用代码 import requests def get_
qwen3_response(api_key, model_id, prompt): headers = { “Authorization”: f”Bearer {api_key}”, “Content
–Type”: “application/json” } data = { “model”: model_id, “messages”: [{“role”: “user”, “content”: prompt}], “stream”: False } response = requests.post( “https://dashscope.aliyuncs.com/compatible
–mode/v1/chat/completions”, headers=headers, json=data ) return response.json() #
使用示例 api_key = “your_actual_api_key_here” response = get_
qwen3_response(api_key, ”
qwen
–
max“, “你好，请介绍一下自己”) 模型回退队列配置 为了解决模型
额度耗尽导致服务中断的
问题，建议配置模型回退队列： json “agents”: { “defaults”: { “model”: { “primary”: ”
qwen3/
qwen
–
max“, “fallbacks”: [ ”
qwen3/
qwen
–
max“, ”
qwen3/
qwen
–turbo”, ”
qwen3/
qwen
–plus”, ”
qwen3/
qwen
–flash”, “deepseek/deepseek
–coder”, ”
qwen
–portal/coder
–model” ] }, “models”: { ”
qwen3/
qwen
–turbo”: { “alias”: ”
qwen3
–turbo” }, ”
qwen3/
qwen
–plus”: { “alias”: ”
qwen3
–plus” }, ”
qwen3/
qwen
–
max“: { “alias”: ”
qwen3
–
max” }, ”
qwen3/
qwen
–flash”: { “alias”: ”
qwen3
–flash” } }, “workspace”: “/your/actual/workspace/path”, “compaction”: { “mode”: “safeguard” } } } 验证配置有效性 配置完成后，可以通过以下方式验证模型是否成功添加： bash # 重启
OpenClaw服务使配置生效
openclaw restart # 检查模型列表
openclaw models list # 测试特定模型
openclaw chat
–
–model
qwen3
–
max 常见
问题排查 1. API Key认证失败 症状：模型配置后无法正常调用 解决方案：
– 确认API Key是否正确且未过期
– 检查阿
里云百炼账户余额是否充足
– 验证API Key是否具有对应模型的访
问权限 2. 模型无法识别 症状：配置后模型
不在可选列表中 解决方案：
– 检查JSON格式是否正确，特别是括号匹配
– 确认模型ID
与阿
里云百炼中的标识完全一致
– 验证配置文件路径是否正确 3. 回退队列
不生效 症状：主模型失败后未自动切换 解决方案：
– 检查fallbacks数组中的模型名称是否
与models配置一致
– 确认所有备用模型都已正确配置且可用
– 查看日志文件确认错误信息 通过以上完整的配置流程，用户可以成功在
OpenClaw中添加并
使用阿
里云百炼平台上的各种
Qwen3系列大模型，大大扩展了
OpenClaw的应用能力和灵活性[ref_1]。这种自定义配置方式
不仅解决了官方模型列表有限的
问题，还为用户提供了更加个性化的AI助手体验。