开源个人 AI 助手 OpenClaw(俗称 “小龙虾”),现已支持全平台私有化部署。官方提供 Windows、macOS、Linux 三大系统全覆盖的标准化安装方案,同步预配置登顶 OpenClaw 使用榜的 Kimi K2.5 模型,全程操作仅需 5 分钟即可完成部署。安装完成即可获得稳定运行的服务网关、配置完成的身份验证模块、开箱即用的聊天会话功能,为用户打造可直接落地使用的专属个人 AI 助手。

安装前准备

系统要求: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 https://openclaw.ai/install.sh | bash
在这里插入图片描述

Windows(PowerShell管理员模式)

  1. 以管理员身份打开PowerShell(开始菜单搜索PowerShell,右键选择"以管理员身份运行")
  2. 执行以下命令:
    iwr -useb https://openclaw.ai/install.ps1 | iex
  3. 等待脚本自动完成Node.js检测、安装和OpenClaw配置

第二步:入门新手引导(配置模型)

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

  1. 第一步安装成功后显示下面画面,我们选择 Yes并回车,表示知道风险。可以用键盘方向键左右切换Yes或No
    在这里插入图片描述

  2. 选择快速安装模式 QuickStart 并敲击回车确认
    在这里插入图片描述

  3. 选择Model,这里我们选择OpenClaw创始人推荐的Moonshot AI(Kimi K2.5)进行作为基础模型。
    在这里插入图片描述

Moonshot AI(Kimi K2.5)配置步骤

  1. 中国用户,选择Moonshot AI .cn 接入点
    在这里插入图片描述

  2. 登录Kimi网站获取API Key,访问 https://platform.moonshot.cn/console 点击登录
    在这里插入图片描述

  3. 点击左侧的API Key管理,创建API Key,复制弹出的密钥字符
    在这里插入图片描述

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

  5. 选择与OpenClaw聊天的载体,我们可以先跳过,使用tui进行体验。
    在这里插入图片描述

  6. 选择网络搜索提供商,选择Kimi
    在这里插入图片描述

  7. 然后回到Kimi工作台,创建一个搜索专用的API Key
    在这里插入图片描述

  8. 复制Key并粘贴到OpenClaw配置步骤,敲击回车确认
    在这里插入图片描述

  9. 选择你OpenClaw的技能和一些配置,选择Yes
    在这里插入图片描述

  10. 选择你想用的Skill,按回车确认安装所有勾选的Skills
    在这里插入图片描述

  11. Google Places选择No跳过
    在这里插入图片描述

  12. Notion API选择No
    在这里插入图片描述

  13. Open AI语言服务选择No
    在这里插入图片描述

  14. Sag 服务选择No
    在这里插入图片描述

  15. 自动化Hook选择跳过
    在这里插入图片描述

第三步:使用TUI快速体验,开始畅聊

选择TUI并敲击回车
在这里插入图片描述

第四步:查看OpenClaw状态

  1. 连续按两次ctrl + c,先退出TUI
    在这里插入图片描述
  2. 输入 openclaw status 可查看当前状态
    在这里插入图片描述
  3. 输入openclaw gateway status 可查看 gateway状态
    在这里插入图片描述
  4. 输入openclaw tui 可返回 tui继续聊天
    在这里插入图片描述

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

如果安装成功但在终端中找不到 openclaw:
node -v # Node 是否已安装?
npm prefix -g # 全局包位于何处?
echo “$PATH” # 全局二进制目录是否在 PATH 中?

  • 如果未包含在 PATH 中,请将其添加到 shell 启动文件(或)中:(npmprefix−g)/bin(npm prefix -g)/bin(npmprefixg)/binPATH/.zshrc/.bashrc
    export PATH=“(npmprefix−g)/bin:(npm prefix -g)/bin:(npmprefixg)/bin:PATH”
    然后打开一个新的终端。

结语

以上为 OpenClaw 完整的入门与本地部署流程,恭喜你已成功搭建并启用这款开源 AI 助手。现在你的本地 AI 服务已正式运行,你可以开始自由对话与深度探索,让 “AI 小龙虾” 成为高效辅助工具,挖掘更多 AI 应用场景与全新可能。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