OpenClaw 安装前准备：检查系统环境与必备条件
在开始部署 OpenClaw 之前，请先确认您的系统环境满足以下基础要求，以确保安装过程顺利无阻。
大模型选择：OpenClaw 支持接入 Kimi（Moonshot AI）、OpenAI、Anthropic 等主流大语言模型 API。您可以根据自身需求，选择其中一个已拥有有效 API Key 的模型进行配置。
系统要求：兼容性广泛。支持 Windows 10 及以上版本、macOS 12（Monterey）及以上版本，以及 Ubuntu 22.04 LTS 等主流 Linux 发行版。
依赖条件：核心运行时环境为 Node.js，版本需不低于 v22。推荐使用官方提供的一键安装脚本，该脚本会自动处理 Node.js 与包管理器（npm/pnpm）的安装。若计划通过源码编译安装，则需提前自行安装 Git。
内存要求：最低需要 2GB 可用内存。为保证 AI 智能体运行流畅，建议分配 4GB 或更高内存空间。
网络环境：安装过程中需要从远程仓库下载安装包及相关依赖，请确保网络连接稳定畅通。
权限要求：这是关键步骤。在 Windows 系统上，务必使用管理员身份运行 PowerShell；在 Linux 或 macOS 系统上，执行安装命令时则需要具备 sudo 权限。
第一步：安装 OpenClaw（推荐新手使用一键脚本，3分钟极速部署）
对于初次接触 OpenClaw 的用户，我们强烈推荐使用官方提供的一键自动化安装脚本。它能智能检测您的操作系统环境，自动安装所有必需的依赖项，帮助您绕过繁琐的手动配置环节，实现快速部署。
请根据您的操作系统，选择对应的安装命令：
macOS 与 Linux 系统安装方法
打开终端（Terminal），复制并粘贴以下命令，按回车执行。随后脚本将自动完成 Node.js 等依赖以及 OpenClaw 本体的安装，您只需等待片刻即可。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 系统安装方法（务必使用管理员权限）
操作顺序至关重要：请在开始菜单中搜索“PowerShell”，然后右键点击，选择“以管理员身份运行”。
在打开的管理员 PowerShell 窗口中，执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
执行后，脚本将自动完成从环境检测、Node.js 安装到 OpenClaw 配置的全流程，请您耐心等待安装完成。
第二步：OpenClaw 新手引导与模型配置详解
安装成功只是第一步，接下来会启动一个交互式配置向导，引导您完成最核心的大模型连接设置。
安装成功后，终端会显示引导界面。请使用键盘左右方向键选择 Yes，然后按回车键继续。
接着，在模式选择中，请选择 QuickStart（快速开始模式），回车确认。
现在是关键配置：选择您要接入的大语言模型。OpenClaw 官方推荐 Moonshot AI（Kimi K2.5）、OpenAI 或 Anthropic。您可按需选择，本教程将以在国内访问便利的 Kimi K2.5 模型为例进行演示。
Moonshot AI（Kimi K2.5）详细配置步骤
首先，为了获得更佳的网络连接稳定性，建议中国用户选择 Moonshot AI .cn 国内接入点。
接下来，您需要获取 API Key。请打开浏览器，访问 https://platform.moonshot.cn/console 并使用您的 Kimi 账号登录。
登录 Kimi 开放平台后，在左侧导航栏找到 API Key 管理，点击“创建 API Key”，然后将生成的一长串密钥字符完整复制下来。
回到 OpenClaw 的配置终端界面，粘贴您刚刚复制的 API Key，回车。随后，在模型列表中选择 Moonshot/Kimi-K2.5，再次回车确认。
下一步，选择与 OpenClaw 交互的客户端界面。对于初次体验，我们建议选择轻量级的 tui（文本用户界面）即可。
选择网络搜索功能提供商时，自然选择 Kimi 即可。
此时，您需要再次回到 Kimi 平台，为联网搜索功能专门创建一个新的 API Key。
复制这个专用于搜索的新 Key，返回 OpenClaw 配置终端粘贴，回车确认。
接下来的配置，是为您的 OpenClaw 智能体安装扩展技能包。首先选择 Yes 来启用技能配置功能。
在技能列表页面，使用空格键勾选您希望安装的实用技能，然后回车确认安装所有已选技能。
后续出现的如 Google Places、Notion API、OpenAI 语言服务、Sag 服务以及自动化 Hook 等高级服务，在初次体验时均可选择 No 或直接跳过，以保持配置简洁。
第三步：启动 TUI 界面，开始与 AI 智能体对话
核心配置即将完成。请选择 TUI 模式并回车，您的专属 OpenClaw “小龙虾”助手便已成功激活，现在可以开始与它进行对话了。
第四步：如何查看与管理 OpenClaw 运行状态
体验对话后，您可能需要查看助手的运行状态。请先连续按两次 Ctrl + C 组合键退出 TUI 界面。
在终端中输入命令 openclaw status，即可查看 OpenClaw 核心服务的当前运行状态。
输入命令 openclaw gateway status，可以查看网关的连接状态。
若想再次启动聊天界面，只需输入 openclaw tui 命令即可随时返回。
常见问题排查：终端中未找到 OpenClaw 命令
若安装成功后，在终端输入 openclaw 命令却提示未找到，这通常是系统 PATH 环境变量未正确配置所致。请按以下步骤进行排查与修复：
首先，验证 Node.js 是否正确安装：node -v
其次，查看 npm 全局包的安装路径：npm prefix -g
最后，检查该路径是否已包含在系统的 PATH 变量中：echo “\$PATH”
如果发现上述命令输出的全局包 bin 目录不在 PATH 中，您需要手动将其添加。请编辑您使用的 shell 配置文件（例如 ~/.zshrc、~/.bashrc 或 ~/.bash_profile），在文件末尾添加如下一行：
export PATH="\$(npm prefix -g)/bin:\$PATH"
保存文件后，请务必重新启动一个新的终端窗口，或执行 source 命令使环境变量生效。
OpenClaw 安装总结
至此，您已成功完成了 OpenClaw AI 智能体的全部安装与配置流程。
这份详细的 OpenClaw 安装教程已全部讲解完毕。恭喜您从零开始，成功在本地部署了这款功能强大的开源 AI 智能体工具——您的得力“小龙虾”助手。现在，它已经完成全链路配置，处于就绪状态。其内置的多种技能可供随时调用，智能对话畅通无阻。接下来，就带着您的新 AI 伙伴，去探索更多自动化办公、高效学习和创意生产的应用场景，深度发掘其潜能，正式开启您的智能化效率之旅吧！
