OpenClaw(业内俗称 “小龙虾”),是奥地利开发者 Peter Steinberger 于 2025 年 11 月发布、采用 MIT 开源协议的本地优先、模型无关的开源个人 AI 助手,也是一款具备系统级执行能力的 AI 智能体运行框架,官方核心定位为 “真正能执行任务的 AI”。它并非传统对话式 AI 或大语言模型本身,核心价值是打破 AI “只说不做” 的局限,为大模型赋予完整的系统级执行能力,实现从 “意图理解 → 任务拆解 → 执行闭环 → 结果反馈” 的全流程自动化,同时原生支持多平台私有化部署,全程数据本地留存,充分保障用户隐私与数据主权。
本文为您提供官方推荐的标准化安装方案,完整覆盖 Windows、macOS、Linux 三大主流操作系统,全流程操作仅需约 5 分钟即可完成。安装结束后,您将直接获得可正常运行的服务网关、已完成全配置的身份验证模块,以及可直接投入使用的交互式聊天会话环境。
安装前准备
系统要求:Windows 10+/macOS 12+/主流 Linux 发行版(Ubuntu 22.04+ 推荐)
依赖条件:Node.js ≥ v22(一键脚本会自动安装)、npm/pnpm、Git(源码安装需要)
内存要求:≥ 2GB(推荐 4GB+)
网络环境:需联网下载安装包和依赖
大模型选择:官方推荐 Kimi、OpenAI、Anthropic 等等
权限要求:Windows 需 PowerShell 管理员权限,Linux/macOS 需 sudo 权限
第一步:安装 OpenClaw(新手入门首选,3 分钟完成)
这是官方最推荐的方式,自动检测并安装 Node.js 和所有依赖,无需手动配置环境
macOS / Linux
需要打开电脑终端软件,输入下面命令等待依赖和 openclaw 安装,主要依赖为 Node JS
curl -fsSL https://openclaw.ai/install.sh | bash

Windows(PowerShell 管理员模式)
以管理员身份打开 PowerShell(开始菜单搜索 PowerShell,右键选择"以管理员身份运行")
执行以下命令:
iwr -useb https://openclaw.ai/install.ps1 | iex
等待脚本自动完成 Node.js 检测、安装和 OpenClaw 配置
第二步:入门新手引导(配置模型)
入门向导会引导你完成以下核心设置:
第一步安装成功后显示下面画面,我们选择 Yes 并回车,表示知道风险。可以用键盘方向键左右切换 Yes 或 No

选择快速安装模式 QuickStart 并敲击回车确认

选择 Model,这里我们按需选择 OpenClaw 创始人推荐的 Moonshot AI(Kimi K2.5)/ Open AI/ Anthropic 作为基础模型。(本次选择的是 Kimi K2.5 进行演示)

Moonshot AI(Kimi K2.5)配置步骤
中国用户,选择 Moonshot AI .cn 接入点

登录 Kimi 网站获取 API Key,访问 https://platform.moonshot.cn/console 点击登录

点击左侧的 API Key 管理,创建 API Key,复制弹出的密钥字符

回到 OpenClaw 继续配置
将复制的 API Key 贴入终端并敲击回车,然后选择 Moonshot/Kimi-K2.5 模型并敲击回车确认。

选择与 OpenClaw 聊天的载体,我们可以先跳过,使用 tui 进行体验。

选择网络搜索提供商,选择 Kimi

然后回到 Kimi 工作台,创建一个搜索专用的 API Key

复制 Key 并粘贴到 OpenClaw 配置步骤,敲击回车确认

选择你 OpenClaw 的技能和一些配置,选择 Yes

选择你想用的 Skill,按回车确认安装所有勾选的 Skills

Google Places 选择 No 跳过

Notion API 选择 No

Open AI 语言服务选择 No

Sag 服务选择 No

自动化 Hook 选择跳过

第三步:使用 TUI 快速体验,开始畅聊
选择 TUI 并敲击回车

第四步:查看 OpenClaw 状态
连续按两次 ctrl + c,先退出 TUI

输入 openclaw status 可查看当前状态

输入 openclaw gateway status 可查看 gateway 状态

输入 openclaw tui 可返回 tui 继续聊天

常见问题及解决方案:未找到 OpenClaw
如果安装成功但在终端中找不到 openclaw:
node -v # Node 是否已安装?
npm prefix -g # 全局包位于何处?
echo “$PATH” # 全局二进制目录是否在 PATH 中?
如果未包含在 PATH 中,请将其添加到 shell 启动文件(或)中:$(npm prefix -g)/bin$ PATH~/.zshrc~/.bashrc
export PATH="$(npm prefix -g)/bin:$ PATH"
然后打开一个新的终端。
结语
OpenClaw 从入门到部署保姆级教程全部内容已正式完结。恭喜您顺利完成 OpenClaw 本地环境的全流程搭建,成功解锁这款热门 AI 智能体助手!您的专属 AI 助手 “小龙虾” 现已完成部署并正式上线,支持全场景自由交互与功能调用。您可将其作为全能 AI 搭档,即刻开启正式的交互使用。











