在开始之前，请确保你具备以下环境：

　　从 https://dashscope.console.aliyun.com/apiKey 获取一般以 sk- 开头二、安装 OpenClaw

　　git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install

　　安装完成后，不要急着启动，关键在于配置。

　　OpenClaw 的所有核心行为，都由 openclaw.json 决定。

　　推荐放在项目目录下，例如：

　　.openclaw-data/ └── openclaw.json

　　后面启动时我们会显式指定这个目录。

　　 请务必直接填写真实 API Key，不要用环境变量占位符

　　{ "meta": { "version": "1.0.0" }, "agents": { "defaults": { "model": { "primary": "qwen-portal/qwen-plus" }, "models": { "qwen-portal/qwen-plus": {} }, "maxConcurrent": 4, "subagents": { "maxConcurrent": 8 } } }, "models": { "providers": { "qwen-portal": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "api": "openai-completions", "apiKey": "sk-xxxxxxxxxxxxxxxx", "models": [ { "id": "qwen-plus", "name": "Qwen Plus", "reasoning": false, "input": ["text"], "contextWindow": 128000, "maxTokens": 8192 } ] } } }, "gateway": { "mode": "local", "auth": { "token": "moltx-local-dev" } }, "plugins": { "entries": { "qwen-portal-auth": { "enabled": true } } }}四、几个必踩的坑（提前告诉你）1 baseUrl 配错 = 模型“空回复”

　　 错误示例：

　　https://portal.qwen.ai/v1

　　这是 OAuth / Portal 接口，用 API Key 调用时，模型会直接返回空内容。

　　 正确写法：

　　https://dashscope.aliyuncs.com/compatible-mode/v12 API Key 用环境变量，很容易不生效

　　很多人会写成：

　　"apiKey": "${DASHSCOPE_API_KEY}"

　　如果你不是 100% 确认运行时环境变量已注入，强烈建议直接写死 Key（至少在本地调试阶段）。

　　你只要在 gateway.auth.token 里写了 token：

　　"token": "qianwen-local-dev"

　　那 Web UI 必须填同一个值，否则必然：

　　Unauthorized: gateway token missing五、启动 OpenClaw Gateway（推荐方式）5.1 先清理旧进程

　　pkill -9 -f openclaw-gateway || true5.2 指定配置目录启动（重点）

　　OPENCLAW_STATE_DIR=xxxx/openclaw/.openclaw-data \nohup pnpm openclaw gateway run \ --bind loopback \ --port 18789 \ --force \ > gateway.log 2>&1 &

　　 不指定 OPENCLAW_STATE_DIROpenClaw 会默认读 ~/.openclaw，你改的配置完全不会生效

　　tail -n 20 gateway.log

　　看到以下信息基本就稳了：

1. 打开浏览器访问：
2. http://localhost:18789
3. 如果显示 Disconnected / Unauthorized
4. 点击左下角 Settings
5. 填入 Gateway Token：

　　qianwen-local-dev

6. 保存后自动重连

　　99% 是 baseUrl 配错

　　Web UI 没填 Gateway Token

　　启动时没指定 OPENCLAW_STATE_DIR

　　因为默认配置目录在~/.openclaw, 我用的是trae帮忙跑的，trae是用trae-sandbox环境，需要很多申请很多的权限，我索性就把配置目录设置在项目的根目录下，一切正常运行。跑起来就很舒服了，千问背后的大模型是阿里云百炼，有高额度（1000k）的免费token。每个问题大概消耗12k 的token，如下图

　　问题的答案也很精准

　　我问北京的天气，openclaw会先用Brave API key去web_seach，发现本地没有配置，就自动用mac系统的命令行查询（如下截图）

　　curl -s "wttr.in/Beijingformat=2"

　　欢迎关注我，我会持续输出openclaw 的相关教程，每个都是干货。