OpenClaw 是一款开源 AI 个人助手，支持本地部署及多系统兼容。介绍其安装步骤，包括 Node.js 环境检查、一键脚本安装、网关启动及 SSH 隧道配置以实现外网访问。同时涵盖阿里云百炼 API Key 获取、环境变量配置及模型配置文件修改方法，最后提供验证模型连通性的指令，帮助用户实现自动化任务处理。
OpenClaw（原 Clawdbot/Moltbot）是一款开源的 AI 个人助手，支持本地部署，兼容 MacOS、Windows 及 Linux 等多种系统。它支持接入常用聊天工具，让用户能够通过自然语言来控制各种设备和服务。
作为一个功能强大的自动化工具，OpenClaw 支持 Qwen、Claude、GPT 等主流大语言模型，能够帮助用户处理邮件、日程安排、市场调研等多种自动化任务。
确认 Node.js 版本，OpenClaw 要求 Node >= 22。如果不是 22+，需要先升级 Node（可用 nvm / fnm / brew）。
node -v
根据官方指引，可以选择不同的安装方式。
推荐官方一键安装的脚本：
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
或者通过全局安装的方式：
npm install -g openclaw@latest
或
pnpm add -g openclaw@latest
向导将设置网关、认证和聊天平台。
openclaw onboard --install-daemon
脚本跑完后，会显示 onboarding 指引，说明安装成功。
如果在向导中安装了服务，网关应该已经运行。
openclaw gateway status
手动运行（前台）：
openclaw gateway --port 18789 --verbose
官方推荐使用 http://127.0.0.1:18789/。如果本地不能直接访问，需要建立隧道才能访问。
在你的本地电脑上执行如下命令（不是在远程服务器执行）：
ssh -L 18789:127.0.0.1:18789 -L 18800:127.0.0.1:18800 root@<ECS 公网 IP 地址>
例如：
ssh -L 18789:127.0.0.1:18789 -L 18800:127.0.0.1:18800 [email protected]
输入 ECS 服务器密码后，完成 SSH 登录。再访问 http://127.0.0.1:18789/?token=<您的 GATEWAY_TOKEN> 即可正常通过隧道登录。
开通获取阿里云百炼 API Key。OpenClaw 支持使用 models.providers（或 models.json）来添加自定义模型提供商或与 OpenAI/Anthropic 兼容的代理服务。
阿里云百炼的模型 API 调用支持 OpenAI-compatible 接口，你只需要登录阿里云百炼大模型服务平台准备好：
https://dashscope.aliyuncs.com/compatible-mode/v1qwen-plus, qwen3-max 等如何获取 API key？登录阿里云百炼大模型服务平台，点击密钥管理页面，单击创建 API-KEY，复制即可通过 API KEY 调用大模型。
如果你使用的是百炼 Coding Plan，记得替换 API key 和模型调用地址：
https://coding.dashscope.aliyuncs.com/v1qwen3-max-2026-01-23 等建议把 API Key 配置到环境变量，避免在代码里显式地配置 API Key，降低泄露风险。
~/.bash_profile 文件中。用您的阿里云百炼 API Key 代替 YOUR_DASHSCOPE_API_KEY。echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'">>~/.bash_profile
执行以下命令，使变更生效：
source ~/.bash_profile
注：OpenClaw 配置是严格校验的，字段写错/多写，Gateway 可能直接跑不起来；如果出问题报错，可以先跑 openclaw doctor 看报错。
OpenClaw 模型引用是 provider/model 的格式，我们需要按照可解析的方式把模型信息放到配置里。你可以选择 Web UI 方式，或手动编辑配置文件，进行配置。
openclaw dashboard
浏览器打开 http://127.0.0.1:18789/。
或者手动编辑配置信息到 ~/.openclaw/openclaw.json 里。
{
"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 stop
等待 2-3 秒后启动服务：
openclaw gateway start
openclaw gateway restart
你还可以通过以下指令看刚刚设置的模型是否被识别：
openclaw models list
你还可以通过以下指令进行一次真实连通探测（会发真实请求，可能产生费用）：
openclaw models status --probe
或通过以下指令在 CLI 跑一轮 agent：
openclaw agent --agent main --message "介绍下阿里云百炼"
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online