【保姆级教程】Windows WSL2 一键部署 OpenClaw，本地 AI Agent 神器来了

helpme流水

455人浏览 · 2026-04-01 17:10:53

helpme流水 · 2026-04-01 17:10:53 发布

【保姆级教程】Windows WSL2 一键部署 OpenClaw，本地 AI Agent 神器来了！🚀

📝 前言

还在为远程调用大模型的延迟和隐私问题头疼吗？还在用那些收费昂贵的 AI 助手吗？

今天给大家带来一个完全免费、本地运行、支持多模型的 AI Agent 框架——OpenClaw！通过在 Windows WSL2 环境下一键部署，你将拥有：

✅ 完全本地化：所有数据都在本地，隐私安全有保障
✅ 零延迟响应：不需要网络请求，响应速度飞快
✅ 多模型支持：Ollama、LM Studio 等主流推理框架全兼容
✅ 丰富插件生态：文件管理、代码生成、数据分析等技能随心扩展
✅ 跨平台消息推送：Discord、微信、Telegram 等即时通讯工具无缝集成

💡 本文特点：从零开始，步骤清晰，截图详细，照着做绝对能成功！

🎯 一、环境准备

1.1 确认 WSL2 已安装

首先确保你的 Windows 系统已经安装了 WSL2。打开 PowerShell（管理员），输入：

wsl --list --verbose

如果显示类似以下内容，说明 WSL2 已安装：

  NAME      STATE           VERSION
* Ubuntu    Running         2

⚠️ 如果没有安装：打开命令提示符（管理员）执行以下命令：
wsl --install
完成后重启电脑。

1.2 配置 WSL 系统（可选但推荐）

打开 Ubuntu 终端，检查更新并安装必要工具：

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget unzip

🛠️ 二、安装 Node.js 和 npm

OpenClaw 基于 Node.js 运行，需要 Node.js 18+ 版本。

方法一：使用 NodeSource（推荐）

# 添加 Node.js 源
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -

# 安装 Node.js
sudo apt install -y nodejs

验证安装

node --version  # 应显示 v20.x.x
npm --version   # 应显示 10.x.x

📦 三、全局安装 OpenClaw

OpenClaw 已经发布了 npm 包，可以直接通过 npm 一键安装：

# 全局安装（推荐）
npm install -g openclaw

如果遇到权限问题，使用：

sudo npm install -g openclaw

⏱️ 安装时间：根据网络情况，大约需要 2-5 分钟。请耐心等待！

🔧 四、初始化配置

4.1 查看 OpenClaw 状态

安装完成后，运行：

openclaw status

你将看到类似输出：

OpenClaw Status
───────────────
Gateway: running
Agent Model: ollama/llama3.2:3b
Default Thinking: off

4.2 配置默认模型

OpenClaw 默认使用 Ollama 作为推理引擎。如果你已经安装了 Ollama，可以直接使用：

# 进入 WSL
cd ~

# 拉取开源大模型（根据需求选择）
ollama pull qwen3.5:27b      # 推荐：中文能力优秀的 Qwen
# 或者
ollama pull llama3.2         # 英文能力强，速度快
# 或者
ollama pull mistral          # 轻量级，资源占用低

💡 提示：Qwen3.5:27b 模型较大（约 18GB），如果你的显存/内存不足，可以先从 qwen3.5:0.5b 或 llama3.2 开始尝试。

🎨 五、配置 Skills（技能插件）

OpenClaw 的核心在于它的 Skill 系统——通过模块化技能扩展功能。

5.1 查看已安装的技能

openclaw skills --list

5.2 安装热门技能

以下是几个实用技能的推荐：

📝 docx：Word 文档读写处理
📊 xlsx：Excel 表格数据分析
🗺️ travel-planner：旅行计划自动生成
📧 email-skill：邮件收发管理
🎭 agent-mbti：AI 人格测试与配置

安装示例（以 docx 为例）：

openclaw skills add docx ~/.openclaw/workspace/skills/docx --force

🌐 六、接入即时通讯工具（可选）

6.1 Discord Bot 配置

登录 Discord Developer Portal
创建新应用，获取 Bot Token
设置环境变量：

export OPENCLAW_DISCORD_TOKEN="your_bot_token_here"

6.2 Telegram Bot 配置

联系 @BotFather 创建机器人，获取 Token
设置环境变量：

export OPENCLAW_TELEGRAM_BOT_TOKEN="your_telegram_token_here"

💡 重启服务：配置完成后运行 openclaw gateway restart 使配置生效。

🧪 七、测试验证

7.1 启动 OpenClaw Agent

# 启动服务
openclaw gateway start

7.2 发送测试消息

在终端输入：

echo "你好，请帮我总结一下今天的重要事项" | openclaw chat send

或者通过 Discord/Telegram 发送消息给机器人！

🐛 八、常见问题排查

问题	解决方案
`npm install -g openclaw` 失败	检查网络连接，或使用镜像源：`npm config set registry https://registry.npmmirror.com`
Ollama 模型加载慢	使用国内镜像站拉取模型，或选择更小的模型
WSL2 内存不足	编辑 `~/.wslconfig`，增加内存限制
Gateway 启动失败	检查端口 3000 是否被占用：`sudo lsof -i:3000`