2026年OpenClaw安装教程 :5分钟无痛上手,小白也能解锁会干活的小龙虾
安装前准备
在开始安装前,请确保你的系统环境满足以下基本要求,以避免后续步骤出现兼容性问题。
操作系统需为Windows 10或更高版本、macOS 12+,或Ubuntu 22.04等主流Linux发行版。内存建议4GB或以上,2GB为最低要求,AI应用对资源有一定需求。稳定的网络连接是必需的,安装过程需在线下载核心组件与依赖项。
权限要求因系统而异:Windows用户请使用管理员模式的PowerShell;Linux或macOS用户则需准备好sudo权限。完成这些前置检查,可确保安装流程顺畅无阻。
第一步:安装 OpenClaw(新手入门首选,3 分钟完成)
对于初次接触的用户,官方提供的一键安装脚本是最佳选择。它能自动识别你的操作系统环境,并处理包括Node.js在内的所有依赖安装,无需手动干预,极大简化了部署流程。
macOS / Linux
操作非常简单。打开终端,复制并执行以下命令。脚本将自动完成环境检测、依赖安装及OpenClaw的部署工作。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows(PowerShell 管理员模式)
Windows用户请以管理员身份运行PowerShell(可在开始菜单搜索后右键选择)。
在打开的PowerShell窗口中,执行以下命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
脚本将自动执行从Node.js环境检测到OpenClaw完整配置的全过程。
第二步:入门新手引导(配置模型)
安装完成后,系统将启动交互式配置向导,这是激活OpenClaw核心功能的关键步骤。
安装成功后,终端会显示引导界面。首先会看到风险提示,使用键盘方向键选择“Yes”并回车确认。
接下来选择安装模式。新手用户请直接选择“QuickStart”(快速安装模式)并回车,这是最便捷的配置路径。
现在进入核心配置:选择基础大语言模型。遵循OpenClaw官方推荐,选择Moonshot AI(Kimi K2.5)模型,它在性能与稳定性上表现均衡。
Moonshot AI(Kimi K2.5)配置步骤
为优化国内访问速度,请在接入点选择“Moonshot AI .cn”。
下一步需要获取API Key。请访问Kimi官方网站,登录后进入左侧的“API Key 管理”页面。点击“创建API Key”,复制生成的一串密钥字符。
返回OpenClaw配置终端继续操作。
粘贴你复制的API Key并回车。随后在模型列表中选中“Moonshot/Kimi-K2.5”,再次回车确认。
接下来选择交互界面。初次体验建议使用内置的“tui”(文本用户界面),以便快速上手。
选择网络搜索提供商,此处继续选择“Kimi”。
此步骤需要一个专用的搜索功能API Key。请返回Kimi工作台,创建一个新的用于搜索的API Key。
复制这个新的Key,回到OpenClaw配置步骤,粘贴并回车确认。
后续将出现关于OpenClaw技能包和附加功能的配置选项。对于核心技能包,选择“Yes”同意安装。
在技能列表中,勾选你需要的Skill,按回车确认安装所有已选技能。
对于其他高级或非必需服务,如Google Places、Notion API、OpenAI语言服务、Sag服务、自动化Hook等,初次配置时可选择“No”或“跳过”,后续可根据需求随时启用。
第三步:使用 TUI 快速体验,开始畅聊
基础配置完成,现在可以立即体验。在载体选择界面,选中“TUI”并回车,即可进入纯文本聊天界面,开始与你的AI助手对话。
第四步:查看 OpenClaw 状态
你可以通过以下命令轻松监控OpenClaw的运行状态。
在TUI界面中,连续按两次 Ctrl + C 可退出聊天,返回系统命令行。
输入openclaw status,查看OpenClaw的核心运行状态。
输入openclaw gateway status,可专门查看网关状态。
若想再次进入聊天界面,执行openclaw tui命令即可。
常见问题及解决方案:未找到 OpenClaw
若安装后终端提示“找不到openclaw”命令,通常是系统环境变量PATH未正确配置所致。请按以下步骤排查:
首先,验证Node.js是否安装成功:node -v
接着,查看npm全局安装目录:npm prefix -g
然后,检查当前PATH环境变量是否包含上述目录:echo “\$PATH”
如果PATH中缺少该全局二进制目录,需要手动添加。编辑你的shell配置文件(如~/.zshrc或~/.bashrc),添加以下行:
export PATH="\$(npm prefix -g)/bin:\$PATH"
保存文件后,务必重新启动一个新的终端窗口以使配置生效,然后再次尝试命令。
结语
至此,你已完成OpenClaw从环境准备到完整部署的全过程。恭喜你在本地成功搭建了这款功能强大的开源AI助手。
现在,你可以开始深入探索OpenClaw的各项能力,将其整合到你的工作流中,解锁AI驱动的效率提升与创新体验。