好的!我来重新写一版真正适合小白的教程,保证看得懂、跟着做就能成!👌
# 🚀 OpenClaw 新手安装教程(小白专用版)
## 手把手教你,10 分钟搞定 AI 助手!
> 💡 **适合谁**:完全不懂技术的小白
> ⏱️ **需要时间**:10-15 分钟
> ✅ **成功率**:99%(跟着做就行)
---
## 📌 开始前准备
只需要一件事:**用管理员身份打开 PowerShell**
**怎么做?**
1. 按键盘 `Win + S` 打开搜索
2. 输入 `powershell`
3. 在结果上**点右键** → 选择 **"以管理员身份运行"**
4. 看到蓝色窗口就对了!
![示意图:搜索 PowerShell,右键,以管理员身份运行]
---
## 🔹 第 1 步:安装 OpenClaw(只做一次)
在蓝色窗口里,**复制粘贴下面这行命令**,然后按回车:
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
会发生什么:
- 屏幕会滚动一些文字(正常)
- 可能会问你是否允许运行(选"是"或"Y")
- 最后显示
OpenClaw installed successfully 就成功了!
❓ 如果报错了怎么办?
- 检查网络是否正常
- 确认是用管理员身份运行的
- 重试一次
⚠️ 重要:这步只需要做一次!以后重启电脑不用再安装!
🔹 第 2 步:启动服务(每次用之前都要做)
继续在蓝色窗口里,复制粘贴这行命令,按回车:
openclaw gateway start
成功标志:没有报错,直接跳到下一行命令提示符
第一次使用的话,还需要先注册服务:
openclaw gateway install
(这步也只需要做一次)
🔹 第 3 步:配置 API Key(最关键!401 报错就是这里没弄对)
3.1 打开配置界面
在蓝色窗口输入:
openclaw configure --section model
会进入一个图形选择界面(用方向键↑↓选择,回车确认)
3.2 选择服务商
用方向键找到并选中:
Alibaba Cloud Model Studio(阿里云百炼)
按回车确认
3.3 选择认证方式
选中:
Coding Plan API Key for China (subscription)
按回车确认
3.4 获取你的 API Key
打开浏览器,访问阿里云百炼控制台:
- 登录你的阿里云账号
- 找到
Coding Plan 页面
- 复制你的 套餐专属 API Key
长什么样? 以 sk-sp- 开头的一串字符
3.5 粘贴 API Key
回到 PowerShell 的配置界面,直接粘贴你的 API Key,按回车
3.6 选择模型
用方向键和空格键,选中以下模型(选中后前面会有✓):
- ✓ modelstudio/qwen3.5-plus
- ✓ modelstudio/qwen3.5-turbo
- (其他你想要的模型也可以选)
选好后按回车确认
3.7 重启服务让配置生效
openclaw gateway stop
openclaw gateway start
🔹 第 4 步:打开控制面板
在蓝色窗口输入:
openclaw dashboard
会自动打开浏览器,显示 OpenClaw 的控制面板
没自动打开? 手动在浏览器输入这个地址:
http://127.0.0.1:18789/__openclaw__/canvas/
🔹 第 5 步:测试一下!
在控制面板里:
- 选择一个模型(比如
qwen3.5-plus)
- 在对话框输入:
你好
- 按发送
看到 AI 回复你了 = 🎉 完全成功!
❌ 常见问题(出问题了先看这里!)
问题 1:报错 "HTTP 401" 或 "invalid access token"
原因:API Key 没配置对
解决:
- 重新执行第 3 步配置
- 确认选的是
Alibaba Cloud Model Studio
- 确认粘贴的是
sk-sp- 开头的 Key
- 配置完记得重启服务:
openclaw gateway stop 然后 openclaw gateway start
问题 2:命令提示"不是内部或外部命令"
原因:OpenClaw 没安装好,或者没用管理员身份
解决:
- 关闭当前窗口
- 重新以管理员身份打开 PowerShell
- 重新执行第 1 步安装命令
问题 3:网关启动失败
可能原因:端口被占用
解决:
- 关闭所有可能占用 18789 端口的程序
- 重启电脑
- 重新执行
openclaw gateway start
问题 4:找不到 API Key 在哪里
解决:
- 打开浏览器访问:https://bailian.console.aliyun.com/
- 登录阿里云账号
- 左侧菜单找
Coding Plan 或 API Key 管理
- 复制
sk-sp- 开头的那串字符
📝 以后每次怎么用?
电脑重启后,只需要两步:
1. 打开管理员 PowerShell
2. 输入两条命令:
openclaw gateway start
openclaw dashboard
搞定!就可以开始用 AI 了~ ✅
🆘 实在搞不定?
查看错误日志(复制报错内容去求助):
openclaw gateway logs --lines 50
检查服务状态:
openclaw gateway status
社区求助:https://discord.com/invite/clawd
最后更新:2026-03-21
教程帮到你了吗?欢迎回帖反馈~ 📬
---
## ✨ 这版的特点:
| 特点 | 说明 |
|------|------|
| 📖 语言通俗 | 没有技术黑话,大白话讲解 |
| 🎯 每步有目标 | 明确告诉你要做什么、成功长什么样 |
| ❓ 预判问题 | 把小白容易卡住的地方都提前说明了 |
| 🔢 步骤清晰 | 编号+标题,不容易迷路 |
| 🆘 有退路 | 出问题了知道去哪找答案 |
---
**你现在具体遇到什么错误了?** 告诉我,我帮你解决完,把解决方案也加到教程里!🔧