在 OpenClaw 的配置文件中设置阿里云百炼 API-Key核心是修改主配置文件config.yaml或openclaw.json取决于你的部署版本在llm_providers或models部分添加阿里云百炼的配置项 。核心配置步骤1. 获取阿里云百炼 API-Key登录 阿里云百炼控制台进入「API-KEY管理」创建并保存AccessKey ID和AccessKey Secret。注意需确保已开通目标模型如通义千问的服务 。2. 定位并编辑配置文件OpenClaw 的主配置文件通常位于以下路径之一/opt/openclaw/config/config.yaml~/.openclaw/config.json或项目根目录的openclaw.json使用文本编辑器打开配置文件# 以 config.yaml 为例 vim /opt/openclaw/config/config.yaml3. 配置阿里云百炼参数在配置文件的llm_providers或models部分添加或修改阿里云百炼的配置。以下是两种常见配置格式的示例。YAML 格式 (config.yaml) 示例llm_providers: # 配置阿里云百炼提供商 aliyun_bailian: enabled: true access_key_id: LTAI5txxxxxxxxxxxxxxx # 替换为你的 AccessKey ID access_key_secret: K4Jhxxxxxxxxxxxxxxxxxxxxxxxx # 替换为你的 AccessKey Secret region_id: cn-hangzhou # 区域通常为 cn-hangzhou endpoint: dashscope.aliyuncs.com # API 端点 api_version: 2023-06-01-preview # API 版本 # 模型配置 models: default: qwen-max # 默认模型 chat: qwen-max # 对话模型 embedding: text-embedding-v2 # 嵌入模型 # 在技能配置中指定使用百炼 skills: web_search: enabled: true llm_provider: aliyun_bailian # 指定使用百炼提供商 model: qwen-maxJSON 格式 (openclaw.json) 示例 (OpenAI兼容接口模式){ models: { provider: openai, // 使用 OpenAI 兼容接口 openai: { apiKey: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, // 此处填写你的百炼 API Key baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1 // 百炼的 OpenAI 兼容端点 } }, agents: { defaults: { model: { primary: qwen-max // 指定默认使用的模型如 qwen-max, qwen-plus等 } } } }关键说明apiKey格式在 OpenAI 兼容模式下apiKey应填写从百炼控制台获取的完整 API Key形如sk-xxxxxxxxxx而非单独的AccessKey ID和Secret。baseURL必须正确设置为阿里云百炼的 OpenAI 兼容接口地址https://dashscope.aliyuncs.com/compatible-mode/v1。模型名称确保配置的模型名如qwen-max、qwen-plus与百炼平台上已开通且支持的模型一致 。4. 可选通过环境变量配置为提高安全性建议将敏感信息通过环境变量设置并在配置文件中引用 。# 在 ~/.bashrc 或服务启动脚本中设置 export ALIYUN_ACCESS_KEY_IDLTAI5txxxxxxxxxxxxxxx export ALIYUN_ACCESS_KEY_SECRETK4Jhxxxxxxxxxxxxxxxxxxxxxxxx然后在config.yaml中引用access_key_id: ${ALIYUN_ACCESS_KEY_ID} access_key_secret: ${ALIYUN_ACCESS_KEY_SECRET}5. 验证配置并重启服务保存配置文件。重启 OpenClaw 服务使配置生效# 或根据你的部署方式在项目目录执行 # npm run start 或 ./scripts/start.sh 验证连接# 检查服务健康状态 curl http://localhost:18789/api/health | jq .llm_status # 或通过 Web 控制台 (通常为 http://localhost:3000) 发送测试消息常见问题排查问题现象可能原因解决方案Authentication failed/Invalid API Key1. API Key 填写错误或含有空格/换行 。2. 未开通对应模型服务或额度不足 。1. 仔细核对并重新粘贴 Key 。2. 登录百炼控制台检查服务开通状态和余额 。Connection timeout/Network error服务器无法访问百炼 API 端点 。检查服务器网络确保可访问dashscope.aliyuncs.com并配置安全组允许443 端口出站 。Model not available1. 配置的模型名称错误 。2. 该模型在所选区域不可用 。1. 核对百炼平台支持的模型列表使用正确的标识符注意大小写。2. 尝试将region_id改为cn-beijing等其他区域 。配置文件修改未生效1. 配置文件路径错误 。2. 服务未成功重启。1. 确认 OpenClaw 加载的是哪个配置文件检查启动日志。2. 彻底重启 OpenClaw 进程。安全最佳实践密钥管理切勿将包含真实 API Key 的配置文件提交到 Git 等版本控制系统 。始终使用环境变量或密钥管理服务来传递敏感信息 。权限最小化为 OpenClaw 服务创建专用子账户的 API Key并仅授予必要权限 。配置检查修改后务必通过 OpenClaw 的日志文件如/var/log/openclaw/app.log查看是否有相关错误输出这是最直接的排错方式 。参考来源OpenClaw部署API-Key配置全攻略OpenClaw限流有救了免费Nvidia API阿里云百炼接入指南基础能力系列 - 如何安全养虾? - 容器化部署龙虾openclaw-cn接入阿里云百炼coding plan量大管饱OpenClaw 部署阿里百炼千问详细步骤OpenClaw 配置阿里云百炼 API 完全教程Skills 生态 模型接入一次搞定2026
