乐于分享
好东西不私藏

OpenClaw 从零安装指南(新手一步一步搭建)

OpenClaw 从零安装指南(新手一步一步搭建)
在前面的文章中,我们已经讲清楚了:
  • OpenClaw 是什么
  • 能做什么
  • 为什么它和传统 AI 工具不一样

接下来进入一个真正关键的步骤:

把 OpenClaw 跑起来。

很多人卡在这里,不是因为工具难,而是因为:

  • 环境没配对
  • 安装顺序搞错
  • 模型没配置

结果就是:👉 能启动,但什么都做不了。

这一篇,我们不讲原理,只做一件事:从 0 到 1,把 OpenClaw 跑通。


一、先搞清楚一件事:OpenClaw 不是“装完就能用”

在开始之前,有一个认知一定要建立:

OpenClaw 不是一个独立工具,而是一个“AI Agent + 模型”的组合。

也就是说,它本身不会“思考”,而是依赖你配置的模型来执行任务。

这也是为什么很多人会遇到这种情况:

  • 工具启动了
  • 但执行任务失败

本质原因只有一个:

没有正确配置模型。

二、环境准备(这一步很关键)

在安装之前,先把基础环境准备好。

1 Node.js 版本

根据官方要求:

推荐 Node 24,最低支持 Node 22.16+

检查方式:

node -v

如果版本太低,建议直接升级。

这里不要抱侥幸心理,因为很多问题其实都是:👉 Node 版本不兼容导致的

常见表现包括:

  • 安装依赖失败
  • 启动报错
  • 运行异常
建议:直接用官方推荐版本,后面会省很多时间。

2 一个可用的大模型

OpenClaw 本身不带模型,你必须接入一个。

常见选择:

  • OpenAI
  • Claude
  • 本地模型(如 Ollama)

如果你是第一次使用,建议优先选择:

OpenAI 或 Claude(稳定性更高)

3 API Key

对应模型,你需要准备:

  • OpenAI API Key 或 Claude API Key

这一项是必须的,否则无法执行任务。


三、安装 OpenClaw(按官方方式来)

1 安装 CLI 工具

一般推荐使用全局安装方式:

npm install -g openclaw

安装完成后,可以执行:

openclaw

如果能够正常进入界面,说明安装成功。

2 验证是否安装成功

你可以执行:

openclaw --help

四、配置模型(最关键的一步)

这是整个安装过程中最容易出问题的地方。

1 配置方式(通用做法)

通常是通过环境变量配置。

使用 OpenAI

export OPENAI_API_KEY=你的key

使用 Claude

export ANTHROPIC_API_KEY=你的key

2 为什么这一步很重要

如果你跳过这一步,或者配置错误,会出现:

  • 一直执行失败
  • 没有任何结果
  • 或者报权限错误

所以这里可以记住一句话:

OpenClaw 能不能用,取决于模型配置是否正确。

五、第一次运行(一定要做)

不要一上来就做复杂任务,先验证环境。

启动:

openclaw

然后输入一个简单任务,例如:

分析当前目录结构

正常情况下,你会看到:

  • 有任务拆分过程
  • 有执行步骤
  • 有最终结果
整个链路已经跑通(环境 + 模型 + Agent)

六、常见问题(提前帮你踩坑)

这一部分非常重要,基本覆盖 80% 的问题。

1 启动了但无法执行任务

原因大概率是:👉 没配置模型 / key 错误

2 一直报错但看不懂

  • 模型不可用
  • API 没额度
  • 模型名称错误

3 安装依赖失败

  • Node 版本问题
  • 网络问题

优先检查 Node 版本。

4 一开始就做复杂任务

正确做法是:

先跑简单任务验证环境

七、如何判断你已经“真的装好了”

不要只看“能不能启动”,而是看:

  • 能否执行任务
  • 能否读取文件
  • 是否有完整输出
说明你已经真正跑通 OpenClaw 了。

八、小结

这一篇你只需要记住三件事:

1 Node 版本要对2 模型一定要配置3 先用简单任务验证

很多人失败,不是因为不会用,而是:

环境没搞对就开始折腾功能。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料