OpenClaw 本地部署、隧道映射与大模型接入指南

例如：

ssh -L 18789:127.0.0.1:18789 -L 18800:127.0.0.1:18800 [email protected]

2. 登录与访问

输入服务器密码完成 SSH 登录后，即可通过浏览器访问：

http://127.0.0.1:18789/?token=<您的 GATEWAY_TOKEN>

配置大模型

OpenClaw 支持接入阿里云百炼等兼容 OpenAI 接口的模型提供商。你需要准备好以下信息：

• API Key：登录阿里云百炼大模型服务平台，在密钥管理页面创建并复制。 • Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1 • Model Code：如 qwen-plus, qwen3-max 等。

如果是百炼 Coding Plan，请替换为专属地址：

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

环境变量配置

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

1. 查看 Shell 类型：

echo $SHELL

2. 将变量追加到配置文件（以 Bash 为例）：

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

3. 使配置生效：

source ~/.bash_profile

修改配置文件

OpenClaw 的配置校验较严格，字段错误或多余可能导致 Gateway 无法启动。如有报错，可先运行 openclaw doctor 排查。

模型引用格式为 provider/model。你可以通过 Web UI 或手动编辑配置文件来设置。

Web UI 方式

openclaw dashboard

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

手动编辑

直接编辑 ~/.openclaw/openclaw.json 文件。以下是基于阿里云百炼 qwen3-max-2026-01-23 模型的配置示例，可直接复制使用：

{"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 中运行 Agent 进行测试：

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