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

📅 发布时间:2026/7/10 13:21:12 👁️ 浏览次数:
零基础本地部署小龙虾 OpenClaw:超详细保姆级教程
你养龙虾了吗最近「小龙虾」突然火了全网都在聊怎么养它、怎么让它帮自己干活。仿佛不装一只就要落后这个 AI 时代。那这个被大家亲切叫作「小龙虾」的 OpenClaw 到底是什么它比 ChatGPT、Gemini 等其他传统 AI 助手更好用吗这个开源方案靠谱吗一份超级详细的零基础保姆级教程以及实用避坑指南来啦小龙虾OpenClaw是什么简单来说OpenClaw 就是一个你 24 小时的个人 AI 助理。OpenClaw 是 2026 年最火的开源 AI Agent 项目目前 Github 已获得超过 27 万星标仅仅用了 2 个月就超越了 React 和 Linux成为获得星标最多的软件项目。它不是普通的聊天机器人跟传统 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.jsNode.js 官网上详细列出了使用不同软件包管理工具的安装方式考虑到后续在使用 OpenClaw 过程中需要乃至软件包管理工具 Homebrew推荐直接使用 Homebrew 安装 Node.js。第1步下载并安装 Homebrewcurl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash第2步下载并安装 Node.jsbrew install node22安装完成后在终端中输入以下命令验证 Node.js 版本node -v如果终端返回 v22.xx.x 或者更高版本号就说明成功了。需要注意的是Apple Silicon 机器安装完 Homebrew 后可能需要手动加 PATH脚本会提示echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv)第二步安装 OpenClaw在终端输入下命令全局安装 OpenClaw CLInpm install -g openclawlatest安装完成后在终端输入以下命令验证是否安装成功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、最推荐用 wingetWindows 11 自带在 PowerShell 中运行以下命令winget install OpenJS.NodeJS --version 22或安装最新稳定版本winget install OpenJS.NodeJS.LTS2、官网下载 .msinodejs.org/3、用 nvm-windows 安装github.com/coreybutler/nvm-windows第三步全局安装 OpenClawPowerShell 中运行以下命令npm install -g openclawlatest如果提示权限问题可尝试npm install -g openclawlatest --unsafe-perm方式二WSL2 Ubuntu目前最稳定、最推荐一键脚本方式强烈推荐第一步安装 WSL在 PowerShell 里输入下面这行命令按回车wsl --install系统会自动下载和安装 WSL2 和 Ubuntu一个 Linux 系统需要几分钟到十几分钟。安装完成后需要重启电脑。重启后可能自动弹出 Ubuntu 窗口设置用户名和密码。用户名需要使用英文不要使用空格和中文。密码需要输入两次确认输入时不会显示字符盲打后回车。如果重启后没有自动弹出 Ubuntu 窗口在开始菜单中搜索 Ubuntu点击打开它然后按照提示设置用户名和密码。**什么是 WSL**WSLWindows 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 git build-essential第三步安装 Node.js 22两种主流方式选一种1、最推荐用 nvm版本切换最方便在 WSL 终端里依次输入下面的命令每行输入后按回车等它执行完再输入下一行curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashsource ~/.bashrcnvm install 22nvm use 22nvm alias default 222、或者直接用 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 openclawlatestWindows 系统下建议安装方式先尝试 WSL2 一键方式成功率最高如果你非常不想装 WSL → 再试 PowerShell 一键都失败 → 手动方式 贴错误日志到社区求助配置向导Mac/Windows 通用安装完成后会自动进入一个交互式的配置向导。如果你在安装时跳过了配置向导可以在终端中执行以下脚本重新打开配置向导openclaw onboard --install-daemon它会一步一步问你问题你只需要按提示选择就好。使用键盘上下箭头选择回车键确认。安全提醒与安装模式配置向导的前两步是确认安全提醒与选择安装模式。OpenClaw 会读取你电脑上的文件建议在非敏感电脑上使用。或者在使用时注意限制它的访问范围。安装模式可以直接选择 QuickStart 模式系统自动完成基础设置。等熟悉了以后随时可以用 openclaw onboard 重新配置。选择 AI 模型提供商重要配置向导会询问你使用哪个 AI 模型建议重点关注以下几个模型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访问对应官网创建密钥仅显示一次务必保存。常见地址DeepSeekhttps://platform.deepseek.com/api_keysMiniMaxhttps://platform.minimax.com/Anthropic Claudehttps://console.anthropic.com/OpenAI: https://platform.openai.com选择默认模型接下来配置向导让你选用哪个模型屏幕上会列出该提供商的可用模型根据需要选择相应的模型即可。选择建议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_LIBVIPS1 后重装。总结安装成功只是第一步。OpenClaw 真正强大的部分才刚刚开始。接下来你可以通过聊天框给它安装各种技能让它真正帮你处理邮件、日程、网页抓取这些实际事务。更多技能可以在 ClawHubhttps://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 聊天工具而是开始真正懂你、能主动帮你做事。所有设置都不用一次做到位随时可以调整。如果你在使用过程中遇到任何问题欢迎在评论区留言我看到会尽量帮你一起排查解决。