返回教程中心
快速开始

OpenClaw 快速上手教程,三分钟完成首次安装和启动

O
OpenClaw AI
2026-02-12

相信不少人看了 OpenClaw 的文档,都会有一个感觉:好像不难,但又不知道从何开始。下面我讲带大家一步一步学习怎么把OpenClaw完成部署。

一、先确认你的电脑环境够不够

OpenClaw 依赖 Node.js 运行,而且版本要求比较新。第一件事不是安装 OpenClaw,而是检查 Node 版本。

打开终端(Mac 打开 Terminal,Windows 打开 PowerShell 或 Windows Terminal),输入:

node -v

如果显示的版本是 22.x 或更高,那可以继续。如果低于 22,或者提示找不到命令,那就去官网下载最新版 Node.js 安装。

装完之后再执行一次 node -v,确认版本正确。这一步不要跳,因为版本不对后面会报各种莫名其妙的错。

二、安装 OpenClaw 命令行工具

环境没问题之后,才开始安装 OpenClaw。

在终端里执行:

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

执行之后会自动下载并安装 OpenClaw CLI。

安装完成后,你可以测试一下:

openclaw --help

如果能看到命令帮助信息,说明安装成功。如果提示 command not found,通常是环境变量没刷新。关掉终端重新打开一次,再试。

三、真正关键的一步:运行初始化向导

很多人卡在这里,安装完成并不等于可以用了。OpenClaw 需要配置模型、核心服务和一些基础参数。

执行:

openclaw onboard --install-daemon

这条命令会启动一个交互式向导。你会看到终端开始问你问题。这里我帮你解释每一类问题是在干什么。

1)选择 AI 模型来源

它会问你要使用哪个模型提供商,比如 OpenAI 或 Anthropic。如果你选 OpenAI,就需要准备一个 OpenAI API Key。没有的话,需要先去 OpenAI 官网创建。填入 API Key 后,它会测试连接是否成功。如果报错,大多数情况是 Key 填错或者没开通额度。

2)是否安装 Gateway 服务

Gateway 是 OpenClaw 的核心运行服务,相当于大脑调度中心。向导里如果看到安装 Gateway 或 daemon 的选项,建议选择安装。安装后,它会把服务注册到系统里,以后可以后台运行,不用每次手动启动。

3)选择聊天入口(可选)

向导可能会问你要不要连接 Telegram、WhatsApp 或其他渠道。如果你是第一次用,可以先跳过。建议先用本地控制面板熟悉系统,再去接入聊天平台。向导结束后,它会提示你配置完成。

四、启动核心服务

现在 OpenClaw 已经“安装 + 配置”完了,但还没真正启动。

执行:

openclaw gateway start

你应该会看到启动日志。

然后检查状态:

openclaw gateway status

如果显示运行中,就说明大脑已经开始工作。如果启动失败,常见原因:

  • 端口被占用
  • Node 版本不对
  • API Key 无效

根据报错信息排查即可。

五、打开可视化界面

如果你不想直接用命令行聊天,可以打开控制界面。

执行:

openclaw dashboard

然后在浏览器访问:

http://127.0.0.1:18789/

你会看到一个聊天页面。

在这里输入一句话,比如:

“帮我总结一下今天的任务安排。”

如果模型配置没问题,它会正常回复。到这里,你已经真正跑通了。

六、第一次真正“使用”它

现在你可以测试几个简单能力。

比如问它:

  • 你现在的模型是什么?
  • 你可以做什么?
  • 帮我写一个简单的待办事项列表。

如果你后续安装了技能插件,它还能执行具体任务,比如调用接口或操作工具。

七、接下来你应该做什么

很多人跑通之后就停了,其实这才是开始。

你可以:

  • 给它安装 skills(插件)扩展能力
  • 接入 Telegram 作为聊天入口
  • 改用本地模型,比如 Ollama
  • 配置长期运行,让它常驻后台

OpenClaw 的核心不是“聊天界面”,而是“可执行的 AI 代理系统”。真正的价值在于你给它接入什么能力。

常见卡点提醒

我提前帮你总结几个新手最容易卡的地方:

1)Node 版本太低

2)API Key 无效或没余额

3)Gateway 没启动就打开 dashboard

4)端口冲突(18789 被占用)

大多数问题都是环境问题,不是 OpenClaw 本身坏了。

最后,如果你能完成上面这些步骤,你已经不只是“体验了一个 AI”,而是搭建了一个属于自己的 AI 运行环境。OpenClaw 的门槛确实比普通聊天产品高一点,但换来的,是可控、可扩展、可自托管的能力。

继续阅读

相关阅读与站内入口

准备好开始了吗?

继续探索更多教程,或者去技能市场看看有哪些现成的插件。