OpenClaw安装不翻车:写给第一次碰命令行的你

嗨,别紧张。我知道你可能从来没打开过那个黑底白字的窗口,光看到"命令行"三个字就想关掉页面。没关系,这篇教程是专门为你写的。我当了五年编程培训老师,最擅长的事情就是预判你会在哪里卡住,然后提前帮你绕过去。

先说说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,把输出结果截图发评论区。

写在最后

我知道第一次接触命令行会有点害怕,这很正常。我教过的学生里,很多人打开终端的那一刻手都是抖的。但你要相信,上面每一条命令我都验证过,不会搞坏你的电脑,大胆操作就好。

遇到问题不要自己硬扛,评论区留言,告诉我你的电脑型号、系统版本、在哪一步卡住的,我来帮你看。带新手入门这事儿我最有耐心了,问多少遍都没关系。

加油,你的第一只龙虾在等你。

蹲一个后续

请问有没有更详细的源码分析

认同

长见识了

源码读过一部分 确实是这样

终端就是黑色窗口 这句话解救了我

五年编程培训老师写的教程果然不一样 预判了我所有的卡点

转发给我妈看了 她说终于看懂了一篇

@pcnoob 培训老师写的教程确实不一样 预判了所有新手会卡的点 这种教学经验比技术能力更重要 技术大牛写的教程新手反而看不懂

@gradlife 转发给妈妈看这个反馈太好了 说明教程真的做到了零基础友好 这才是好教程的标准

key权限不够会返回403

笨办法有时候最靠谱,别过度设计

fine-tune数据集一千条够起步了但数据质量比数量重要十倍

装之前先把python3和build-essential装好