OpenClaw龙虾本地电脑安装教程,AI新手小白玩虾必备!

今天这篇，教你们如何在自己本地电脑上安装 OpenClaw，适合AI新手和小白，同时把一些高频的问题列举出来。

我以苹果电脑 MacOS 系统为例来解释，Windows 电脑稍微复杂点，但原理是一样的。

这里插一句，在开始下面的安装步骤前，你先需要请一个技术顾问，也就是一个 AI 助手。可以用 DeepSeek 或者豆包或者你平时习惯用的 AI 对话工具。

这个技术顾问的作用，就是在你遇到各种异常和不懂的情况时，你可以直接问它。

第一步，找到终端

Mac如何打开终端

1:应用程序里找到启动台，在里面找到终端

2:直接在桌面右上角🔍按钮，输入终端查找到；

或者快捷键：Command +空格键快速调出搜索框

输入终端查找到

第二步，检查自己本地电脑有没有请过这位翻译（Node.js）。

在终端里输入「node -v」这个指令，注意，node 和 - 之间是有个空格的，或者你也可以直接复制下面这个命令去执行。

node -v

运行之后，你可能会看到两种结果。

第一种，是输出一个类似下图一样的版本号，我电脑之前安装过，所以看到 Node.js 的版本号是 v20.10.0。

还有一种结果，输出的是「zsh: command not found:node」。

看到这个也别急，意思是你电脑上从来没有安装过 Node.js，那么接下来你需要去把这个翻译请到你电脑上来。

第三步，安装/更新 Node.js。

我之所以要说更新，是因为 OpenClaw 对 Node.js 的版本要求是 v22 以上，如果你们安装过且版本低于 v22 的就需要更新。

如果你已经安装过 Node.js 且版本在 v22 以上，那下面这一步可以跳过，直接去看安装 OpenClaw 的部分。

如果你还没安装，那接着往下看。

下一个问题来了，从哪里去请这位翻译（Node.js）？

我们在电脑或者手机上安装软件和 App 时一般会去哪里？其实就是类似软件商店或者 AppStore。

同理，要去下载 Node.js 也要去一个软件商店，这家商店的名字叫 Homebrew。

严格来说，Homebrew 是一个软件包管理器，它的作用是安装、升级、卸载以及配置各种软件包。

要安装 Homebrew，我们就在终端命令行里输入下面这段指令，看不懂没关系（我也看不懂），直接复制粘贴。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

注意，要复制全，这条命令很长，别复制少了，引号也是要带上。【这里有时候复制的时候会出现问题，可以让AI帮你解决】

开始执行后，会提示你输入电脑的开机解锁密码。

注意，你输入的过程中是看不到屏幕上显示密码的，不要觉得是键盘坏了，这一步就是看不到的。

你只要确保密码输入正确即可，然后按回车。

开始执行后会看到一系列命令输出，到这一步要继续按一下回车键，别干等着。

按回车后它才会继续执行，此时就可以等待安装完成。

这个过程可能比较长，如果网速快的话估计几分钟就搞定了，慢的话也要个十几分钟。

如果过程中还需要让你输入电脑开机解锁密码的情况，正常输入即可，这个过程也是看不到屏幕输入显示的。

安装成功后，你会看到终端命令行恢复成让你输入的状态，看到这个提示后，说明安装成功了。

此时你可以输入下面这条指令去验证安装是否成功。

brew -v

如果输出了类似 Homebrew 5.0.16 的版本号，说明这个软件商店管理器就安装成功了。

如果出现 command not found 的提示也别慌，关掉当前终端窗口，重新开一个然后运行上面检查版本号的指令就行。

软件商店准备好了，接下来我们就把翻译请过来，安装 Node.js。

在终端命令行里运行下面这个指令：

brew install node

安装过程也需要一点时间，你依旧会看到一系列命令在执行过程中，稍安勿躁。

安装结束后同样会恢复到可输入的命令行状态，然后，也通过检查版本号的方式来验证一下翻译是否成功就位。

node -v

如果输出的版本号是 v22 以上，说明 Node.js 的运行环境就准备就绪了。

我们就理解了 OpenClaw 的运行环境以及它是如何控制本地电脑的大致逻辑了。

Node.js 是一个运行环境，它是 OpenClaw 和电脑之间的翻译。Homebrew 是一个综合软件商店，是用来安装和管理 Node.js 的。

把 OpenClaw 安装到本地电脑。

接下来就到了激动人心的环节，直接安装 OpenClaw 到本地电脑。

原封不动复制这条指令，然后粘贴到你的终端命令行窗口里：

curl -fsSL https://openclaw.ai/install.sh | bash

然后，你会看到安装程序启动了。

安装过程可能也需要等待一段时间，此时有点耐心。出现任何问题，你都可以去问自己的 AI 技术顾问。

如果安装成功了，命令行会恢复到一开始的输入状态，此时你可以运行这条指令检查是否成功安装。

openclaw -v

如果输出的是一个日期，比如 2026.3.2，说明安装成功了。

注意，这一步输入这条指令也是一样的，都是查看版本号。

openclaw --version

到这一步，我们就把 OpenClaw 成功安装到本地电脑上了。

