作者

dev-book

发布时间

2026/3/11

零基础本地部署小龙虾 OpenClaw：超详细保姆级教程

深度解析 OpenClaw 核心配置文件（SOUL.md, USER.md, AGENTS.md 等）的编写技巧，手把手教你配置性格、技能、安全策略及 MCP 连接，打造真正懂你的 24 小时 AI 助手。

返回列表

你养龙虾了吗？

最近「小龙虾」突然火了，全网都在聊怎么养它、怎么让它帮自己干活。

仿佛不装一只，就要落后这个 AI 时代。

那这个被大家亲切叫作「小龙虾」的 OpenClaw 到底是什么？

它比 ChatGPT、Gemini 等其他传统 AI 助手更好用吗？这个开源方案靠谱吗？

一份超级详细的零基础保姆级教程以及实用避坑指南，来啦！

小龙虾（OpenClaw）是什么？

图片

简单来说，OpenClaw 就是一个你 24 小时的个人 AI 助理。

OpenClaw 是 2026 年最火的开源 AI Agent 项目，目前 Github 已获得超过 27 万星标，仅仅用了 3 个月就超越了 React 和 Linux，成为获得星标最多的软件项目。

OpenClaw 星标数超越 React

OpenClaw 星标数超越 React

它不是普通的聊天机器人，跟传统 AI 助手最大的区别是它不只能跟你聊天，还能真的帮你干活：自动化处理邮件、管理日程、整理文件、抓取网页数据、控制智能家居……

而且它开源免费，只需自行承担所选 AI 模型的 API 费用。

跟在线大模型相比，它的最大优势在于隐私安全和深度集成：所有数据留在本地，你随时通过 QQ、飞书、钉钉、Telegram 或网页面板跟它交互。

安装前准备工作

一台普通电脑，Mac、Windows 或 Linux 均可，Mac 体验最顺畅，Windows 推荐 WSL2。

一个稳定的网络环境，能够正常访问 Github。

大约 15-30 分钟时间。

完全不需要写代码，也不需要懂编程，所有操作都是复制粘贴命令在终端工具中执行。

需要注意的是：Mac 和 Windows 安装流程略有不同，但配置环节完全一致。

Mac 用户安装流程

自动安装（推荐）

官方推荐使用一键安装脚本，它会自动检测并安装 Node.js（要求版本 22 及以上）和必要依赖。

第一步：打开终端

按 Command + 空格，搜索并打开 macOS 终端。

搜索并打开终端

搜索并打开终端

第二步：执行安装脚本

直接复制下面这行命令，按回车执行：

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

脚本会自动处理 Node.js、Homebrew（如果缺失）等环境，整个过程 3-10 分钟。

中间可能需要输入开机密码，屏幕不会显示字符，正常盲打即可。

安装完成后，它会自动启动配置向导。

手动安装

第一步：安装 Node.js

Node.js 官网(nodejs.org/zh-cn/download)上详细列出了使用不同软件包管理工具的安装方式，考虑到后续在使用 OpenClaw 过程中需要用到软件包管理工具 Homebrew，推荐直接使用 Homebrew 安装 Node.js。

# 第1步：下载并安装 Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

# 第2步：下载并安装 Node.js：
brew install node@22

安装完成后，在终端中输入以下命令验证 Node.js 版本：

node -v

如果终端返回 vv22.xx.x 或者更高版本号就说明成功了。

需要注意的是，Apple Silicon 机器安装完 Homebrew 后，可能需要手动加 PATH（脚本会提示）：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

第二步：安装 OpenClaw

在终端输入下命令，全局安装 OpenClaw CLI：

npm install -g openclaw@latest

安装完成后，在终端输入以下命令验证是否安装成功：

openclaw --version

终端返回版本号说明安装成功。

Windows 用户安装流程

方式一：PowerShell 原生安装

一键脚本方式（推荐）

官方提供了专属 PowerShell 一键脚本，比手动配置 WSL 更简便（仍建议启用 WSL2 以获得最佳兼容性）。

第一步：以管理员身份打开 PowerShell

按 Win 键搜索 PowerShell，右键选择「以管理员身份运行」。

第二步：解除脚本执行限制

使用以下命令解除权限限制：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

第三步：执行 Windows 安装脚本

输入下面命令并回车：

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

这个脚本会自动安装 Node.js 和 OpenClaw。

手动安装方式（更可控，适合公司电脑/不想让脚本自动装 Node）

第一步：管理员 PowerShell 解除限制（同上）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

第二步：安装 Node.js 22+（三种推荐方式选一种）

1、最推荐：用 winget（Windows 11 自带）

在 PowerShell 中运行以下命令：

