夜雨聆风OpenClaw 入门系列：从零基础到独立部署
🦐 葫芦娃说：3 篇文章，从小白到部署高手！
📋 前言
真实案例：大学生小李的故事
小李是大三学生，想学 AI 技术但完全没有基础。
学习前：
❌ 不知道 OpenClaw 是什么 ❌ 没用过命令行 ❌ 担心学不会
学习本系列后：
✅ 独立安装 OpenClaw ✅ 配置了千问大模型 ✅ 能通过微信对话 AI ✅ 帮同学部署了 3 套
本系列适合谁
✅ 完全零基础的小白✅ 想学 AI 但不知道从哪开始✅ 想部署 OpenClaw 给自己用
不需要任何基础！ 跟着步骤操作即可，预计 2-3 小时完成。
📖 学习路径
实践 1 → 实践 2 → 实践 3 ↓ ↓ ↓安装部署 配置模型 基础使用完成本系列后，你将能够：
✅ 独立安装 OpenClaw ✅ 配置大模型 API ✅ 通过控制面板对话 ✅ 查看会话历史 ✅ 调整基础配置
实践 1：Windows10 本地部署 OpenClaw
📋 前言
OpenClaw 是一个开源的 AI 智能体网关，可以把各种大模型集成到微信、WhatsApp 等聊天工具中。
适合人群： 想在本地搭建 AI 助手的小白
预计耗时： 30-60 分钟
🛠️ 准备工作
1. 系统要求
┌─────────────────────────────────────────┐│ 系统要求 │├─────────────────────────────────────────┤│ ││ 操作系统：Windows 10 或 Windows 11 ││ Node.js：22 LTS 或 Node 24（推荐） ││ 网络环境：能访问 GitHub 和 npm ││ 阿里云账号：用于获取千问模型 API Key ││ │└─────────────────────────────────────────┘2. 获取千问模型 API Key
第 1 步： 访问阿里云百炼平台
https://bailian.console.aliyun.com/第 2 步： 登录阿里云账号
┌─────────────────────────────────────────┐│ 阿里云百炼 - 登录 │├─────────────────────────────────────────┤│ ││ 账号：[________________] ││ 密码：[________________] ││ ││ [ 登录 ] ││ │└─────────────────────────────────────────┘第 3 步： 进入 API-KEY 管理页面
┌─────────────────────────────────────────┐│ 百炼控制台 │├─────────────────────────────────────────┤│ ││ 左侧菜单： ││ 📊 概览 ││ 🤖 模型广场 ││ 🔑 API-KEY 管理 ← 点这个 ││ 📈 用量统计 ││ │└─────────────────────────────────────────┘第 4 步： 创建新的 API Key
┌─────────────────────────────────────────┐│ API-KEY 管理 │├─────────────────────────────────────────┤│ ││ 已有密钥：0 个 ││ ││ [ + 创建新的 API-KEY ] ← 点这个 ││ │└─────────────────────────────────────────┘第 5 步： 复制并保存 API Key
┌─────────────────────────────────────────┐│ 创建成功 │├─────────────────────────────────────────┤│ ││ 您的 API Key： ││ sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxx │ ← 复制这个！│ ││ ⚠️ 请妥善保存，只显示一次！ ││ ││ [ 复制 ] [ 完成 ] ││ │└─────────────────────────────────────────┘⚠️ 重要： API Key 具有访问权限，请勿泄露给他人！
📦 第一步：安装 Node.js
方法一：使用官方安装包（简单）
第 1 步： 访问 Node.js 官网
https://nodejs.org/第 2 步： 下载 LTS 版本
┌─────────────────────────────────────────┐│ Node.js 下载 │├─────────────────────────────────────────┤│ ││ LTS 版本（推荐） ││ 📥 node-v22.x-x64.msi (35 MB) ← 点这个 ││ ││ Current 版本 ││ 📥 node-v24.x-x64.msi (38 MB) ││ │└─────────────────────────────────────────┘第 3 步： 运行安装程序
┌─────────────────────────────────────────┐│ Node.js 安装向导 │├─────────────────────────────────────────┤│ ││ 欢迎使用 Node.js 安装程序 ││ ││ 安装路径： ││ [C:\Program Files\nodejs\] ││ ││ [ Next ] ││ │└─────────────────────────────────────────┘第 4 步： 验证安装
┌─────────────────────────────────────────┐│ 命令提示符 │├─────────────────────────────────────────┤│ ││ C:\> node --version ││ v22.x.x ││ ││ C:\> npm --version ││ 10.x.x ││ ││ ✅ 安装成功！ ││ │└─────────────────────────────────────────┘🚀 第二步：安装 OpenClaw
方式一：使用安装脚本（推荐）
在 PowerShell 中执行：
iwr-useb https://openclaw.ai/install.ps1 | iex安装过程：
┌─────────────────────────────────────────┐│ PowerShell 输出 │├─────────────────────────────────────────┤│ ││ 🔍 检测系统环境... ││ ✅ Node.js 22.x 已安装 ││ ✅ npm 10.x 已安装 ││ ││ 📦 安装 OpenClaw... ││ ████████████████████ 100% ││ ││ 🎉 安装完成！ ││ 运行 openclaw init 开始使用 ││ │└─────────────────────────────────────────┘方式二：使用 npm 手动安装
npm install -g openclaw@latest如果遇到 sharp 构建错误：
$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1npm install -g openclaw@latest验证安装
openclaw --version看到版本号说明安装成功！
⚙️ 第三步：配置千问模型
1. 运行新手引导
openclaw onboard --install-daemon按照提示完成：
配置目录位置（默认 ~/.openclaw） 选择渠道（可以先跳过） 设置服务自启动
2. 编辑配置文件
配置文件位于：C:\Users\你的用户名\.openclaw\openclaw.json
用记事本打开：
notepad C:\Users\你的用户名\.openclaw\openclaw.json修改模型配置部分：
{ "agents": { "defaults": { "model": { "primary": "dashscope-api/qwen-turbo", "fallbacks": ["dashscope-api/qwen-plus"] }, "models": { "dashscope-api/qwen-turbo": { "alias": "千问 Turbo", "provider": "dashscope-api", "model": "qwen-turbo" }, "dashscope-api/qwen-plus": { "alias": "千问 Plus", "provider": "dashscope-api", "model": "qwen-plus" } } } }, "providers": { "dashscope-api": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "你的 API_KEY 填在这里" } }}3. 使用 CLI 配置（更简单）
# 设置主模型为千问 Turboopenclaw config set agents.defaults.model.primary "dashscope-api/qwen-turbo"# 设置 API Keyopenclaw config set providers.dashscope-api.apiKey "sk-你的 API_KEY"# 设置 API 基础 URLopenclaw config set providers.dashscope-api.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"🎯 第四步：启动服务
1. 检查配置
openclaw doctor如果有问题会给出修复建议。
2. 启动 Gateway
openclaw gateway --port18789看到以下输出说明启动成功：
┌─────────────────────────────────────────┐│ Gateway 启动 │├─────────────────────────────────────────┤│ ││ ✓ Gateway started on port 18789 ││ ✓ Control UI: http://127.0.0.1:18789 ││ │└─────────────────────────────────────────┘3. 打开控制面板
在浏览器访问：http://127.0.0.1:18789[1]
┌─────────────────────────────────────────┐│ OpenClaw 控制面板 │├─────────────────────────────────────────┤│ ││ 📊 状态：运行中 ✅ ││ 🤖 模型：千问 Turbo ││ 📱 渠道：未配置 ││ ││ [ 聊天 ] [ 技能 ] [ 设置 ] ││ │└─────────────────────────────────────────┘🧪 第五步：测试对话
方法一：在 Control UI 中测试
第 1 步： 打开 http://127.0.0.1:18789[2]
第 2 步： 点击 Chat 标签页
第 3 步： 输入消息发送
┌─────────────────────────────────────────┐│ 聊天界面 │├─────────────────────────────────────────┤│ ││ 你：你好，请用一句话介绍你自己 ││ ││ AI: 你好！我是 OpenClaw，一个可以帮你 ││ 集成各种大模型的 AI 助理网关。 ││ 有什么可以帮你的吗？ ││ ││ [________________________] [发送] ││ │└─────────────────────────────────────────┘🔧 常见问题
1. 找不到 openclaw 命令
原因： npm 全局目录不在 PATH 中
解决：
# 查看 npm 全局目录npm prefix -g# 将该路径添加到系统环境变量 PATH 中2. API Key 无效
检查 API Key 是否正确复制 确认阿里云账号已开通百炼服务 检查是否有足够的额度/余额
3. 网络连接超时
检查是否能访问 dashscope.aliyuncs.com 如果使用代理，设置环境变量
实践 2：配置千问大模型
📋 前言
安装好 OpenClaw 后，需要配置大模型才能使用。本文详细介绍如何配置阿里云通义千问模型。
预计耗时： 20 分钟
🛠️ 千问模型选择
推荐： 初学者使用 qwen-turbo，性价比高。
📦 第一步：配置 API Key
方式一：通过配置文件
编辑 openclaw.json：
{ "providers": { "dashscope-api": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "sk-你的 API_KEY" } }}方式二：通过 CLI 命令
openclaw config set providers.dashscope-api.apiKey "sk-你的 API_KEY"📦 第二步：配置多模型
在 openclaw.json 中添加：
{ "agents": { "defaults": { "models": { "dashscope-api/qwen-turbo": { "alias": "千问 Turbo" }, "dashscope-api/qwen-plus": { "alias": "千问 Plus" }, "dashscope-api/qwen-max": { "alias": "千问 Max" } } } }}聊天时可以用 /model 千问 Max 切换模型。
🧪 第三步：测试模型调用
openclaw message send --target"test"--message"你好"实践 3：基础使用教程
📋 前言
完成安装和配置后，本文教你如何使用 OpenClaw 的基础功能。
预计耗时： 30 分钟
📦 第一步：使用控制面板
1. 打开控制面板
http://127.0.0.1:187892. 界面介绍
┌─────────────────────────────────────────┐│ OpenClaw 控制面板 │├─────────────────────────────────────────┤│ ││ 顶部菜单： ││ [首页] [聊天] [技能] [会话] [设置] ││ ││ 左侧状态： ││ 📊 运行状态 ││ 🤖 当前模型 ││ 📈 今日调用次数 ││ │└─────────────────────────────────────────┘📦 第二步：发送第一条消息
第 1 步： 点击 聊天 标签页
第 2 步： 在输入框输入消息
第 3 步： 点击发送
┌─────────────────────────────────────────┐│ 聊天界面 │├─────────────────────────────────────────┤│ ││ [系统] 会话已开始 ││ ││ 你：你好 ││ ││ AI: 你好！有什么可以帮你的吗？ ││ ││ [________________________] [发送] ││ │└─────────────────────────────────────────┘📦 第三步：查看会话历史
第 1 步： 点击 会话 标签页
第 2 步： 选择要查看的会话
┌─────────────────────────────────────────┐│ 会话列表 │├─────────────────────────────────────────┤│ ││ 💬 会话 1 - 2026-03-29 15:30 ││ 💬 会话 2 - 2026-03-29 14:20 ││ 💬 会话 3 - 2026-03-28 10:15 ││ │└─────────────────────────────────────────┘📦 第四步：调整模型参数
第 1 步： 点击 设置 标签页
第 2 步： 调整参数
┌─────────────────────────────────────────┐│ 模型设置 │├─────────────────────────────────────────┤│ ││ 当前模型：千问 Turbo ││ ││ 温度参数：[0.7 ] ││ （越高越随机，越低越确定） ││ ││ 最大长度：[2048 ] ││ ││ [ 保存 ] ││ │└─────────────────────────────────────────┘📦 第五步：配置会话重置
每天自动重置会话，保持对话新鲜：
{ "session": { "reset": { "mode": "daily", "atHour": 4 } }}🎯 学习检查清单
完成入门系列后，你应该能够：
□ 独立安装 OpenClaw□ 配置大模型 API□ 通过控制面板对话□ 查看会话历史□ 调整模型参数□ 配置会话重置💡 常见问题
Q1: 安装失败怎么办？
A: 检查 Node.js 版本，需要 18+。运行 node -v 查看版本。
Q2: API Key 无效？
A: 确认 API Key 正确复制，没有多余空格。检查阿里云账号是否有余额。
Q3: 无法访问控制面板？
A: 确认 Gateway 已启动，访问 http://127.0.0.1:18789。[3]
📚 下一步学习
完成入门系列后，继续学习：
应用场景系列 → 实践 4-6 企业部署系列 → 实践 7-14
👥 需要帮助？
加入实践群：
微信：iiiBigder 备注：2026openclaw 实践
付费服务：
🛠️ 远程部署（2999 元） 📘 案例合集（499 元）
本文基于 OpenClaw 官方文档整理，最后更新：2026 年 3 月
作者：葫芦娃 🦐 | 微信号：iiiBigder
