OpenClaw 本地部署与外网访问配置指南

• Base URL：https://coding.dashscope.aliyuncs.com/v1
• Model Code：如 qwen3-max-2026-01-23

配置环境变量

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

1. 查看 Shell 类型，并将变量追加至 ~/.bash_profile：

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

2. 使配置生效：

source ~/.bash_profile

修改配置文件

OpenClaw 配置校验严格，字段错误可能导致 Gateway 无法启动。如有问题，可运行 openclaw doctor 排查。

模型引用格式为 provider/model。可通过 Web UI 或手动编辑配置文件 ~/.openclaw/openclaw.json 进行修改。

Web UI 方式：

openclaw dashboard

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

手动编辑示例：

以下配置以阿里云百炼 qwen3-max 为例，可直接参考结构：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3-max"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "${DASHSCOPE_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-max",
            "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 直接测试 Agent：

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

至此，基础环境已搭建完成，后续可根据需求接入飞书等聊天工具。