说实话,我第一次听说OpenClaw的时候,心里是有点犯嘀咕的。又是一个AI工具?安装会不会很麻烦?要不要折腾一堆环境配置?结果装完之后发现,整个过程比我想象的顺滑多了。
这篇文章就是想把我的安装经验分享给你,特别是那些和我一样,对命令行不太熟悉,但又想尝鲜的朋友。不管你用的是Mac、Linux还是Windows,跟着这个指南,基本上不会踩什么大坑。
在开始安装之前,咱们先聊聊OpenClaw是个啥。简单来说,它是一个开源的AI助手平台,可以把像ChatGPT、Claude这样的大语言模型连接到你常用的聊天工具上,比如Telegram或者WhatsApp。
你可能会问,为什么要在本地装这个?直接用网页版的AI不香吗?
其实各有各的好处。本地安装的话,你可以:
- 自己掌控数据和隐私
- 自定义各种功能和技能
- 把AI接入到自己的工作流中
- 如果愿意折腾,甚至可以用本地模型,完全不依赖云服务
对我来说,最吸引我的是可以把AI接到Telegram上,这样平时聊天就能直接调用,不用来回切换应用。
老实讲,OpenClaw对系统要求还挺友好的。不过在开始之前,还是得确认几个事情。
OpenClaw原生支持macOS和Linux。如果你用的是Windows,也没问题,但需要先装个WSL2(Windows Subsystem for Linux)。
WSL2其实就是在Windows里跑一个轻量级的Linux环境。听起来复杂,但微软已经把它做得很简单了。打开PowerShell,运行一条命令就能装好:
装完记得重启电脑,然后再打开PowerShell输入就能进入Linux环境了。
说到硬件,OpenClaw真的不挑食。官方建议是:
- 内存:8GB够用,16GB更好
- 存储:至少留20GB空间(建议用SSD,体验会好很多)
基本上,只要你的电脑能流畅跑个浏览器,运行OpenClaw就没啥问题。我用的是一台8GB内存的老MacBook,跑起来也挺顺的。
这是最关键的一步。OpenClaw是基于Node.js开发的,所以必须先装Node.js。而且版本要求是22或更高。
如果你想开发自定义技能(skills),官方推荐装Node.js 24+,因为新版本支持一些更先进的JavaScript特性。
macOS安装Node.js
Mac用户最简单的方法是用Homebrew:
Linux安装Node.js
Linux的话,我推荐用nvm(Node Version Manager),这样可以轻松切换不同的Node.js版本:
Windows (WSL2)安装Node.js
在WSL2里,和Linux的方法一样,用nvm就行。
安装完之后,验证一下版本:
只要显示v22.x.x或更高,就OK了。
Node.js装好之后,会自带npm(Node Package Manager)。OpenClaw用npm完全没问题。
不过如果你听说过pnpm,也可以用它。pnpm相比npm有几个优势:
- 安装速度更快
- 占用磁盘空间更少
- 依赖管理更严格
对于普通用户来说,用哪个都行。我自己习惯用pnpm,不过这完全看个人喜好。
如果想装pnpm:
准备工作做完,咱们就可以正式开始了。OpenClaw提供了好几种安装方式,我按推荐程度给你讲讲。
这是最简单的方法,一行命令搞定:
这个脚本会自动帮你:
- 检查系统环境
- 安装必要的依赖
- 下载并安装OpenClaw CLI
- 提示你运行初始配置
整个过程大概需要1-2分钟,取决于你的网速。我第一次装的时候,看着终端里刷刷刷地输出日志,还挺有成就感的。
如果你更喜欢用包管理器,可以直接用npm:
确保你装的是最新版本。装完之后,终端里就可以直接用命令了。
用pnpm的话:
效果和npm一样,只是用的工具不同。
如果你想折腾,或者打算给OpenClaw贡献代码,可以从GitHub克隆源码:
这种方法适合开发者,普通用户不推荐。
装好OpenClaw之后,还不能直接用,需要先跑一遍配置向导。这一步很重要,但也很简单。
在终端里输入:
这个命令会启动一个交互式的配置向导。参数的意思是把OpenClaw安装为系统服务,这样开机就能自动运行,不用每次手动启动。
接下来,向导会一步步问你几个问题:
1. 选择运行模式
通常选择本地模式(Local gateway)就行,除非你想部署到远程服务器。
2. 配置AI模型
这里需要选择你想用的AI提供商。目前支持:
- OpenAI(GPT-4、GPT-3.5等)
- Anthropic(Claude系列)
- 本地模型(需要额外配置)
如果你有OpenAI或Anthropic的API密钥,在这里输入。没有的话,可以先跳过,后面再配。
获取API密钥的方法:
- OpenAI:去platform.openai.com注册账号,在API keys页面生成
- Anthropic:去console.anthropic.com注册,同样在API设置里生成
3. 设置工作目录
向导会问你把OpenClaw的配置和数据放在哪里。默认是,一般直接回车用默认的就行。
4. 连接消息渠道
这一步是选择你想用哪个聊天平台来和AI对话。目前支持:
- Telegram:需要先在Telegram里找创建一个bot,拿到token
- WhatsApp:会生成一个二维码,用手机WhatsApp扫码关联
- 跳过:如果你只想用Web界面,可以暂时跳过
我自己选的是Telegram,配置过程很简单:
- 在Telegram搜索
- 发送命令
- 按提示给bot起名字
- 复制生成的token
- 粘贴到OpenClaw的配置里
5. 安装守护进程
最后,向导会问你要不要安装守护进程。选”是”的话,OpenClaw会在后台持续运行,你关闭终端也不影响。
整个配置过程大概5-10分钟,主要时间花在获取API密钥和配置聊天渠道上。
如果你想微调配置,可以编辑配置文件:
这个文件是JSON格式,包含了所有的配置项。不过对于大部分用户,用向导配置就够了,不需要手动改。
配置完成后,就可以启动OpenClaw了。
如果你刚才没有安装守护进程,需要手动启动:
是默认端口,你可以改成其他的。启动成功的话,会看到类似这样的输出:
打开浏览器,访问:
你应该能看到OpenClaw的控制界面。界面很简洁,主要有几个部分:
- Chat:聊天测试区
- Agents:管理你的AI代理
- Skills:配置各种技能插件
- Settings:系统设置
在Chat页面,试着发送一条消息,比如”你好”或者”介绍一下你自己”。
如果一切配置正确,AI应该会回复你。第一次看到回复的时候,还是挺激动的——这就是你自己搭建的AI助手了!
装软件嘛,难免会遇到些小问题。我把常见的坑列出来,方便你排查。
症状:运行命令时报错,提示Node版本不兼容
解决:检查Node.js版本,确保是22+
如果版本太低,重新安装或升级Node.js。
症状:在Windows上安装时各种报错
解决:确认WSL2已正确安装并更新到最新版
症状:配置了API密钥,但AI不回复或报错
解决:
- 检查密钥是否正确复制(前后没有多余空格)
- 确认API账户有余额(OpenAI和Anthropic都需要充值)
- 重新生成密钥试试
症状:启动Gateway时提示端口18789已被占用
解决:换个端口,或者找出占用端口的进程并关闭
症状:安装时提示权限不足
解决:Linux/Mac用户可能需要用sudo,或者检查目录权限
OpenClaw装好之后,有几个安全方面的事项要注意:
- 不要暴露端口:18789端口默认只监听localhost,千万别把它暴露到公网,否则任何人都能访问你的AI
- 保护API密钥:配置文件里的API密钥很敏感,不要分享给别人,也不要提交到Git仓库
- 远程访问用SSH隧道:如果你想从其他设备访问,用SSH隧道,不要直接开放端口
好了,到这里你应该已经成功装好OpenClaw了。回顾一下整个流程:
下一步,你可以:
- 探索Skills功能,给AI添加各种能力
- 尝试连接Telegram或WhatsApp,在聊天软件里调用AI
- 如果有兴趣,研究一下如何开发自定义技能
- 看看官方文档,了解更多高级功能
说实话,OpenClaw虽然是开源项目,但体验已经做得很不错了。如果你在安装过程中遇到什么问题,可以去GitHub的Issues页面看看,社区还挺活跃的。
最后提醒一句:第一次接触这类工具可能会觉得有点复杂,但装过一次之后,你会发现其实也就那么回事。慢慢来,遇到问题多搜搜,基本都能解决。
祝你玩得开心!
<p class="mt-6 text-xs text-neutral-500 dark:text-neutral-400"> 10 分钟阅读 · 发布于: 2026年2月5日 · 修改于: 2026年3月3日 </p>
GPT plus 代充 只需 145
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213120.html