虽然过程繁多且看起来比较复杂，其实往回看也就三步，安装 Homerew 软件商店、安装翻译 Node.js、安装 Openclaw。

如果抛开我这些讲解，也就是几条命令行指令的事，下次你 10 分钟就可以搞定了。

在本地电脑初始化 OpenClaw。

OpenClaw 安装好之后，我们就需要给它配置 AI 大模型和 IM 聊天工具了。

此时，我们可以在终端命令行运行这条指令来启动初始化：

openclaw onboard

这条指令是启动 OpenClaw 的初始化程序，其实就类似新手引导，它会一步步引导你去完成配置。

运行后，你会看到一些选项，按照我标红的去选就行。

注意，我这次用的 AI 大模型是 Kimi K2.5。

所以，你需要先准备好 Kimi 的API Key，Kimi 对已完成认证的个人用户送 15 元代金券，用来体验是够用了。

进入 Kimi 的 API 管理后台，点击新建 API Key，按操作执行即可。

接下来继续初始化过程，到 skills 安装这一步可以先跳过，因为这些后续都可以通过和他对话来安装。

接下来，所有这些选项全部选 NO，包括后面的 hooks 安装也可以选 skip for now。

再下一步，就是选择打开 OpenClaw 的会话打开方式。

我这里选的是 Hatch in TUI，也就是在命令行里直接会话，选择之后你就会看到 OpenClaw 给你打招呼了。

还有一种更直观的方式，就是在上一步选项里选择 Open The webUI。

如果选择这一步，它会弹出让你输入电脑开机解锁密码，正常输入，然后打开你电脑上的浏览器，输入这个网址。

http://127.0.0.1:18789

接下来，你就会看到这么一个网站页面。

这里，就是你本地电脑 OpenClaw 的后台了。

上面那个网址的意思是什么呢？

那一串带点的数字就是你本机电脑的网址地址， 18789 就是 OpenClaw 在你电脑上的端口号，可以理解为门牌号。每一个在你电脑打开的软件，都有一个类似的专属门牌号。

在左侧菜单里，你可以通过「概览」查看它的运行情况，也可以通过聊天直接和它会话。

注意，这一步我们还没有配置飞书等这类 IM 工具，但是你跟 OpenClaw 是可以直接对话的，这是因为你是在本机和它说话。

我们之所以用飞书、企业微信、QQ 这样的 IM 工具，就是为了能脱离电脑能远程和它说话。

到这里，你的本地 OpenClaw 就已经安装部署成功了。

OpenClaw本地部署新手高频问题

OpenClaw本地部署新手高频问题集中在环境依赖、命令执行、网络、端口、配置、权限、模型对接等环节，以下按安装、启动、运行、配置、模型对接分类整理，附快速修复方案：

macOS 安装 OpenClaw 高频问题

1. 安装后命令找不到

现象：zsh: command not found: openclaw
常见原因：

Node 版本过低
npm 全局路径没加到 PATH
安装未成功 / 旧版本冲突

快速修复：

升级 Node ≥ 22
重新打开终端
执行 source ~/.zshrc
重装：npm uninstall -g openclaw && npm install -g openclaw

2. 权限报错 EACCES

现象：Error: EACCES: permission denied
原因：mac 对 npm 全局目录权限限制
修复：

sudo chown -R $(whoami) /usr/local/lib/node_modules

3. 安装 / 拉取依赖超时

现象：安装卡住、报错网络超时
原因：境外源访问慢
修复：

npm config set registry https://registry.npmmirror.com

4. Gateway 启动闪退 / 起不来

现象：执行 openclaw gateway 直接退出
原因：配置损坏、依赖缺失
修复：

查看日志：tail -f ~/.openclaw/logs/gateway.err.log
重置配置：openclaw configure --reset
重启服务：openclaw gateway restart

5. 配置文件不存在 / 初始化失败

现象：config.json not found 或无法保存配置
修复：

openclaw onboard

6.系统防火墙 / 网络代理导致异常

现象：能启动但无法联网、技能下载失败
修复：

关闭系统代理再试
临时关闭防火墙
检查是否开启了全局翻墙导致本地回路异常

7. 开机自启失效

现象：重启电脑后 OpenClaw 不自动运行
修复：

openclaw gateway install

8.系统防火墙 / 网络代理导致异常

现象：能启动但无法联网、技能下载失败
修复：

关闭系统代理再试
临时关闭防火墙
检查是否开启了全局翻墙导致本地回路异常

专门帮企业做SEO获客、GEO营销、流量转化率提升和整体业绩增长咨询，实战操盘过从几千万做到数亿的项目业绩。不管是流量少、转化低还是增长见顶，都能给你一套可落地的打法，想提升业绩的老板，有业绩瓶颈想破局的，随时找我聊聊。

欢迎交流和咨询 Vx: cnseo1。

推荐阅读↓↓↓：

什么是GEO？如何获得不错的GEO效果？

个人小红书开店、企业小红书店铺，你必须知道的事!【小红书开店保姆级教程】

小红书运营高危词库|小红书违禁词库

小红书运营必看：小红书搜索词布局实战手册，做细分赛道的小红书头部KA玩家，必须懂！

小红书“PKCKS”方法论，如何在小红书上做出爆文？