OpenClaw 是一款强大的 AI 自动化工具，支持在本地 Linux Ubuntu 系统上快速部署，无需依赖云服务器即可体验 AI 编程与对话能力。相比云端部署方案，本地部署 OpenClaw 更适合个人学习、测试调试、AI 自动化实验等场景，用户仅需支付 API 调用成本。目前阿里云百炼平台针对新用户推出了首月仅需 7.9 元的 Coding Plan 编程套餐，单次订阅即可使用 8 款主流大模型（Qwen3.5、GLM-5、MiniMax M2.5、Kimi K2.5 等），性价比极高。本文将手把手教你如何在 Linux Ubuntu 系统上完成 OpenClaw 的完整部署与配置。
一、前提条件
- 一个 Linux Ubuntu 环境
- 安装 Node.js 22 以上版本（下文详解）
- 一个有效的 API KEY（下文详解）
二、Node.js 安装及版本检查
1、安装 nvm 工具
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
2、启动 nvm
source ~/.bashrc
3、通过 nvm 安装 Node.js 22.x 最新版本
nvm install 22
4、将当前终端会话的 Node.js 版本切换到 22.x
nvm use 22
三、使用 npm 安装 OpenClaw
1、全局安装 OpenClaw
确认 Node.js >= v22 后，请执行以下安装命令：
npm install -g openclaw@latest
2、验证安装（查看 OpenClaw 版本）
openclaw –version
若提示 "command not found"，可能是 npm 全局路径未加入系统 PATH，重启终端即可解决；若还是无法解决，检查 npm 全局路径：npm prefix -g，然后把返回的路径加入 PATH 环境变量即可。
3、启用 OpenClaw 配置向导
使用以下命令完成初始化配置：
openclaw onboard –install-daemon
OpenClaw 配置向导流程：
（1）风险确认
启动向导后，首先会看到风险确认提示，此处选择 Yes 继续即可。
若你此前安装过 OpenClaw，还会出现配置处理选项：
- 首次安装：通常不会出现该提示，直接进入下一步
- 重装/更换模型：推荐选 Update values（保留其他稳定配置，仅更新需要调整的项）
- 完全重置配置：选 Reset（谨慎操作，会清空所有原有配置）
（2）选择部署模式（Onboarding mode）
- QuickStart：新手、想快速启动使用，自动配置官方推荐的基础设置
- Manual：需完全掌控所有配置项，需逐个手动配置每一项参数
建议首次部署优先选 QuickStart，后续可随时在配置中修改参数。
（3）选择模型厂商（Provider）
这里先选择 "Skip for now" 跳过，我们后面会配置。
（4）按提供商筛选模型
选择 "All providers"。
（5）默认模型
选择第一个保持当前。
（6）配置 Channel（建议先跳过）
在 QuickStart 模式下，首次部署建议直接选 "Skip for now"（后续接入社交平台可更新配置）。
（7）配置 Skills
这里先选择 "No"。
（8）在特定命令触发时自动执行预设动作（建议最小化开启）
选择 boot-md 和 session-memory（按空格键选中）。
（9）重启网关
选择第一个即可。到目前为止已完成 OpenClaw 配置向导。
四、购买并接入阿里百炼 Coding Plan
1、购买阿里百炼 Coding Plan 并获取 API Key
访问阿里云官网，顶部导航栏产品部分找到"大模型服务器平台百炼"。进入阿里云百炼平台点击顶部 "Coding Plan" 即可购买。
Coding Plan 套餐版本如下：
- Lite 基础版：40元/月，首月 7.9 元，每月 18000 次请求
- Pro 高级版：200元/月，首月 39.9 元，每月 90000 次请求
支付完成后在 Coding Plan 页面找到 API Key（一般格式为 sk-sp-xxxxx，和百炼通用的 sk-xxxxx 略有区别）。
2、接入阿里百炼 Coding Plan
（1）在终端执行以下命令打开 Web UI：
openclaw dashboard
（2）在 Web UI 的左侧菜单栏中选择配置 > All Settings > RAW。
复制以下内容到 Raw JSON 输入框，替换已有内容。将 YOUR_API_KEY 替换为 Coding Plan 专属 API Key。
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"apiKey": "YOUR_API_KEY",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 65536
},
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-2026-01-23",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 65536
},
{
"id": "qwen3-coder-next",
"name": "qwen3-coder-next",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 65536
},
{
"id": "qwen3-coder-plus",
"name": "qwen3-coder-plus",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 65536
},
{
"id": "MiniMax-M2.5",
"name": "MiniMax-M2.5",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 204800,
"maxTokens": 131072
},
{
"id": "glm-5",
"name": "glm-5",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 202752,
"maxTokens": 16384
},
{
"id": "glm-4.7",
"name": "glm-4.7",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 202752,
"maxTokens": 16384
},
{
"id": "kimi-k2.5",
"name": "kimi-k2.5",
"reasoning": false,
"input": ["text", "image"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 32768
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus"
},
"models": {
"bailian/qwen3.5-plus": {},
"bailian/qwen3-max-2026-01-23": {},
"bailian/qwen3-coder-next": {},
"bailian/qwen3-coder-plus": {},
"bailian/MiniMax-M2.5": {},
"bailian/glm-5": {},
"bailian/glm-4.7": {},
"bailian/kimi-k2.5": {}
}
}
},
"gateway": {
"mode": "local"
}
}单击右上角 Save 保存，然后单击 Update 使配置生效。
保存成功后，apiKey 将显示为 "__OPENCLAW_REDACTED__"。这是脱敏保护，仅用于前端界面隐藏，不影响实际调用。
五、本地使用 OpenClaw
完成以上配置后，即可在 Web UI 中进行 AI 对话，体验多模型切换和编程辅助功能。
六、OpenClaw 提示未授权"身份验证失败"解决方法
输入 WebUI 地址后页面提示类似「未授权」「连接拒绝」「Token 无效」等错误时，可按以下步骤解决：
检查 WebUI 访问凭证（Token）
未授权大概率是 Token 错误或缺失：重新在终端执行 openclaw dashboard –no-open 获取 Token 命令，复制完整带 Token 的 URL 复制到网关令牌，成功后右上角版本和健康状态呈绿色。
若怀疑 Token 泄露，执行 openclaw token reset 重置 Token 后重新获取。
后续可扩展对接钉钉、飞书、Telegram、Notion、GitHub 等平台，需简单配置即可实现。无平台依赖时，WebUI 是最基础、安全的使用方式，新手可优先掌握。
