嗨,别紧张。我知道你可能从来没打开过那个黑底白字的窗口,光看到"命令行"三个字就想关掉页面。没关系,这篇教程是专门为你写的。我当了五年编程培训老师,最擅长的事情就是预判你会在哪里卡住,然后提前帮你绕过去。
先说说OpenClaw是什么(用你能听懂的话)
OpenClaw就是一个装在电脑上的AI助手。它跟ChatGPT的区别是:ChatGPT住在网上,OpenClaw住在你电脑里。它能帮你写文案、整理数据、自动操作电脑上的软件,就像雇了一个不睡觉的实习生。
好了,背景知识够用了。下面开始装。
你的电脑能装吗?
先确认一下,满足以下任意一条就行:
- Windows 10或更高版本的电脑
- 苹果Mac电脑(macOS 12以上)
- 内存至少8GB(不知道怎么看?往下读)
怎么看自己的电脑配置?
Windows用户:右键"此电脑" → “属性”,里面写着内存和系统版本。
Mac用户:点左上角苹果图标 → “关于本机”,一目了然。
如果你的电脑内存只有4GB,也能跑,但会有点慢。8GB以上就完全没问题。不需要显卡、不需要高配CPU,你现在用的电脑大概率就够了。
Windows用户:一步一步来
第1步:打开PowerShell
你可能会问:PowerShell是什么?就是一个可以输入命令的窗口。
操作方法:在屏幕左下角的搜索栏(Windows 10)或任务栏上的搜索图标(Windows 11)里,输入"PowerShell"。你会看到一个蓝色图标的程序出现。
注意这里很多人会卡住:一定要右键点它,选"以管理员身份运行"。不用管理员身份的话,后面会报权限错误。系统会弹一个窗口问你"是否允许",点"是"。
你现在应该看到一个深蓝色(或黑色)的窗口,里面有个闪烁的光标。恭喜你,你已经迈出了最难的一步。
第2步:解除脚本限制
在窗口里输入下面这行字(可以直接复制粘贴,在PowerShell里粘贴是右键单击):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
按回车。如果它问你要不要确认,输入 Y 再按回车。
这步在干嘛?Windows默认不允许运行来自网上的脚本,这条命令告诉它"我同意运行可信的脚本"。完全安全,别担心。
第3步:安装OpenClaw
复制粘贴下面这行:
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
按回车,然后等。屏幕上会不停地滚动各种文字,这是正常的,它在自动下载和安装。大概等3~8分钟。
你可能会看到一些黄色的警告文字,不用管。只要窗口没有关闭、没有出现红色的错误文字,就是一切正常。
如果你看到红色文字了,先别慌,截个图,往下看故障排查部分。
第4步:初始化
安装完之后,输入:
openclaw onboard --install-daemon
按回车。它会开始问你一些配置问题,像一个小问卷一样。
这里是新手最容易迷路的地方,我帮你列一下每个问题怎么选:
- 第1个问题:问你是否继续 → 用键盘上下键选到"Yes",按回车
- 第2个问题:问你选什么模式 → 选"QuickStart",按回车
- 第3个问题:问你选什么模型 → 选"Qwen"或"DeepSeek"都行。Qwen免费,DeepSeek便宜
- 后面的问题:如果看不懂,直接按回车(用默认值),或者选"Skip"跳过
配置完之后,它会自动帮你设置好各种东西。
第5步:看看成果
输入:
openclaw dashboard
按回车。你的浏览器会自动打开一个页面,上面有一只龙虾的图标。看到这个页面,就说明你装好了。给自己鼓个掌。
Mac用户:其实更简单
第1步:按 Command + 空格,输入"终端"(或"Terminal"),按回车打开。
第2步:复制粘贴这行命令,按回车:
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
等3~8分钟,如果中间要求输入密码,就输入你的开机密码(输入时屏幕不会显示任何东西,这是正常的,打完按回车就行)。
第3步:输入初始化命令:
openclaw onboard --install-daemon
按照上面Windows第4步的说明选择配置项。
第4步:输入 openclaw dashboard,看到龙虾面板就成功了。
装完之后试一下
在控制面板里找到对话框,给它下达第一个指令:
请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件,并在里面写入:我的第一只龙虾,安装成功了。
然后去桌面看看,是不是真的多了一个文件?如果有,恭喜你,你已经拥有了一个能帮你干活的AI助手。
常见翻车现场和急救方法
“openclaw不是内部命令”
最常见的问题。解决方法很简单:关掉当前的终端/PowerShell窗口,重新打开一个新的,再试一次。90%的情况下这就能解决。
下载特别慢或者超时
可能是网络问题。确保你用的是国内加速脚本(上面给的链接里带"cn"的那个),不要用海外地址。
端口被占用
如果提示18789端口被占用,要么重启一下电脑(最简单粗暴),要么问我怎么手动释放端口(评论区告诉我你的操作系统,我教你)。
什么错误都没报但就是打不开面板
试试手动在浏览器地址栏输入 http://localhost:18789 看看能不能打开。如果还不行,跑一下 openclaw doctor,把输出结果截图发评论区。
写在最后
我知道第一次接触命令行会有点害怕,这很正常。我教过的学生里,很多人打开终端的那一刻手都是抖的。但你要相信,上面每一条命令我都验证过,不会搞坏你的电脑,大胆操作就好。
遇到问题不要自己硬扛,评论区留言,告诉我你的电脑型号、系统版本、在哪一步卡住的,我来帮你看。带新手入门这事儿我最有耐心了,问多少遍都没关系。
加油,你的第一只龙虾在等你。