手把手教你本地养“龙虾”：OpenClaw零基础部署与插件配置指南

如果你最近被各种AI助手的新闻刷屏，特别是看到别人家的AI能自己写邮件、整理文件甚至帮忙订票，心里直痒痒，那么恭喜你，来对地方了。

今天我们要养的这只“龙虾”，大名 OpenClaw，是2026年最炙手可热的开源AI智能体框架。它不是一个只会聊天的机器人，而是一个真正长着“手和脚”，能帮你操作电脑的数字员工 。

本文将用最“喂饭级”的方式，带你绕过所有弯路，在你自己电脑上把它跑起来。

 第一步：检查“厨房”与“厨具”（部署前准备）

在开始之前，咱们得先看看家里的“厨具”合不合用。

 1. 硬件要求
- CPU：2核以上（推荐4核或8核）。
- 内存：至少 4GB（推荐 8GB 或 16GB，如果要跑本地大模型，16GB是体验较好的门槛）。
- 硬盘：预留至少 25GB 的可用空间（SSD固态硬盘优先，跑起来更快）。
- 系统：Windows 10/11、macOS 或 Linux（Ubuntu 22.04 最佳） 。

 2. 核心依赖安装
OpenClaw 是基于 Node.js 和 Python 开发的。我们需要先把这些“厨具”摆好。

