不用懂技术!2026 最新 OpenClaw 安装教程,5 分钟轻松部署可用小龙虾
OpenClaw:5分钟完成个人AI助手的本地部署
对于需要在本地快速搭建一个功能完善的个人AI助手的用户来说,OpenClaw(俗称“小龙虾”)是一个极佳的开源选择。它完全免费,并且原生支持Windows、macOS、Linux三大操作系统。本文将指导你完成官方推荐的最优安装路径,核心是配置当前备受关注的Kimi K2.5模型。从安装到启动,整个流程可以在5分钟内完成。完成后,你将直接获得一个已配置身份验证的服务网关,以及一个可立即对话的聊天界面。
部署前的系统环境检查
在开始安装前,请确保你的系统满足以下基本要求,以避免可能的兼容性问题:
系统要求: Windows 10及以上版本、macOS 12及以上,或主流Linux发行版(建议采用Ubuntu 22.04+)。
依赖条件: 需要Node.js ≥ v22运行环境及npm/pnpm包管理器。官方安装脚本会自动处理Node.js的安装,源码安装则需提前准备好Git。
内存要求: 至少2GB可用内存(建议4GB以上以保证运行流畅度)。
网络环境: 安装过程需要联网下载必要的安装包和项目依赖。
权限要求: Windows系统需要以管理员身份运行PowerShell;Linux或macOS则需要具备sudo权限。
第一步:安装OpenClaw核心程序(推荐新手)
这是最快捷的安装方式。脚本具备环境自动检测功能,能为你安装Node.js和所有项目依赖,无需手动设置环境变量。
macOS / Linux 用户
打开终端,直接运行以下命令。脚本将自动完成系统检测、依赖安装及OpenClaw本体的部署。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 用户(PowerShell管理员模式)
首先,务必以管理员权限启动PowerShell(可通过开始菜单搜索并右键选择“以管理员身份运行”)。
随后,执行以下命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
该命令会触发脚本自动执行Node.js环境检测、安装及OpenClaw的完整配置流程。
第二步:运行交互式配置向导
安装成功后,系统会自动启动一个交互式配置向导,引导你完成核心初始化设置。整个过程通过键盘方向键和回车进行选择。
首先,在风险提示界面,使用方向键选择“Yes”并回车确认。
接着,选择“QuickStart”快速安装模式,回车进入下一步。
选择“Model”选项后,我们遵循项目建议,选用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”,再次回车确认。
接下来选择与OpenClaw交互的客户端。初次使用,可直接选择内置的TUI(文本用户界面)进行体验。
在选择联网搜索供应商时,选择“Kimi”。
此时需要返回Kimi平台工作台,单独创建一个用于搜索功能的API Key。
复制这个新的搜索Key,回到配置终端粘贴,回车确认。
随后,向导会询问是否配置OpenClaw的技能(Skills)。选择“Yes”进行配置。
在技能列表界面,使用空格键勾选你需要的功能模块,回车确认安装所有已选项。
后续出现的一些高级服务配置,如Google Places、Notion API、OpenAI语言服务、Sag服务、自动化Hook等,初次体验时均可选择“No”或“Skip”暂时跳过,以简化配置流程。
第三步:启动TUI界面,开始交互
所有配置完成后,选择“TUI”选项并回车,即可进入文本聊天界面,开始与你的AI助手对话。
第四步:管理与监控OpenClaw服务状态
在TUI聊天界面中,连续按两次 Ctrl + C 可以安全退出聊天模式。
退出后,在终端输入 openclaw status 可以查看OpenClaw核心服务的运行状态。
输入 openclaw gateway status 可以专门检查API网关的运行状况。
如需再次进入聊天界面,执行 openclaw tui 命令即可。
常见故障排查指南
问题:安装成功后,终端中无法识别 openclaw 命令。
请按顺序执行以下排查步骤:
- 验证Node.js是否正确安装:
node -v - 检查全局npm包的安装路径:
npm prefix -g - 确认该路径下的bin目录是否已加入系统的PATH环境变量:
echo “$PATH”
如果发现路径缺失,需要将其添加到你的shell启动文件(例如 ~/.zshrc 或 ~/.bashrc)中。添加如下一行:
export PATH="$(npm prefix -g)/bin:$PATH"
添加完成后,请关闭当前终端窗口并重新开启一个新的终端会话,使配置生效。
总结
至此,你已完成了OpenClaw从系统部署到基础模型配置的全过程。现在,这款功能强大的开源AI助手已准备就绪,为你提供本地化的智能对话与任务处理能力。它不仅是高效的工作伙伴,更是探索AI技术应用的绝佳起点。接下来,请深入体验其各项功能,让它真正融入你的数字工作流。























