OpenClaw 安装配置指南：本地部署、隧道访问与百炼模型接入

阿里云百炼的模型 API 调用支持 OpenAI-compatible 接口，你只需要登录阿里云百炼大模型服务平台准备好：

• 阿里云百炼 API key
• 模型调用地址 base_url：https://dashscope.aliyuncs.com/compatible-mode/v1
• 模型名称 model code：如 qwen-plus, qwen3-max 等

如何获取 API key？登录阿里云百炼大模型服务平台，点击密钥管理页面，单击创建 API-KEY，复制即可通过 API KEY 调用大模型。

如果你使用的是百炼 Coding Plan，记得替换 API key 和模型调用地址：

• 阿里云百炼 API key：获取百炼 Coding Plan 专属 API Key
• 模型调用地址 base_url：https://coding.dashscope.aliyuncs.com/v1
• 模型名称 model code：如 qwen3-max-2026-01-23 等

配置 API Key 到环境变量

建议把 API Key 配置到环境变量，避免在代码里显式地配置 API Key，降低泄露风险。

1. 在终端中执行以下命令，查看默认 Shell 类型。
2. 执行以下命令来将环境变量设置追加到 ~/.bash_profile 文件中。用您的阿里云百炼 API Key 代替 YOUR_DASHSCOPE_API_KEY。

echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'">>~/.bash_profile

执行以下命令，使变更生效：

source ~/.bash_profile

修改 OpenClaw 配置文件

注：OpenClaw 配置是严格校验的，字段写错/多写，Gateway 可能直接跑不起来；如果出问题报错，可以先跑 openclaw doctor 看报错。

OpenClaw 模型引用是 provider/model 的格式，我们需要按照可解析的方式把模型信息放到配置里。你可以选择 Web UI 方式，或手动编辑配置文件，进行配置。

Web UI 方式

openclaw dashboard

浏览器打开 http://127.0.0.1:18789/。

手动编辑

或者手动编辑配置信息到 ~/.openclaw/openclaw.json 里。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3-max-2026-01-23"
      }
    },
    "models": {
      "bailian/qwen3-max-2026-01-23": {
        "alias": "通义千问 Max Thinking 版"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-max-2026-01-23",
            "name": "通义千问 Max Thinking 版",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0.0025,
              "output": 0.01,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 262144,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

配置生效 + 验证模型状态

在终端运行以下指令，保证配置能够生效：

方式一：停止服务后，再启动服务

openclaw gateway stop

等待 2-3 秒后启动服务：

openclaw gateway start

方式二：直接使用重启命令

openclaw gateway restart

你还可以通过以下指令看刚刚设置的模型是否被识别：

openclaw models list

你还可以通过以下指令进行一次真实连通探测（会发真实请求，可能产生费用）：

openclaw models status --probe

简单对话场景验证模型调用

或通过以下指令在 CLI 跑一轮 agent：

openclaw agent --agent main --message "介绍下阿里云百炼"