Windows 用户操作：
1. 按下 `Win + R` 键，输入 `powershell`，然后右键点击选择“以管理员身份运行”。
2. 安装 Node.js：访问 [Node.js官网](https://nodejs.org/) ，下载左侧 LTS（长期支持版） 版本（如 22.x.x）。安装时务必勾选 “Add to PATH”（添加到系统路径）。
3. 安装 Git：访问 [Git官网](https://git-scm.com/) 下载 Windows 版本，默认配置安装即可 。
4. 验证安装：在管理员 PowerShell 中依次输入以下命令，看到版本号即表示成功。
   ```powershell
   node --version
   git --version
   ```

macOS 用户操作：
1. 打开终端（Terminal）。
2. 安装 Homebrew（若未安装）：
   ```bash
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   ```
3. 安装依赖：
   ```bash
   brew install node@22 git
   brew link node@22 --force
   ``` 

 第二步：给“龙虾”装个本地大脑（Ollama + 通义千问）

OpenClaw 本身只是个身体，它需要一个聪明的大脑（大语言模型）来驱动。为了真正实现“本地部署”且免费，我们选择 Ollama 来运行阿里出的中文强模型 Qwen2.5。

1. 下载 Ollama
   访问 [Ollama官网](https://ollama.com/)，下载对应你操作系统的版本并安装 。

2. 拉取本地模型
   打开新的终端（PowerShell 或 mac 终端），输入以下命令下载模型（大小约 4-5GB，等待时间取决于你的网速）：
   ```bash
   ollama pull qwen2.5:7b
   ```

3. 【重点避坑】扩大模型上下文窗口
   OpenClaw 在处理复杂任务时，需要模型有较大的“上下文窗口”。默认的 qwen2.5:7b 窗口较小，直接运行会报错 “Model context window too small”。
   我们需要创建一个“定制版”的大窗口模型 。
   
   在终端逐条执行以下命令：
   ```bash
    进入你的用户目录（以Windows为例，mac类似）
   cd C:\Users\<你的用户名>
   
    创建一个名为 Modelfile 的配置文件
   echo FROM qwen2.5:7b > Modelfile
   echo PARAMETER num_ctx 32768 >> Modelfile
   
    基于这个文件创建一个新模型，名字叫 qwen2.5:7b-32k
   ollama create qwen2.5:7b-32k -f Modelfile
   ```
   *注意：请将 `<你的用户名>` 替换为你的实际电脑用户名。*

 第三步：主角登场——安装 OpenClaw

环境准备好后，终于可以请出我们的主角了。

 1. 执行一键安装脚本
回到刚才那个管理员权限的 PowerShell（或 mac 终端），输入以下命令：

Windows (PowerShell):
```powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
```

macOS/Linux:
```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

如果一切顺利，你会看到一堆代码滚动 。

 2. 可能遇到的权限报错及解决
如果你在 Windows 上遇到“无法加载...因为在此系统上禁止运行脚本”的报错，这是因为执行策略受限。输入以下命令放行：
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
然后重新运行上面的安装命令 。

 第四步：连接“身体”与“大脑”（核心配置）

安装完成后，我们需要告诉 OpenClaw：“嘿，你的本地大脑（Ollama）准备好了，去连上它。”

 1. 运行配置向导
在终端中输入：
```bash
openclaw onboard
```
这时会出现一个蓝底白字的配置菜单。不用慌，按以下方式填写 ：
- I understand this is powerful and inherently risky. Continue? 选 `Yes`（提醒你注意安全风险）。
- Model/auth provider (模型提供商): 因为咱们用的是 Ollama，这里需要选 `Custom Provider`（自定义提供商），通常用方向键往下拉到最后就能找到。
- API Base URL (接口地址): 填 `http://127.0.0.1:11434/v1`（这是 Ollama 的默认地址）。
- API Key: 随便填，比如 `ollama`（本地不需要验证，但不能为空）。
- Model ID (模型名称): 这里要填我们刚才定制的那个大窗口模型：`qwen2.5:7b-32k`。
- 后面的通讯渠道、技能等选项，新手可以先选 “Skip for now” 跳过。

配置成功后，最后会出现一行绿色的“Verification successful”，并提供一个访问地址（通常是 `http://127.0.0.1:18789/`）和一串长长的 Token（令牌）。

 2. 另一种配置方式（直接改文件）
如果你不想用菜单，也可以直接修改配置文件。用记事本打开用户目录下的 `.openclaw/config.yaml`（mac/linux 是隐藏文件），将内容修改为 ：
```yaml
llm:
  provider: "openai"  维持通用解析协议
  base_url: "http://127.0.0.1:11434/v1"  指向本地 Ollama
  api_key: "local_placeholder"
  model: "qwen2.5:7b-32k"  确保与 ollama 中的名字一致
```

 第五步：见证奇迹——启动与体验

1. 启动 OpenClaw 服务
   在终端输入：
   ```bash
   openclaw gateway start
   ```

2. 打开控制台
   打开你的 Chrome 或 Edge 浏览器，地址栏输入 `http://127.0.0.1:18789/`。
   页面会要求你输入 Token，把刚才 PowerShell 里显示的那一长串字符复制粘贴进去。

3. 下达第一个指令
   叮！一个简洁的聊天界面出现了。现在，你可以试着输入：
   > “请在桌面上创建一个叫‘龙虾测试’的文件夹，并在里面新建一个文本文件，写上‘Hello World’。”

   然后看着你的电脑，它真的会去执行！

 第六步：让“龙虾”学会更多技能（插件安装）

OpenClaw 的真正魅力在于 Skills（技能/插件） 生态。以下是根据2026年最新指南整理的必装插件清单及安装命令 。

你可以通过 ClawHub 来安装它们。在 OpenClaw 的聊天界面或者终端，使用 `clawhub install` 命令。

 安全与基础类（建议首先安装）
- skill-vetter：插件安全审查工具。安装任何陌生插件前，它会自动检测风险。
  ```bash
  clawhub install skill-vetter
  ```
- memory-setup：持久记忆配置工具。让 AI 记住你的偏好，越用越懂你。
  ```bash
  clawhub install memory-setup
  ```

 文档处理类（高频使用）
- summarize：万能总结工具。支持网页、PDF、视频一键生成摘要。
  ```bash
  clawhub install summarize
  ```
- markdown-converter：格式转换神器。Word/PDF/图片一键转 Markdown。
  ```bash
  clawhub install markdown-converter
  ```
- nano-pdf：自然语言编辑 PDF。比如“把第三页的标题改成龙虾大会”。
  ```bash
  clawhub install nano-pdf
  ```

 效率与创作类
- nano-banana-pro：AI 图像生成。在对话框里直接画图。
  ```bash
  clawhub install nano-banana-pro
  ```
- web-content-fetcher：抓取网页内容。对付公众号文章很好用。
  ```bash
  clawhub install web-content-fetcher
  ```

如果你想偷懒，可以直接在对话框输入自然语言指令让 AI 帮你批量安装 ：
> “帮我安装这些 Skill：skill-vetter、memory-setup、summarize、markdown-converter”

 常见问题与避坑指南

在“养虾”过程中，你可能会遇到以下问题，这里提前给你打好“预防针”：

1. 安装时报错 “无法连接到 https://openclaw.ai”
- 原因：网络问题或 DNS 污染。
- 解决：尝试更换网络，或者使用国内镜像源（如阿里云镜像），或者在命令行临时切换 DNS。

2. 配置完后，机器人不回应或报错 “Model not found”
- 原因：模型名字写错了，或者 Ollama 服务没启动。
- 解决：
    1.  在终端输入 `ollama list`，查看你下载的模型精确名称（是 qwen2.5:7b-32k 还是 qwen2.5:latest）。
    2.  确保 Ollama 正在运行。可以在终端输入 `ollama ps` 查看 。

3. 执行任务时报错 “Model context window too small”
- 原因：你跳过了第二步的定制模型步骤，用的默认模型窗口太小。
- 解决：严格按照第二步的操作，创建一个新的带大窗口参数的模型，并在配置中选择它 。

4. 关于安全风险的提醒
OpenClaw 权限极大，因为它能真正操作你的电脑。
- 不要在存有绝密文件的主力机上随意测试来路不明的插件。
- 尽量遵循最小权限原则，在配置中限制它可以访问的文件夹。
- 工信部此前也通报过，OpenClaw 不当配置存在安全风险，请务必从官方渠道安装插件，并及时关注官方安全公告 。

5. 替代方案：如果觉得手动安装太麻烦
如果你觉得上面的命令行操作还是太繁琐，可以试试智谱 AI 最新推出的 AutoClaw（中文名“澳龙”）。
- 这是一个真正一键安装的本地版 OpenClaw。
- 内置了 50+ 热门 Skills 和专属优化模型，开箱即用。
- 下载地址：[https://autoglm.zhipuai.cn/autoclaw](https://autoglm.zhipuai.cn/autoclaw) 。

---

好了，至此你已经成功在本地部署了一只属于你自己的“龙虾”AI。从今天起，你不再只是 AI 的旁观者，而是驾驭者。去试试让它帮你处理下周的工作周报，或者整理杂乱无章的桌面吧！