在 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.yaml

3. 配置阿里云百炼参数

在配置文件的 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-max"

JSON 格式 (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_ID="LTAI5txxxxxxxxxxxxxxx"
export ALIYUN_ACCESS_KEY_SECRET="K4Jhxxxxxxxxxxxxxxxxxxxxxxxx"

然后在 config.yaml 中引用：

access_key_id: ${ALIYUN_ACCESS_KEY_ID}
access_key_secret: ${ALIYUN_ACCESS_KEY_SECRET}

5. 验证配置并重启服务

1. 保存配置文件。
2. 重启 OpenClaw 服务使配置生效：

   # 或根据你的部署方式，在项目目录执行    # npm run start 或 ./scripts/start.sh ```
   

3. 验证连接：

   # 检查服务健康状态
   curl http://localhost:18789/api/health | jq '.llm_status'
   # 或通过 Web 控制台 (通常为 http://localhost:3000) 发送测试消息 
   

常见问题排查

问题现象	可能原因	解决方案
Authentication failed / Invalid API Key	1. API Key 填写错误或含有空格/换行 。 2. 未开通对应模型服务或额度不足 。	1. 仔细核对并重新粘贴 Key 。 2. 登录百炼控制台检查服务开通状态和余额 。
Connection timeout / Network error	服务器无法访问百炼 API 端点 。	检查服务器网络，确保可访问 dashscope.aliyuncs.com，并配置安全组允许443 端口出站 。
Model not available	1. 配置的模型名称错误 。 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）