相信不少人看了 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 的门槛确实比普通聊天产品高一点,但换来的,是可控、可扩展、可自托管的能力。