【保姆级教程】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 配置

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

export OPENCLAW_DISCORD_TOKEN="your_bot_token_here"

6.2 Telegram Bot 配置

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

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

---

🎉 九、总结

恭喜你！现在你已经成功在 Windows WSL2 上部署了 OpenClaw，拥有了一个完全本地化、可扩展、零延迟的 AI Agent 助手！

下一步可以探索：

• 🔍 深入研究更多 Skills，扩展功能
• 📊 搭建数据分析自动化脚本
• 🎨 尝试自定义 Agent 人格（SOUL.md）
• 🤖 接入企业微信/钉钉等国内 IM

---

📚 参考资料

• OpenClaw 官方 GitHub：https://github.com/openclaw/openclaw
• OpenClaw 文档：https://docs.openclaw.ai
• Ollama 模型仓库：https://ollama.ai/library

---

💬 结语

如果觉得本文对你有帮助，欢迎点赞、收藏、关注！更多 AI 工具部署教程持续更新中～

有任何问题欢迎在评论区留言，我会第一时间回复！👇

---

作者：[wx:sunhy_000]
原创声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

---

🔔 关注笔者：获取更多前沿 AI 工具部署实战教程！