天啊OpenClaw原来这样装!小白也能搞定的安装指南

大家好!我是一个刚学编程半年的大学生,最近被OpenClaw刷屏了,室友都在聊这个,我也想试试。折腾了两天终于装上了,把过程记下来,希望能帮到跟我一样的新手。

装之前我在想什么

说实话一开始看到网上的教程我有点害怕。什么命令行啊、环境变量啊、API Key啊,好多概念都没见过。我甚至不知道"终端"是什么(就是那个黑乎乎的窗口啦,Mac上叫Terminal,Windows上叫CMD或PowerShell)。

但是!真正动手之后发现,没有想象中那么可怕。核心步骤其实就那么几步,剩下的都是在解决各种小问题。

你需要准备什么

1. Node.js

这是OpenClaw运行必须的东西,相当于它的"地基"。去Node.js官网下载LTS版本(就是那个标着"推荐"的绿色按钮),安装的时候一路点"下一步"就行。

装完之后打开终端输入 node -v,如果显示出一个版本号(比如v18.x.x),就说明装好了!我第一次看到版本号显示出来的时候超开心的。

2. 一个大模型的API Key

这个概念一开始把我搞晕了。简单说就是:OpenClaw本身是免费的,但它需要调用大模型(比如GPT、DeepSeek)来"思考",这个思考过程要花钱,用API Key来计费。

就像OpenClaw是一台车,API Key是油卡。车免费给你,但跑起来要加油。

新手的话我推荐先用DeepSeek的API,原因很简单:便宜!注册DeepSeek开放平台,充个几块钱就够玩好一阵子了。

3. 一台电脑

什么电脑都行,不需要很好的配置。我用的是一台三年前买的MacBook Air,完全没问题。Windows、Mac、Linux都可以。

安装步骤(跟着做就行!)

打开终端,输入这些命令:

# 第一步:把项目代码下载到你电脑上
git clone https://github.com/openclaw/openclaw.git

# 第二步:进入项目文件夹,安装需要的东西
cd openclaw && npm install

# 第三步:复制一份配置文件模板
cp .env.example .env

然后用任何文本编辑器(VS Code、记事本都行)打开那个 .env 文件,找到API Key那一行,把你的Key粘贴进去。保存。

最后:

npm start

如果终端里出现了一些欢迎信息,恭喜你,装好了!!

我踩过的坑

坑1:npm install的时候一直转圈圈不动。

这个把我卡了好久!后来问了室友(他是计算机专业的),才知道是网络问题。国内访问npm的服务器比较慢,需要换一个"镜像源"。他帮我敲了一行命令换成了淘宝镜像,之后就很快了。

坑2:提示"git不是内部命令"。

这说明你没有装Git。去Git官网下载安装就行。我一开始以为电脑里自带这个的……原来不是。

坑3:.env文件里Key填错了。

我第一次把Key前面多复制了一个空格,结果启动的时候报错"API Key invalid"。检查了好久才发现。所以一定要仔细,多一个空格少一个字符都不行!

坑4:权限问题。

在Mac上装的时候,它提示我permission denied(权限不够)。网上有人说用sudo(超级管理员权限)来装,但我室友说不推荐这样做,容易埋坑。后来用nvm(一个管理Node版本的工具)重新装了一遍Node就好了。

不想折腾命令行怎么办?

完全理解!我一开始也不想碰命令行的。如果你跟我一样,可以直接用这些现成的方案:

  • Kimi Claw——月之暗面出的,在网页上就能用,不用装任何东西
  • Max Claw——MiniMax出的,也是零配置
  • LobsterAI(有道龙虾)——网易有道的,有漂亮的图形界面
  • 阿里云/腾讯云一键部署——买个便宜的云服务器,选预装好的镜像,开机就能用

说真的,对于只想体验一下OpenClaw的人,这些方案比自己折腾部署方便太多了。省下来的时间可以研究怎么用好它。

装好之后第一件事!!

不是发朋友圈(虽然我确实发了哈哈),是做安全设置:

  1. 改掉默认密码和端口——默认的东西最不安全
  2. 不要把它暴露在公网上——只在自己电脑上用就好
  3. 别乱装不认识的技能包——就像手机上不要乱装来路不明的APP一样
  4. 重要操作开启"人工确认"——让AI做事之前先问你一声

我一开始没注意这些,后来看到新闻说有很多人的API Key被盗了,吓得赶紧去改了密码。安全真的很重要!

写在最后

作为一个编程小白,能把OpenClaw装起来跑起来,我还是蛮有成就感的。虽然过程中确实遇到了不少问题,但每解决一个问题都学到了新东西。

如果你也是新手,不要怕,慢慢来。实在搞不定就用现成的托管方案,完全没问题的。重要的是先用起来,体验一下AI能帮你做什么。

有问题可以在评论区问我,能回答的我尽量回答!(虽然我也是刚学的)

态度端正

之前没想过

已经跑起来了 效果不错

头排吃瓜

存着

装是装上了 但是打开就报错 有没有人遇到一样的

npm全局安装是反模式 应该用npx或者项目级依赖

需要这么多步骤的东西还叫简单?标准不一样吧

安装流程超过3步就会流失80%的非技术用户 这个漏斗太长了

systemd service文件写一个 比screen靠谱多了

终于装上了 室友都来围观了

部署在自己的NAS上 随时随地SSH进去用

@noobkid 装上就报错先看报错信息 截图发到社区 带上你的操作系统版本和Node版本 信息越全社区帮你定位问题越快

@nopethx 步骤多不等于复杂 每步都是简单命令 全程复制粘贴10分钟能搞定 但确实应该有一键安装脚本降低门槛

GitOps让基础设施也能版本控制了

MCP Inspector调试工具好用