openclaw github installation guide：官方安装全流程！
安装前准备
在开始部署 OpenClaw 之前，请确保你的系统满足以下基础要求，并预先获取必要的配置信息。
大模型选择：OpenClaw 原生支持多种主流模型。官方认证的推荐选项包括 Kimi (Moonshot AI)、OpenAI GPT 系列以及 Anthropic Claude，你需要预先获取其中至少一个的可用 API 密钥。
系统要求：软件兼容 Windows 10/11、macOS Monterey (12) 或更高版本，以及 Ubuntu 22.04 LTS 等现代 Linux 发行版。
依赖条件：核心运行环境需要 Node.js v22 或更高版本。使用官方一键安装脚本将自动处理 Node.js 与包管理器。仅当选择从源码编译安装时，才需要预先安装 Git。
内存要求：最低需保证 2GB 可用内存。为保证智能体多任务处理与响应的流畅性，建议分配 4GB 或更多系统内存。
网络环境：安装进程需从远程仓库拉取核心包与依赖库，请确保你的网络连接稳定且可访问相关域名。
权限要求：在 Windows 系统上，务必使用管理员身份启动 PowerShell。在 Linux 或 macOS 上执行安装命令，通常需要 sudo 权限以写入系统目录。
第一步：安装 OpenClaw（推荐新手使用，3 分钟完成）
这是最快捷的部署方案。官方提供的自动化脚本会检测你的操作系统环境，并完成所有必要的依赖安装与配置，避免手动操作可能出现的错误。
请根据你的操作系统，选择对应的安装指令：
macOS / Linux
打开终端应用程序，复制并执行以下命令。脚本将自动安装 Node.js（如未安装）及 OpenClaw 本体。
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell 管理员模式）
关键步骤：通过开始菜单搜索“PowerShell”，然后右键单击并选择“以管理员身份运行”。
在开启的管理员权限 PowerShell 窗口中，执行以下命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
此后，脚本将自动完成环境检测、Node.js 部署及 OpenClaw 核心安装，请等待其执行完毕。
第二步：入门新手引导（配置模型）
安装完成后，系统将启动一个交互式配置向导，这是连接AI模型核心服务的必要步骤。
安装完成后，终端会显示初始化界面。使用键盘左右方向键选择 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 账户。
在控制台左侧导航栏，点击 API Key 管理，选择“创建 API Key”，复制生成的全新密钥字符串。
切回 OpenClaw 配置终端，粘贴你复制的 API Key 并回车。接着，在给出的模型列表中，选择 Moonshot/Kimi-K2.5，回车确认。
下一步是选择交互界面。对于首次使用，建议直接选用内置的 tui（文本用户界面）进行快速体验。
选择网络搜索提供商时，直接匹配当前模型，选择 Kimi。
此时，你需要返回 Kimi 平台，专门为联网搜索功能创建一个新的 API Key。
复制这个专用于搜索的 Key，返回 OpenClaw 配置终端粘贴，并回车确认。
接下来的配置涉及技能包安装。选择 Yes 以启用技能配置向导。
在技能列表中，使用空格键勾选你希望启用的功能，随后回车开始安装所有已选技能。
后续会提示配置多项拓展服务，包括 Google Places、Notion API、Open AI 语言服务、Sag 服务及自动化 Hook。为简化首次配置，均可选择 No 或跳过。
第三步：使用 TUI 快速体验，开始畅聊
核心配置完成。最后选择 TUI 并回车，你的 OpenClaw 智能体即可启动并进入对话模式。
第四步：查看 OpenClaw 状态
完成初步体验后，你可以查看智能体的运行状态。首先，在 TUI 界面中连续按两次 Ctrl + C 以安全退出。
在终端中输入 openclaw status，可查看智能体的核心运行状态与版本信息。
输入 openclaw gateway status，可检查网关服务的当前状态。
如需再次启动聊天界面，随时在终端输入 openclaw tui 即可重新进入。
常见问题及解决方案：未找到 OpenClaw
若安装后在终端输入 openclaw 命令提示未找到，通常是系统 PATH 环境变量未包含安装目录所致。请按顺序执行以下诊断命令：
首先，验证 Node.js 是否已正确安装：node -v
其次，查找全局 npm 包的安装路径：npm prefix -g
最后，检查该路径下的 bin 目录是否已加入系统 PATH：echo “\$PATH”
如果发现全局 bin 目录不在输出的 PATH 中，你需要手动将其添加。使用文本编辑器打开你的 shell 配置文件（例如 ~/.zshrc 或 ~/.bashrc），在末尾添加如下行：
export PATH="\$(npm prefix -g)/bin:\$PATH"
保存文件后，请务必重新启动终端窗口或执行 source 命令，使环境变量变更生效。
结语
至此，你已完成 OpenClaw 的完整安装与基础配置。
本指南已带你完成了从环境准备、一键部署、模型配置到初步使用的全流程。你现已成功在本地运行起这款开源的 AI 智能体框架。其模块化技能与 TUI 界面已就绪，可供你深度调用与探索。接下来，你可以着手配置更复杂的技能链，集成外部工具，或基于此框架开发自定义功能，以充分释放其在自动化与智能交互方面的潜力。