OpenClaw 本地部署指南：隧道配置与百炼模型接入

OpenClaw 支持接入阿里云百炼 API。你需要准备好以下信息：

• 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 配置到环境变量，避免硬编码导致泄露风险。

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

修改配置文件

OpenClaw 的配置校验较严格，字段错误可能导致网关无法启动。你可以通过 Web UI 或手动编辑配置文件来设置。

Web UI 方式

openclaw dashboard

浏览器打开 http://127.0.0.1:18789/ 进行图形化配置。

手动编辑

编辑 ~/.openclaw/openclaw.json 文件（旧版路径为 ~/.clawdbot/clawdbot.json）。以下是一个基于阿里云百炼 qwen3-max-2026-01-23 模型的配置示例：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3-max-2026-01-23"
      }
    }
  },
  "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

最后，尝试发送一条消息验证 Agent 功能：

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

至此，OpenClaw 的基础部署与模型接入已完成。后续可根据需求接入飞书等更多聊天平台。