OpenClaw保姆级教程03
03
极速安装指南:5 分钟把神兽接回家
│ 导读:上一篇我们准备好了电脑和 API Key,这一篇直接进入正题。只需 3 步,5 分钟,让你的 AI 助理跑起来。
🚀开篇
别被“安装“两个字吓到,OpenClaw 的安装非常简单。
全程只需要 3 个命令:
┌── bash ──npm install -g openclaw@latestopenclaw onboard –install-daemonopenclaw status└──────────────
跟着走一遍,你就能在终端里和 AI对话了。
💻 01 环境准备:检查 Node.js
OpenClaw 基于Node.js 运行。先确认版本:
┌── bash ──node –version└──────────────
要求:版本 >= v22。如果低于这个版本,或者提示找不到命令,请去 Node.js 官网下载LTS 版安装。
│ ⚠️ Windows 用户建议:官方推荐在 WSL2 中运行,能避免很多路径和权限问题。
📦 02 一行命令安装
打开终端,复制粘贴这行命令:
┌── bash ──npm install -g openclaw@latest└──────────────
这行命令会全局安装最新版的 OpenClaw。等待 30 秒到 2 分钟,取决于你的网速。
安装完成后,验证一下:
┌── bash ──openclaw –version└──────────────
看到版本号(如 2026.2.17),就说明安装成功了。
⚙️ 03运行向导:初始化配置
运行初始化向导,这是最关键的一步:
┌── bash ──openclaw onboard –install-daemon└──────────────
向导会引导你完成配置,以下是关键步骤的极简指南:
|
步骤 |
选项 |
建议 |
|
Onboarding mode |
QuickStart / Manual |
新手选 QuickStart |
|
Model Provider |
KIMI / MiniMax / GLM |
选你申请的那家 |
|
Auth method |
Coding Plan / API Key |
优先 Coding Plan |
|
Channel |
飞书 / Skip |
首次建议 Skip |
|
Hatch |
TUI / Web UI |
选 Hatch in TUI |
│ 💡 提示:粘贴 API Key 时终端不会显示字符,这是正常的安全机制,直接粘贴回车即可。
🗣️ 04 首次对话:Bootstrap
安装完成后,建议在终端里完成第一轮 bootstrap(初始化对话)。
主动告诉 AI 这 5 件事:
• 你是谁(称呼、时区、语言)
• 你希望它扮演什么角色(如“技术写作助手“)
• 你的工作场景(常用工具、文件目录)
• 你的偏好(回答风格、长度)
• 你的边界(哪些操作需确认、哪些内容不要碰)
这一步做得越清楚,后续它越像“你自己的助理“。
🔧 05 常见问题速查
遇到问题别慌,对照下面排查:
|
症状 |
排查命令 |
|
Gateway 启动失败 |
lsof -i :18789 或换端口 |
|
发送消息无回复 |
openclaw doctor 检查配置 |
|
Web UI 打不开 |
openclaw status 确认状态 |
|
command not found |
重启终端或检查 PATH |
📌 06 本部分小结
来,回顾一下今天的成果:
• ✅ 检查了 Node.js 环境(>= v22)
• ✅ 安装了OpenClaw(一行命令)
• ✅ 运行了初始化向导(QuickStart)
• ✅ 配置了国内Coding Plan
• ✅ 完成了首次bootstrap
• ✅ 发出了第一条消息!
恭喜!你的 AI 助理已经成功接回家了。下一篇,我们把它接入飞书,让它在群里陪你聊天。
🎯领取步骤(30 秒搞定)
1️⃣点击文章顶部「关注」本号(程大虾)
2️⃣后台发送关键词【保姆级教程 03】保姆级教程03.pdf
3️⃣收到小程序链接,点击直接下载(无需登录/解压)
📚教程目录
│ OpenClaw 保姆级教程01 | 揭开面纱:OpenClaw 深度解析与真相揭秘02 | 开工准备:只需三样东西03 | 极速安装指南:5 分钟把神兽接回家 ← 本篇04 | 飞书接入指南:让 AI 机器人在群聊中陪你聊天05 | 飞书渠道安全防护指南06 | 大脑挑选指南:KIMI、MiniMax 与 GLM 怎么选07 | 装备技能:让它学会自动生成日报…
📌 收藏本篇,随时回顾🔔 关注我,获取后续教程更新
夜雨聆风