winget install OpenJS.NodeJS --version 22

# 或安装最新稳定版本：
winget install OpenJS.NodeJS.LTS

2、官网下载 .msi：https://nodejs.org/

3、用 nvm-windows 安装：https://github.com/coreybutler/nvm-windows

第三步：全局安装 OpenClaw

PowerShell 中运行以下命令：

npm install -g openclaw@latest

如果提示权限问题，可尝试：

npm install -g openclaw@latest --unsafe-perm

方式二：WSL2 + Ubuntu（目前最稳定、最推荐）

一键脚本方式（强烈推荐）

第一步：安装 WSL

在 PowerShell 里输入下面这行命令，按回车：

wsl --install

系统会自动下载和安装 WSL2 和 Ubuntu（一个 Linux 系统），需要几分钟到十几分钟。

安装完成后需要重启电脑。

重启后可能自动弹出 Ubuntu 窗口，设置用户名和密码。

用户名需要使用英文，不要使用空格和中文。

密码需要输入两次确认，输入时不会显示字符，盲打后回车。

如果重启后没有自动弹出 Ubuntu 窗口，在开始菜单中搜索 Ubuntu，点击打开它，然后按照提示设置用户名和密码。

什么是 WSL？
WSL（Windows Subsystem for Linux）是微软官方提供的一个工具，让你在 Windows 上运行 Linux 系统。
OpenClaw 不能直接在 Windows 上运行，需要通过 WSL 来运行。

第二步：打开 WSL 终端

以后每次操作 OpenClaw，都在这个 WSL 终端里进行（而不是 PowerShell）。

在开始菜单搜索 Ubuntu，点击打开，或者在 PowerShell 里输入 wsl 按回车。

