位置：AI门户网
> AI应用 > AI智能体 > 手把手教你部署“小龙虾”：从零到一的OpenClaw安装与配置全攻略
你是否也曾幻想过，有一个数字助手能真正听懂你的话，并动手帮你完成电脑上的各种任务？比如，你只说一句“帮我整理桌面文件”，它就能自动分类归档；你说“查一下明天天气并记在备忘录里”，它就能打开浏览器搜索并生成记录。这听起来像是科幻电影里的场景，但今天，我要告诉你，这一切已经触手可及——通过一个名为OpenClaw的开源项目，网友们亲切地称它为“小龙虾”。 它不是一个简单的聊天机器人，而是一个能真正操作你电脑系统、执行复杂任务的AI智能体框架。
别被“智能体框架”、“本地部署”这些词吓到，觉得这一定是程序员们的专属玩具。说实话，我刚开始接触时也有点发怵，但跟着教程一步步走下来，发现……其实没那么难。这篇文章，就是为你准备的“保姆级”指南。咱们不聊复杂概念，就实实在在地，从准备工作开始，一直到让你的“小龙虾”成功跑起来、开始干活。我会尽量用大白话，把每一步都讲清楚，还会分享一些我踩过的“坑”和解决技巧。好了，话不多说，咱们开始“养虾”之旅！
在兴冲冲地开始安装之前，咱们得先看看自己的电脑环境是否达标。这就好比养宠物前，得先看看家里空间够不够、环境适不适合。盲目开工，很可能中途报错，打击积极性。
1. 硬件配置：你的电脑够“硬核”吗？
OpenClaw本身是一个框架，对硬件的要求主要取决于你打算让它干什么活，以及你为它配备的“大脑”（即AI模型）在哪里运行。
| 硬件组件 | 最低要求 | 推荐配置 | 说明与建议 |
|---|---|---|---|
| :--- | :--- | :--- | :--- |
| CPU | 2核 | 2核或更高 | 核心数影响任务处理并发能力，基础操作2核足够。 |
| 内存 | 4GB | 8GB或以上 | 这是关键！如果你打算在本地运行大模型（如通过Ollama），8GB是起步线，复杂任务或多技能运行时，内存越大越流畅。 |
| 存储空间 | 20GBSSD(或2GB可用空间) | 40GBESSD云盘或10GB+SSD | 需要空间存放OpenClaw本身、依赖包，以及可能的本地模型文件（一个7B参数的模型约4GB）。 |
*思考一下：*如果你的电脑是近几年购置的，大概率是能满足最低要求的。但如果内存只有4GB，又想在本地跑模型，可能会比较吃力，建议先尝试使用云端API模型的方式。
2. 软件与环境：打好基础才能盖高楼
这是安装成功与否的重中之重，请务必仔细核对。
了解要求后，我们面临一个选择：是把“小龙虾”养在云服务器上，还是养在自己的电脑里？两者各有优劣。
*这里插一句*：无论选择哪种方式，根据一些教程提示，科学稳定的网络环境对于顺利下载安装包和依赖至关重要。
我们假设你是在Windows 11系统上进行操作。Win10用户步骤基本一致，请确保系统已更新并启用了WSL2（如果需要）。 整个过程，请尽量使用管理员身份运行PowerShell终端，这能避免很多权限错误。
阶段一：安装核心环境
1.安装Node.js：访问Node.js官网，下载v22.x LTS版本的安装程序。运行安装包，基本上一路点击“Next”即可，安装路径避免使用中文或空格。
2.安装Git：访问Git官网，下载for Windows的版本。安装过程中，在“Adjusting your PATH environment”这一步，建议选择“Git from the command line and also from 3rd-party software”，这样方便后续在命令行中使用git命令。
3.（可选但推荐）创建系统还原点：这是一个非常重要的“后悔药”！特别是对于电脑新手。你可以在Windows搜索框输入“创建还原点”，为系统盘（通常是C盘）创建一个还原点，命名为“Before_OpenClaw_Install”。万一安装过程中系统出现异常，可以一键恢复。
4.（可选但推荐）创建专用文件夹：在非系统盘（比如D盘或E盘）新建一个文件夹，例如 `D:""OpenClaw_Project`。以后所有相关的操作、脚本、日志都放在这里，方便管理，也避免意外操作影响系统文件。
阶段二：安装OpenClaw本体
现在，最激动人心的部分来了。安装OpenClaw本身，其实简单得超乎想象。网上有些教程把它描述得过于复杂，实际上官方提供了极其简便的一键安装脚本。
1. 以管理员身份打开Windows PowerShell。
2. 复制并执行以下官方一键安装命令：
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```
这条命令会从官方源下载安装脚本并自动执行。 期间，脚本会自动检测和安装所需的依赖（包括合适版本的Node.js和pnpm），你只需要耐心等待命令行中的代码滚动完成即可。切记不要中途关闭窗口或断开网络！
阶段三：初次启动与访问
安装脚本成功运行完毕后，OpenClaw服务通常会自动启动。第一次启动时，它可能会在浏览器中自动打开管理面板。如果没有自动打开，你也不用慌，手动操作即可。
1. OpenClaw的本地服务默认运行在http://127.0.0.1:18789这个地址。 打开你的浏览器（Chrome、Edge等），在地址栏输入这个地址并访问。
2. 首次访问时，页面可能会要求你输入一个网关令牌（Gateway Token）。这个令牌在你第一次启动服务时，通常会在终端窗口里显示出来，是一长串字符，请务必复制保存好。 如果没找到，也别担心，可以到OpenClaw的配置文件里找，配置文件一般位于用户目录下的 `.openclaw` 文件夹里（例如 `C:""Users""你的用户名"".openclaw""openclaw.json`），用记事本打开，寻找 `"token" 后面的那串字符。
3. 输入令牌后，你就成功进入了OpenClaw的Web管理面板！这里就是你和“小龙虾”交互的主控台，可以配置模型、安装技能、查看日志和执行任务。
现在，“小龙虾”的“身体”已经部署好了，但它还不会思考，也没有“手”去干活。接下来，我们要给它装上“大脑”和“技能”。
1. 配置“大脑”——选择并连接AI模型
这是最核心的一步。OpenClaw本身没有智能，它需要连接一个大型语言模型（LLM）来理解你的指令。你有两种主流选择：
这种方式简单快捷，无需消耗本地算力。你需要一个支持OpenAI API格式的模型服务商API Key。常见的如：
在OpenClaw的Web面板中，找到模型配置页面，选择对应的提供商，填入你从该平台官网获取的API Key即可。
-方案B：使用本地离线模型（追求隐私与零成本）
如果你想完全离线、免费使用，这是最佳选择。需要借助Ollama这个工具。
1. 先去Ollama官网下载并安装Ollama。
2. 打开终端，运行命令拉取一个开源模型，例如中文能力不错的 `qwen2.5:7b`：`ollama pull qwen2.5:7b`。这会下载一个约4GB的文件，需要一些时间。
3. 启动Ollama服务：`ollama serve`。
4. 在OpenClaw的模型配置中，选择“Ollama”或“Local”选项，并填入本地模型名称（如 `qwen2.5:7b`）和Ollama的API地址（通常是 `http://localhost:11434`）。
2. 安装“技能”——让小龙虾会干活
“大脑”有了，还得教它“手艺”。OpenClaw通过Skill（技能）来扩展能力。安装技能非常简单，在OpenClaw的Web面板中通常有技能商店，或者直接在终端（需在OpenClaw项目目录下）使用 `claw install` 命令。
以下是几个非常实用、建议优先安装的核心技能：
安装完成后，可以通过 `claw list` 命令查看已安装的技能。
一切就绪，现在让我们来试试“小龙虾”的本事吧！回到OpenClaw的Web面板聊天框，输入指令，看看它如何响应和执行。
你可以从一些简单的任务开始：
看到浏览器自动弹出、鼠标光标自己移动、文件被自动整理……那一刻的成就感，真的非常奇妙。它不再是那个只会“纸上谈兵”的聊天机器人，而是一个真正能替你干活的“数字员工”了。
在部署过程中，你可能会遇到一些小麻烦。别担心，大部分都有解。
1.安装失败，报错与Node.js相关：这是最常见的问题！请首先确认你的Node.js版本是否大于等于22。如果不是，请卸载旧版本，重新安装v22 LTS。
2.依赖包下载缓慢或失败：可以尝试切换npm的镜像源到国内淘宝镜像，或者检查网络连接。执行一键安装脚本时保持网络稳定。
3.模型连接失败：如果使用API Key，请检查Key是否正确、是否有余额、服务是否可用。如果使用本地Ollama，请确认 `ollama serve` 服务是否正在运行。
4.执行操作无响应：检查对应的Skill是否安装成功。此外，OpenClaw执行某些操作（如控制桌面）可能需要系统权限，请确保你以管理员身份运行了服务，并在系统安全设置中授予了必要的权限。
5.想重装或卸载：最简单的办法是删除你创建的专用项目文件夹，并移除相关的环境变量。如果使用了系统还原点，那恢复一下是最干净的。
好了，至此，一个属于你自己的、能听会干的“AI数字员工”——OpenClaw“小龙虾”，就已经成功在你的电脑上“安家落户”了。 回顾整个过程，从检查环境、选择方案，到安装核心、配置模型技能，每一步拆解开来，其实并没有想象中那么高深莫测。
这个开源框架的魅力在于，它打破了AI只能“动口”不能“动手”的界限。 随着你安装更多技能（社区里有大量开发者贡献的插件），它的能力边界还将不断扩展。你可以让它帮你自动处理邮件、监控数据、生成报告，甚至结合你的工作流，创造出独一无二的自动化方案。
技术发展的目的，终究是为了解放人，让我们能专注于更有创造性的思考。OpenClaw正是这样一把钥匙。希望这篇超过两千字的详细指南，能帮你顺利推开这扇门，体验AI自动化为生活和工作带来的切实改变。如果在实践中遇到任何文中未提及的问题，别忘了，开源社区和网络上有丰富的资料和热情的开发者，随时可以为你答疑解惑。现在，就去给你的“小龙虾”下达第一个指令吧！
版权说明：
