OpenClaw (原 Clawdbot / Motbot) 是一个开源的个人 AI 智能体平台，可本地或云端部署，通过聊天工具（如微信、飞书、WhatsApp）调用大模型（如阿里云百炼、移动云、第三方 API）完成聊天、文件处理、网页自动化等任务。
本教程将引导你完成 OpenClaw 的安装、配置及接入模型的全过程。
------
📋 1. 环境准备
1.1 系统要求
• Windows: Windows 10/11 (推荐 WSL2 + Ubuntu 22.04)
• macOS: 13+
• Linux: Ubuntu 20.04+ 或其他主流发行版
1.2 硬件建议
• 本地运行: 内存 ≥ 4GB，磁盘 ≥ 20GB。
• 云服务器 (7x24): 2核2GB起步，复杂场景建议4核4GB。
1.3 账号与模型服务
你需要一个兼容 OpenAI 接口的大模型服务。常见选择如下：
服务商 模型示例 关键配置/说明
阿里云百炼 qwen3.5-plus, qwen3-coder-next baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1 (地域需与Key匹配)
移动云 GLM-4.6, DeepSeek V3.1 baseUrl: http://zhenze-huhehaote.cmecloud.cn/v1
第三方 API claude-sonnet-4-6 需注册获取 API Key，如 lingyaai.cn 等。
------
🛠️ 2. 安装 OpenClaw
2.1 通用前置：安装 Node.js
OpenClaw 要求 Node.js ≥ 22.x。推荐使用 nvm 进行管理。
bash
安装 nvm (以 bash/zsh 为例)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh(https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh) | bash
source ~/.bashrc # 或 source ~/.zshrc
安装并使用 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22
验证版本
node -v # 应输出版本号，如 v22.x.x
npm -v # 应输出版本号
2.2 macOS / Linux 安装
在终端中执行以下任一命令即可。
• 官方脚本 (推荐)
bash
curl -fsSL https://openclaw.ai/install.sh(https://openclaw.ai/install.sh) | bash
• npm 全局安装
bash
设置国内镜像源可加速
npm config set registry https://registry.npmmirror.com(https://registry.npmmirror.com)
npm install -g openclaw@latest
2.3 Windows 安装
• 方式一：WSL2 + Ubuntu (推荐)
1. 在 PowerShell (管理员) 中启用 WSL 和虚拟机平台。
2. 重启后，下载并安装 WSL2 内核更新包。
3. 设置 WSL2 为默认版本：wsl --set-default-version 2。
4. 安装 Ubuntu 22.04：wsl --install Ubuntu-22.04。
5. 进入 WSL 终端，参考 2.1 节安装 Node.js，然后执行 2.2 节的安装命令。
• 方式二：PowerShell 脚本
1. 以管理员身份打开 PowerShell。
2. 允许执行脚本：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser。
3. 执行安装脚本：
powershell
iwr -useb https://openclaw.ai/install.ps1(https://openclaw.ai/install.ps1) | iex
4. 国内用户可使用加速脚本：
powershell
iwr -useb https://open-claw.org.cn/install-cn.ps1(https://open-claw.org.cn/install-cn.ps1) | iex
2.4 验证安装
在终端或 PowerShell 中执行，若输出版本号则表示成功。
bash
openclaw --version
------
⚙️ 3. 初始化配置
首次安装后，建议运行配置向导。
bash
openclaw onboard
向导关键步骤：
1. 风险提示: 输入 Yes 继续。
2. 引导模式: 选择 QuickStart (快速开始)。
3. 模型提供商: 选择 Skip for now (稍后配置)。
4. 消息渠道: 选择 Skip for now (稍后配置)。
5. 技能 (Skills): 选择 No (稍后配置)。
6. Hooks: 按需选择，或直接回车跳过。
7. 启动方式: 新手推荐选择 Web UI。
向导结束后，会自动打开 Web 控制台 (通常是 http://127.0.0.1:18789)，并显示一个 Token。如果未自动打开，请手动访问该地址并输入 Token。
------
🔗 4. 接入大模型
4.1 通用配置思路
无论接入哪家模型，都需要在 OpenClaw 的配置文件 openclaw.json 中进行三项核心设置：
1. Providers: 定义模型服务的 baseUrl 和 apiKey。
2. Models: 声明可用的模型列表，注意将 reasoning 设为 false。
3. Agents: 指定默认使用的模型。
配置文件通常位于用户主目录下的 .openclaw 文件夹中 (~/.openclaw/openclaw.json)。
4.2 接入示例
• 阿里云百炼
json
{
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1(https://dashscope.aliyuncs.com/compatible-mode/v1)",
"apiKey": "你的百炼API Key",
"api": "openai-completions",
"models": [
{
"id": "qwen3.5-plus",
"name": "qwen3.5-plus",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 1000000,
"maxTokens": 65536
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "bailian/qwen3.5-plus"
},
"models": {
"bailian/qwen3.5-plus": {}
}
}
}
}
• 移动云
json
{
"models": {
"mode": "merge",
"providers": {
"cmss": {
"baseUrl": "http://zhenze-huhehaote.cmecloud.cn/v1(http://zhenze-huhehaote.cmecloud.cn/v1)",
"apiKey": "你的移动云API Key",
"api": "openai-completions",
"models": [
{
"id": "GLM-4.6",
"name": "GLM-4.6",
"reasoning": false,
"input": ["text"],
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "cmss/GLM-4.6"
},
"models": {
"cmss/GLM-4.6": {}
}
}
}
}
• 第三方 API (如 lingyaai.cn)
json
{
"models": {
"mode": "merge",
"providers": {
"lyapi": {
"baseUrl": "https://api.lingyaai.cn/v1(https://api.lingyaai.cn/v1)",
"apiKey": "你的第三方API Key",
"api": "openai-completions",
"models": [
{
"id": "claude-sonnet-4-6",
"name": "claude-sonnet-4-6",
"reasoning": false,
"input": ["text", "image"],
"contextWindow": 200000,
"maxTokens": 32000
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "lyapi/claude-sonnet-4-6"
},
"models": {
"lyapi/claude-sonnet-4-6": {}
}
}
}
}
4.3 应用配置
修改 openclaw.json 后，需重启服务使配置生效。
• 若使用 Web UI: 在控制台右上角点击 Save 保存，然后点击 Update 重启。
• 若使用命令行: 执行 openclaw gateway restart 重启网关服务。
------
🚀 5. 启动与测试
5.1 Web UI 对话
在浏览器中访问 http://127.0.0.1:18789 (或你的服务器IP:端口)，输入 Token 登录。在对话框中发送消息即可与 AI 交互。
5.2 终端对话 (TUI)
在终端中执行以下命令启动文本界面客户端，可直接在命令行聊天。
bash
openclaw tui
------
☁️ 6. 云端部署 (以阿里云为例)
1. 创建实例: 在阿里云购买轻量应用服务器，选择 OpenClaw 官方镜像，地域推荐香港/新加坡，配置至少 2核2GB。
2. 放行端口: 在服务器安全组中放行 18789 端口。
3. 登录与启动: SSH 登录服务器，执行预检脚本、启动服务并设置开机自启。
bash
执行预检脚本
curl -fsSL https://gitee.com/openclaw-team/script/raw/main/2026/precheck_aliyun.sh(https://gitee.com/openclaw-team/script/raw/main/2026/precheck_aliyun.sh) | bash
启动服务并设置开机自启
systemctl start openclaw
systemctl enable openclaw
systemctl status openclaw
4. 生成 Token: 执行命令生成管理员 Token。
bash
openclaw token generate --admin
5. 访问: 在浏览器中访问 http://你的服务器公网IP:18789/?token=你的Token 进行管理。
------
🧩 7. 安装 Skills (可选)
Skills 是扩展 OpenClaw 功能的插件，如文件管理、日历等。
• 查看可用 Skills
bash
openclaw skills list
• 安装 Skill
bash
openclaw plugins install @openclaw/file-manager
• 安装后重启服务
bash
openclaw gateway restart
------
🔧 8. 常见问题排查
• openclaw: command not found: 检查 Node.js 和 npm 是否正确安装，或将 npm 全局路径添加到系统 PATH 环境变量中。
• Web UI 无法访问: 检查服务器防火墙或云安全组是否已放行 18789 端口。
• 模型调用失败: 核对 openclaw.json 中的 apiKey、baseUrl 和模型 id 是否正确，并确保模型服务已开通且有可用额度。
• WhatsApp 无法连接: 确保服务器网络可访问 WhatsApp，并在 OpenClaw 控制台重新扫码登录。