你会看到一个类似 Linux 终端的窗口，显示类似 `user@你的电脑名:~ 的提示符。

怎么在 WSL 终端里粘贴命令？
复制命令后，在 WSL 终端窗口里右键点击就是粘贴。
或者用 Ctrl + Shift + V（注意：不是 Ctrl + V）。

第三步：一键安装 OpenClaw

在 WSL 终端里复制粘贴下面这行命令，按回车：

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

脚本会自动安装必要组件并启动向导。

整个过程大概 3-5 分钟，中间不要关掉窗口。

手动安装方式（适合想自己管 Node 版本）

第一步：完成上面 WSL 安装 + 打开 Ubuntu 终端

第二步：更新系统 & 安装基本工具

在 WSL 终端中运行以下命令：

sudo apt update -y && sudo apt upgrade -y
sudo apt install -y curl gitbuild-essential

第三步：安装 Node.js 22+（两种主流方式选一种）

1、最推荐：用 nvm（版本切换最方便）

在 WSL 终端里依次输入下面的命令，每行输入后按回车等它执行完再输入下一行：

curl -o- https://raw.githubusercontent.com/nvm-

sh/nvm/v0.39.7/install.sh | bash

source ~/.bashrc

nvm install22

nvm use 22

nvm alias default 22

2、或者直接用 Nodesource

在 WSL 终端里依次输入下面的命令：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt install -y nodejs

依次安装完成后，在 WSL 终端中输出以下命令验证是否安装成功：

node --version 

终端显示 v22.x.x 或更高版本号就说明成功了。

第四步：全局安装 OpenClaw

在 WSL 终端里运行以下命令：

npm install -g openclaw@latest

Windows 系统下建议安装方式

  1. 先尝试 WSL2 一键方式（成功率最高）

  2. 如果你非常不想装 WSL → 再试 PowerShell 一键

  3. 都失败 → 手动方式 + 贴错误日志到社区求助

配置向导（Mac/Windows 通用）

安装完成后，会自动进入一个交互式的配置向导。

如果你在安装时跳过了配置向导，可以在终端中执行以下脚本重新打开配置向导：

openclaw onboard --install-daemon

它会一步一步问你问题，你只需要按提示选择就好。使用键盘上下箭头选择，回车键确认。

安全提醒与安装模式

配置向导的前两步是确认安全提醒与选择安装模式。

OpenClaw 安全提醒

OpenClaw 安全提醒

OpenClaw 会读取你电脑上的文件，建议在非敏感电脑上使用。或者在使用时注意限制它的访问范围。

OpenClaw 安装模式

OpenClaw 安装模式

安装模式可以直接选择 QuickStart 模式，系统自动完成基础设置。

等熟悉了以后，随时可以用 openclaw onboard 重新配置。

选择 AI 模型提供商（重要）

配置向导会询问你使用哪个 AI 模型，建议重点关注以下几个模型：

◇  Model/auth provider
│  ● OpenAI (GPT)
│  ○ Anthropic (Claude, 功能最全, 推理能力最强, API 很贵)
│  ○ DeepSeek (国内推荐, 支持支付宝充值, 注册即用)
│  ○ MiniMax (国产模型, 省钱之选, 中文能力强, 价格便宜)
│  ○ Moonshot AI (Kimi K2.5, 国内直连, 价格便宜)
│  ○ Google(Gemini, 性价比高, 中文不错)
│  ○ Z.AI (国产模型, 国内直连, 价格便宜)
│  ○ Qwen (国产模型, 国内直连, 价格便宜)
│  ○ OpenRouter (聚合多家模型)

选择建议：

  • 国内用户首选：MiniMax、Z.AI、 Moonshot 或 DeepSeek（国内直连，价格便宜）。

  • 追求效果：Claude 或 GPT 系列（用 API Key）。

  • 完全免费：Ollama（需本地高配置，不推荐新手）。

输入 API Key（推荐方式）

根据选择的提供商输入 API Key：

◇  DeepSeek API key
│  （粘贴你的 API Key）

访问对应官网创建密钥（仅显示一次，务必保存）。

常见地址：

选择默认模型

接下来配置向导让你选用哪个模型，屏幕上会列出该提供商的可用模型，根据需要选择相应的模型即可。

选择建议：

  • Claude Sonnet 4.5：性价比最高

  • OpenAI GPT-4o：速度快、效果好

  • Google Gemini 3.0 Flash：速度快又便宜

  • MiniMax M2.1/M2.5：中文强大、性价比高

  • Moonshot Kimi-K2.5：中文好、有免费额度

  • DeepSeek deepseek-chat：国内直连、便宜

  • Z.AI GLM-4.7/GLM-5：中文好、有免费额度

配置聊天渠道（可选）

向导会询问是否配置飞书、Discord、Telegram 等聊天渠道。如果暂时不需要，可以选择跳过，后续通过 openclaw configure 添加。

图片

配置技能（可选）

向导会显示可用的技能列表，询问是否安装。建议先跳过，等熟悉基本操作后再安装。

后续所有额外选项都可以选 NO 或者跳过即可。

配置向导结束后，会出现类似「OpenClaw is ready」或者 「Your AI assistant is now running」的提示，就说明安装配置全部完成了！

完成后，向导会自动启动 Gateway 守护进程。

验证安装与日常使用

在终端输入以下命令检查：

openclaw status  

看到 Gateway service: running 说明安装成功。

如果显示没在运行，可以输入 openclaw gateway start 启动它。

在终端运行以下命令可以打开网页面板：

openclaw dashboard

浏览器会自动打开 http://localhost:18789，你可以在这里和小龙虾 OpenClaw 对话。

可以向它发一条测试消息：「你好，介绍一下自己」。

收到回复即表示一切正常，安装成功！

如果你想更全面地检查有没有问题，可以在终端中输入：

openclaw doctor 

它会自动检查各项配置是否正常，有问题会给出修复建议。

常见问题处理

  • 命令找不到:

    运行 npm config get prefix，将路径加入系统 PATH（官方推荐方法）。

  • 面板打不开:

    先 openclaw gateway start，或尝试更换端口 openclaw gateway --port 18790。

  • API 不响应:

    用 openclaw doctor 检查密钥和余额。

  • Mac sharp 构建失败:

    加环境变量 SHARP_IGNORE_GLOBAL_LIBVIPS=1 后重装。

总结

安装成功只是第一步。

OpenClaw 真正强大的部分，才刚刚开始。

接下来，你可以通过聊天框给它安装各种技能，让它真正帮你处理邮件、日程、网页抓取这些实际事务。

更多技能可以在 ClawHub（https://clawhub.ai/）上浏览和安装。
目前 ClawHub 上已经有超过 13,000 个社区技能。

也可以编辑工作目录里的几个 .md 文件，给它设定性格、记忆和做事规则。

建议你先在聊天框输入「安装 Tavily Search」和「安装 Firecrawl」，上手试用一下。

Tavily Search 可以让 AI 联网搜索最新资讯，能查实时信息，不再只靠训练数据。零配置，装上就用。
Firecrawl 能让 AI 抓取网页内容、提取正文，给 AI 一个链接，它就能读懂整个网页并总结。

等用得顺手了，再花十分钟配置 SOUL.md 和 USER.md 文件。

SOUL.md：告诉 AI 它是谁，确定 AI 助手的性格、说话方式和行为准则。
USER.md：告诉 AI 你是谁，让它了解你的习惯和偏好。

你会明显感觉到，它不再是一个普通的 AI 聊天工具，而是开始真正懂你、能主动帮你做事。

所有设置都不用一次做到位，随时可以调整。