安装前准备
开始安装前，请仔细核对您的本地环境是否满足以下必备条件。充分的前期准备可以确保整个OpenClaw部署过程顺畅无阻。
操作系统要求：支持Windows 10及以上版本、macOS 12.0+，以及Ubuntu 22.04等主流的Linux发行版。内存建议：虽然2GB内存可以满足最低运行要求，但为了获得更好的AI模型运行流畅度，推荐准备4GB或更大的内存。网络连接：安装过程需在线下载必需的依赖包与核心组件，请确保网络环境稳定。系统权限：不同平台的操作权限有所不同：Windows用户请务必使用管理员模式运行PowerShell；macOS与Linux用户在执行部分安装命令时，可能需要使用sudo权限。逐一确认上述条件，将为后续顺利安装铺平道路。
第一步：安装 OpenClaw（新手入门首选，3 分钟完成）
对于首次接触命令行安装的用户，我们极力推荐使用官方提供的一键自动化安装脚本。它的核心优势在于智能化环境检测与全自动依赖部署，能够自动为您安装包括Node.js在内的所有必备组件，无需任何手动干预。这是快速上手OpenClaw AI助手最高效、最便捷的方式。
macOS / Linux
具体操作流程非常简单。首先，打开您系统自带的终端应用，将下方提供的安装命令完整复制粘贴到终端窗口中，按下回车键执行。随后，脚本将自动运行，完成从系统环境检测到OpenClaw主体安装的全部工作，您只需耐心等待片刻。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell 管理员模式）
Windows用户的安装起点略有不同。请先在开始菜单中搜索“PowerShell”，然后右键单击选择“以管理员身份运行”，务必确保拥有足够的系统权限。
在打开的管理员PowerShell窗口中，直接执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
此命令会调用PowerShell脚本，自动完成Node.js环境检查、安装以及OpenClaw核心配置等一系列流程，全程无需手动操作。
第二步：入门新手引导（配置模型）
安装程序成功运行后，会自动启动一个交互式的新手套装配置向导。这个向导将引导您完成最关键的模型接入与功能设置，让您的OpenClaw具备AI能力。
安装完成后，终端界面将显示欢迎与引导信息。第一步通常是用户协议与风险提示，使用键盘的方向键选择“Yes”并回车确认即可继续。
接下来需要选择安装模式。我们建议所有新手用户直接选择“QuickStart”（快速安装）模式，回车确认，这将采用最常用的默认配置。
模型选择是关键步骤。在此环节，您可以依据开发团队的建议，选择性能表现均衡的“Moonshot AI (Kimi K2.5)”作为基础大语言模型。
Moonshot AI（Kimi K2.5）配置步骤
针对大陆用户，为了优化网络延迟和访问体验，在接入点选择时，请务必手动选择“Moonshot AI .cn”这个国内节点。
下一步是获取并配置API密钥。请打开您的浏览器，访问Kimi AI的官方网站并登录账户，在左侧导航栏找到“API Key 管理”页面。点击“创建API Key”按钮，系统将生成一串唯一的密钥字符串，请立即完整复制该密钥。
切回到OpenClaw的配置终端窗口继续操作。
将刚刚复制的API Key完整粘贴到终端的提示处，按回车确认。随后在出现的模型列表中，选择“Moonshot/Kimi-K2.5”这一项，再次回车确认。
接下来选择与OpenClaw交互的客户端界面。初次体验时，为了简化流程，可以直接选择使用内置的“tui”（文本用户界面）进行对话。
配置网络搜索提供商，此处我们继续选择“Kimi”作为搜索引擎。
此步骤需要另一个专用的网络搜索API密钥。请再次返回Kimi AI工作台，专门为搜索功能创建一个新的API Key。
复制这个搜索专用的新Key，回到配置向导，将其粘贴到相应位置并回车确认。
后续向导会出现一系列关于安装额外功能技能和附加服务的选项。对于核心的技能扩展包，建议选择“Yes”同意安装，以解锁更多AI能力。
在提供的技能列表中，使用空格键勾选您希望启用的具体Skill（技能），勾选完毕后按回车确认，系统将安装所有已选技能。
对于后续出现的部分高级或第三方集成服务，例如Google Places、Notion API、OpenAI语音服务、Sag服务、自动化钩子等，在初次配置时均可选择“No”或“跳过”。待熟悉基本功能后，可随时返回重新启用以扩展用途。
第三步：使用 TUI 快速体验，开始畅聊
所有配置完成后，即可立即开始体验。在载体的最终选择界面，确保选中“TUI”选项并回车，系统将启动一个纯文本的对话界面。现在，您可以开始与您的OpenClaw AI助手进行首次对话交互了。
第四步：查看 OpenClaw 状态
想要随时掌握OpenClaw服务的运行状态，可以通过简单的命令来实现。
首先，在TUI聊天界面中，快速连续按下两次 Ctrl + C 组合键，即可安全退出聊天，返回到系统的命令行提示符下。
输入状态检查命令：openclaw status，可以查看OpenClaw核心服务的整体运行状态与健康信息。
输入网关状态命令：openclaw gateway status，可以专门查看API网关的详细状态和连接情况。
如果想再次进入文本聊天界面，只需输入启动命令：openclaw tui，即可快速返回。
常见问题及解决方案：未找到 OpenClaw
若安装过程没有报错，但在终端中尝试输入openclaw相关命令时，系统提示“command not found”（命令未找到），这通常是系统的环境变量路径（PATH）未正确配置所致。请按以下顺序排查：
1. 验证Node.js安装：首先执行 node -v，确认Node.js已成功安装并显示版本号。
2. 查找全局安装目录：执行 npm prefix -g，查看npm全局包的安装路径。
3. 检查PATH变量：执行 echo “\$PATH”，检查输出的路径列表中是否包含上一步获取的全局包路径下的`/bin`目录。
如果检查发现PATH中确实缺少该路径，则需要手动将其添加至系统环境变量。请编辑您所用的Shell配置文件（例如Zsh用户的~/.zshrc，或Bash用户的~/.bashrc），在文件末尾添加如下一行配置：
export PATH="\$(npm prefix -g)/bin:\$PATH"
保存文件后，请注意：您需要完全关闭当前终端，并重新打开一个新的终端窗口，才能使修改的PATH环境变量生效。之后即可正常使用openclaw命令。
结语
通过以上详细步骤，您已经成功完成了从环境准备、一键安装、模型配置到最终体验的OpenClaw AI助手完整部署流程。祝贺您成功在本地计算机上搭建了这款功能强大的开源AI应用！
现在，通往个性化人工智能世界的大门已为您敞开。尽情与您专属的“AI助手”展开对话，深入探索其内置的各项强大技能，让它逐步成为您学习、工作和创意探索中不可或缺的智能伙伴，共同开启更多人工智能的奇妙应用场景。
