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

配置大模型（阿里云百炼）

OpenClaw 支持通过 models.providers 添加自定义模型提供商。阿里云百炼 API 调用支持 OpenAI-compatible 接口。

准备工作

• 登录阿里云百炼大模型服务平台。
• 获取 API Key（密钥管理页面创建）。
• 确定模型调用地址 base_url：https://dashscope.aliyuncs.com/compatible-mode/v1
• 确定模型名称 model code：如 qwen-plus, qwen3-max 等。

若使用的是百炼 Coding Plan，需替换 API Key 和调用地址：

• base_url：https://coding.dashscope.aliyuncs.com/v1
• model code：如 qwen3-max-2026-01-23 等

配置环境变量

建议将 API Key 配置到环境变量，避免硬编码泄露风险。

1. 查看默认 Shell 类型。
2. 将环境变量追加到 ~/.bash_profile：

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

3. 使变更生效：

   source ~/.bash_profile
   

修改配置文件

OpenClaw 配置严格校验，字段错误可能导致 Gateway 无法启动。如有报错，可运行 openclaw doctor 排查。 模型引用格式为 provider/model。可选择 Web UI 或手动编辑 ~/.openclaw/openclaw.json。

Web UI 方式

openclaw dashboard

浏览器打开 http://127.0.0.1:18789/ 进行配置。（此处显示 OpenClaw Dashboard 界面）

手动编辑示例 以阿里云百炼 qwen3-max 模型为例，可直接复制以下配置：

{
  "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 restart

或通过以下指令检查模型是否被识别：

openclaw models list

若要测试真实连通性（可能产生费用），可运行：

openclaw models status --probe

最后，可通过 CLI 发起对话验证：

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