🎯 这篇锦囊帮你什么
OpenClaw 是 2025 年底爆火的开源个人 AI 智能体(GitHub 数月破三十万星),能接微信生态外的各种聊天渠道(Telegram/飞书/Discord/WhatsApp),帮你跑自动化任务。网上教程多而杂,这篇按官方文档给你一条最少弯路的路径:装好 → 说上话 → 接渠道,三步闭环。
第 0 步:先确认三件事
① 电脑系统:macOS / Linux / Windows(Windows 走 WSL2)
② Node 版本 ≥ 22(终端敲 node -v 检查,低于 22 先升级 Node)
③ 一个 AI 模型的 API Key(官方推荐 Anthropic Claude;没有的话先去注册一个,向导里要填)
第 1 步:一条命令安装(1 分钟)
官方推荐脚本安装(自动装 CLI + 起新手引导):
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
习惯 npm 的也可以:npm install -g openclaw@latest。装完终端敲 openclaw 确认命令存在。
第 2 步:新手引导(2 分钟)
敲 openclaw onboard --install-daemon,向导会依次问你:
① 本地还是远程网关 → 个人用选本地;
② 模型认证 → 选你的 API Key 方式粘贴进去;
③ 要不要接聊天渠道 → 可以先跳过(第 3 步再说);
④ 守护进程 → 选安装(后台常驻,开机自启)。
跑完向导,凭证都存在 ~/.openclaw/ 目录里。
第 3 步:第一次对话(2 分钟)
向导结束会给出 WebChat 本地地址(一般是浏览器打开 localhost 页面),输入"你好",收到回复 = 闭环成功 🎉。想接 Telegram/飞书等渠道,再跑 openclaw configure 按渠道提示填 Token 即可。
常见报错对照表
① command not found: openclaw → Node 版本低于 22 或 PATH 没刷新,重开终端;
② sharp 等原生模块装失败 → 强制用预编译二进制:环境变量 SHARP_IGNORE_GLOBAL_LIBVIPS=1 后重装;
③ Windows 用户 → 别在 PowerShell 直接装,先装 WSL2(Ubuntu)再走 Linux 流程;
④ 引导卡在某一步 → 加 --no-onboard 跳过向导手动 openclaw configure 逐项配。
下一步玩什么
跑通闭环后按需进阶:接渠道让助手出现在手机聊天软件里 → 改人设(工作区的 SOUL/IDENTITY 文件)→ 装 Skills 教新本领 → 配 Cron 定时任务。也可以考虑升级到带学习循环的 Hermes Agent(官方支持一键迁移,见迁移指南)。