OpenClaw 安装部署保姆级教程:从零开始养龙虾,每一步都有命令
别再花 300 块找人上门装了。这篇教程从系统要求讲起,给你每一步的终端命令、每一个配置项该填什么、怎么连接 AI 模型、怎么通过 Telegram 远程控制你的龙虾。全程跟着敲就行。
2026 年 3 月,腾讯在深圳总部搞了一场 OpenClaw 免费安装活动,几百号人排队等着工作人员帮他们装一个开源软件。与此同时,闲鱼上"OpenClaw 上门安装"的服务已经炒到 300-1000 块一单。
说实话,这东西的安装难度被严重夸大了。你跟着下面的步骤走,半小时之内一定能跑起来。我把踩过的坑全标出来了,你不用再趟一遍。
在开始之前:你需要准备什么
硬件要求
- 内存:最低 2GB,建议 4GB 以上
- 硬盘:至少 20GB 可用空间
- 系统:macOS 12+、Ubuntu 20.04+、Windows 11(需要 WSL2)
必须有的东西
- Node.js 22 或更高版本(安装脚本会自动检测,没有的话会提示你装)
- 一个 AI 模型的 API Key——这是最关键的。OpenClaw 是调度框架,它自己不带"大脑",你需要接入 ChatGPT、Claude 或 Gemini 的 API 才能让它工作
⚠️ 重要提醒:没有 AI 模型 API Key,OpenClaw 装好了也没法用。如果你还没有,先去准备。这里可以即时购买 ChatGPT Plus、Claude Pro 等正版订阅,付款后自动到账,不用折腾海外信用卡。
第一步:安装 OpenClaw
macOS / Linux 一键安装
打开终端(macOS 按 Cmd + 空格 搜索 "Terminal"),粘贴这行命令:
curl -fsSL https://get.openclaw.ai | bash
这个脚本会做三件事:
- 检测你有没有 Node.js 22+,没有会自动安装
- 下载 OpenClaw 的最新版本
- 把
openclaw命令添加到你的系统 PATH 里
安装完成后,验证一下:
openclaw --version
看到版本号就说明装好了。如果提示 command not found,关掉终端重新打开再试——因为 PATH 变量需要重新加载。
Windows 安装
Windows 用户有两条路:
方式一:通过 WSL2(推荐)
先确保你装了 WSL2。没装的话,以管理员身份打开 PowerShell,执行:
wsl --install
重启后进入 WSL 的 Ubuntu 终端,然后执行跟 Linux 一样的命令:
curl -fsSL https://get.openclaw.ai | bash
方式二:Windows 原生安装包
去 OpenClaw 官网(openclaw.ai)下载 .exe 安装包,双击安装。图形化界面,没什么好说的。但注意:可能需要在 Windows 设置里开启"开发者模式",并且暂时关闭 Windows 防火墙以避免端口拦截。
⚠️ 常见报错及解决
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
Node.js version too old | 系统自带的 Node.js 版本太低 | 运行 nvm install 22 或去 nodejs.org 下载最新版 |
Permission denied | 没有写入权限 | 在命令前加 sudo,即 curl -fsSL https://get.openclaw.ai | sudo bash |
ECONNREFUSED | 网络问题,脚本下载失败 | 检查网络连接,或者用手机热点试试 |
第二步:首次启动和配置 AI 模型
安装完成后,在终端运行:
openclaw
第一次启动会进入交互式配置界面,它会问你几个问题:
问题 1:选择 AI 模型提供商
会列出这些选项:
Anthropic (Claude)← 我个人最推荐,上下文窗口大,复杂任务表现好OpenAI (GPT/Codex)← 生态最完善,编程任务用 Codex 很强Google (Gemini)← 多模态能力突出,能理解图片Ollama (本地模型)← 完全免费但需要强悍的本地硬件
选一个你有 API Key 的就行。新手建议选 OpenAI——文档最全,报错信息最好排查。
问题 2:输入 API Key
把你的 API Key 粘贴进去。Key 不会显示在屏幕上(安全设计),粘贴后直接回车。
怎么获取 API Key:
- OpenAI:登录 platform.openai.com → API Keys → Create new secret key
- Anthropic:登录 console.anthropic.com → API Keys → Create Key
- Google:登录 aistudio.google.com → Get API key
⚠️ 注意:免费层的额度非常有限。选 OpenAI 的话,免费账号大概只够跑 5 分钟的任务。正式使用一定需要付费订阅。这里提供 ChatGPT Plus / Claude Pro 即时购入通道。
问题 3:设置访问密码
给你的 OpenClaw 实例设一个密码。千万别跳过这一步。3 月的"裸奔龙虾"事件(27 万个无密码实例暴露在公网)就是因为太多人跳过了这里。
第三步:连接 Telegram 实现远程控制
OpenClaw 最爽的一个功能是可以通过聊天工具远程控制。下面演示最常用的 Telegram 对接。
3.1 创建 Telegram Bot
- 在 Telegram 里搜索
@BotFather - 发送
/newbot - 按提示给你的 Bot 取名(比如
MyOpenClawBot) - BotFather 会返回一个 Bot Token,类似
7123456789:AAH...,复制保存
3.2 在 OpenClaw 里配置
打开 OpenClaw 配置文件(默认路径 ~/.openclaw/config.yaml),加入:
messaging:
telegram:
enabled: true
bot_token: "你的Bot Token"
allowed_users:
- "你的Telegram用户ID"
如何查你的 Telegram 用户 ID:在 Telegram 里搜索 @userinfobot,它会自动告诉你。
3.3 重启 OpenClaw
openclaw restart
然后去 Telegram 给你的 Bot 发一句话,比如"你好",如果它回复了——恭喜,你现在可以在手机上远程指挥你的龙虾了。
第四步:给它下达第一个真实任务
别一上来就搞复杂的。先试一个简单的,确认一切正常:
帮我查一下当前目录下所有超过 100MB 的文件,列出文件名和大小
OpenClaw 会:
- 调用 AI 模型理解你的意图
- 生成一条 shell 命令(类似
find . -size +100M -exec ls -lh {} \;) - 执行命令并把结果返回给你
如果它成功返回了文件列表——那你的龙虾就养活了。接下来可以挑战更复杂的任务了。
总结:三十分钟清单
| 步骤 | 命令/操作 | 耗时 |
|---|---|---|
| 1. 安装 OpenClaw | curl -fsSL https://get.openclaw.ai | bash | 5 分钟 |
| 2. 配置 AI 模型 | 首次启动交互配置 | 5 分钟 |
| 3. 设置访问密码 | 交互配置中设置 | 1 分钟 |
| 4. 对接 Telegram | 编辑 ~/.openclaw/config.yaml | 10 分钟 |
| 5. 测试第一个任务 | 发送自然语言指令 | 2 分钟 |
总耗时不超过半小时。省下 300 块安装费,拿去买 AI 订阅更划算。
📖 延伸阅读



