openclaw github installation guide：官方安装全流程！

掘金Agent
0 阅读4分钟

2026 年，早就不是 AI 光靠聊天就能火的时代了！整个行业都卷到了能落地、真干活的智能体阶段！被全球开发者叫 “龙虾” 的开源智能体框架 OpenClaw，直接靠 100% 私有化部署杀疯了，还原生适配官方推荐的 OpenAI、Anthropic、Kimi 等所有顶流大模型！

这篇给你整理了 Windows、macOS、Linux 全平台的保姆级部署教程，零门槛、超省时，手把手教你搞定网关搭建、认证配置、模型对接，快速拥有自己的专属 AI 私人助理，隐私全自己说了算，执行能力直接拉满！

安装前准备

  • 大模型选择：官方推荐Kimi、OpenAI、Anthropic等等
  • 系统要求：Windows 10+/macOS 12+/主流Linux发行版（Ubuntu 22.04+推荐）
  • 依赖条件：Node.js ≥ v22（一键脚本会自动安装）、npm/pnpm、Git（源码安装需要）
  • 内存要求：≥ 2GB（推荐 4GB+）
  • 网络环境：需联网下载安装包和依赖
  • 权限要求：Windows需PowerShell管理员权限，Linux/macOS需sudo权限

第一步：安装 OpenClaw（新手入门首选，3分钟完成）

这是官方最推荐的方式，自动检测并安装Node.js和所有依赖，无需手动配置环境

  • macOS / Linux

需要打开电脑终端软件，输入下面命令等待依赖和openclaw安装，主要依赖为Node JS

curl -fsSL openclaw.ai/install.sh | bash

img_v3_02104_01.png

  • Windows（ PowerShell 管理员 模式）
  1. 以管理员身份打开PowerShell（开始菜单搜索PowerShell，右键选择"以管理员身份运行"）
  2. 执行以下命令：

iwr -useb openclaw.ai/install.ps1 | iex

  1. 等待脚本自动完成Node.js检测、安装和OpenClaw配置

第二步：入门新手引导（配置模型）

入门向导会引导你完成以下核心设置:

  1. 第一步安装成功后显示下面画面，我们选择 Yes并回车，表示知道风险。可以用键盘方向键左右切换Yes或No

img_v3_02104_02.png

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

image-1.png

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

image-2.png

Moonshot AI（Kimi K2.5）配置步骤

  1. 中国用户，选择Moonshot AI .cn 接入点

image-3.png

  1. 登录Kimi网站获取API Key，访问 platform.moonshot.cn/console 点击登录

image-4.png

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

image-5.png

  1. 回到OpenClaw继续配置

将复制的API Key贴入终端并敲击回车，然后选择Moonshot/Kimi-K2.5模型并敲击回车确认。

image-6.png

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

image-7.png

  1. 选择网络搜索提供商，选择Kimi

image-8.png

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

image-9.png

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

image-10.png

  1. 选择你OpenClaw的技能和一些配置，选择Yes

image-11.png

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

image-12.png

  1. Google Places选择No跳过

image-13.png

  1. Notion API选择No

image-14.png

  1. Open AI语言服务选择No

image-15.png

  1. Sag 服务选择No

image-16.png

  1. 自动化Hook选择跳过

image-17.png

第三步：使用TUI快速体验，开始畅聊

选择TUI并敲击回车

image-18.png

第四步：查看OpenClaw状态

  1. 连续按两次ctrl + c，先退出TUI

image-19.png

  1. 输入 openclaw status 可查看当前状态

image-20.png

  1. 输入openclaw gateway status 可查看 gateway状态

image-21.png

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

image-22.png

常见问题及解决方案：未找到OpenClaw

  • 如果安装成功但在终端中找不到 openclaw：

node -v # Node 是否已安装？

npm prefix -g # 全局包位于何处？

echo “$PATH” # 全局二进制目录是否在 PATH 中？

  • 如果未包含在 PATH 中，请将其添加到 shell 启动文件（或）中：(npmprefix−g)/bin(npm prefix -g)/binPATH~/.zshrc~/.bashrc

export PATH="(npmprefix−g)/bin:(npm prefix -g)/bin:PATH"

然后打开一个新的终端。

结语

叮！恭喜通关 OpenClaw 从入门到部署全副本！

保姆级全流程教程已全线更新收官，所有关卡教学全部解锁完毕！你已经成功完成从 0 到 1 的本地部署挑战，拿下这款现象级开源 AI 智能体神装 —— 专属 “小龙虾” 助手！目前该装备已完成全链路调试，正式激活上线，全场景技能无冷却随心放，自由交互无任何限制！接下来就带着你的专属 AI 搭子，去刷更多 AI 效率新副本，解锁更多隐藏玩法，开启你的专属 AI 冒险之旅吧！

avatar
文章
阅读
粉丝