夜雨聆风
通过 WSL2 从零部署 OpenClaw:完整实战教程
在 Windows 系统上通过 WSL2 获得 Linux 原生体验，部署属于你个人的 AI Agent 助手，支持多平台消息接入和智能工具调用，实现真正的跨平台自动化工作流。
OpenClaw 简介
OpenClaw 是一个自托管的网关，连接你喜爱的聊天应用程序和渠道界面，包括内置渠道以及捆绑或外部渠道插件（如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等），与 AI 编码助手（如 Pi）相连。你在自己的机器（或服务器）上运行单个网关进程，它就成为你的消息应用程序和始终可用的 AI 助手之间的桥梁。
核心特性： – 自托管：在你的硬件上运行，遵循你的规则 – 多渠道：单个网关同时为内置渠道和捆绑或外部渠道插件服务 – Agent 原生：为具有工具使用、会话、记忆和多代理路由功能的编码代理而构建 – 开源：MIT 许可，社区驱动
支持的平台： – Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等 – 通过插件支持 Matrix、Nostr、Twitch、Zalo 等 – 支持 iOS 和 Android 节点进行 Canvas、相机和语音工作流
为什么推荐使用 WSL2 部署
在 Windows 上直接使用 Node.js 或 Docker 部署 OpenClaw 时，我们常常遇到这些坑：
- C++ 编译工具缺失
： node-gyp编译原生模块时提示找不到 make/g++ - 路径问题
：Windows 和 Linux 的路径分隔符不同，导致各种兼容性问题 - Docker 性能损耗
：虽然可以用 Docker，但文件 I/O 性能不如原生 - 环境混乱
：多个项目依赖不同版本，容易相互影响
WSL2 的优势： – 原生 Linux 环境：Node.js 生态完美支持 – 文件系统性能接近原生 Linux – 可以直接使用 Linux 命令和工具 – 和 Windows 文件系统无缝集成 – 更稳定的 Gateway 运行环境
环境准备
Windows 11 系统要求
- Windows 11
（推荐）或 Windows 10 2004 及以上版本（Build 19041+） - 内存建议
：至少 8GB RAM，推荐 16GB+（WSL2 会占用部分内存） - 磁盘空间
：至少 20GB 可用空间（Ubuntu + OpenClaw + 缓存） - 虚拟化支持
：确保 BIOS 中已开启 VT-x/AMD-V 虚拟化支持
安装 WSL2
管理员身份打开 PowerShell，执行：
# 启用 WSL 功能 wsl --install如果需要指定 Ubuntu 版本：
# 查看可用的发行版wsl --list --online # 安装指定版本的 Ubuntu wsl --install -d Ubuntu-24.04等待安装完成后，重启计算机。
启用 systemd（必需）
在 WSL 终端中启用 systemd：
# 创建 wsl.conf 文件 sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true EOF从 PowerShell 重启 WSL：
wsl --shutdown重新打开 Ubuntu，验证 systemd 状态：
systemctl --user status安装 Node.js
OpenClaw 需要 Node.js 24（推荐）或 Node 22.16+：
# 安装 Node.js 24 LTS（兼容性更好）curl-fsSL https://deb.nodesource.com/setup_24.x | sudo-Ebash-sudo apt-get install -y nodejs# 验证安装 node --version npm --version安装步骤
方法一：官方安装脚本（推荐）
# 下载并执行官方安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash方法二：从源码安装
# 克隆 OpenClaw 项目 git clone https://github.com/openclaw/openclaw.git cd openclaw # 安装依赖pnpm install # 构建项目 pnpm build # 构建UI pnpm ui:build验证安装
# 检查 OpenClaw 是否安装成功 openclaw --version # 检查系统状态 openclaw doctor启动 OpenClaw
运行引导程序
# 运行交互式引导程序 openclaw onboard --install-daemon这个向导将引导你完成： 1. 选择模型提供商（Anthropic、OpenAI、Google 等） 2. 设置 API 密钥 3. 配置网关 4. 安装系统服务
整个过程大约需要 2 分钟。
验证网关状态
# 检查网关状态 openclaw gateway status你应该看到网关在端口 18789 上运行。
打开控制面板
# 打开浏览器控制面板 openclaw dashboard这将在你的浏览器中打开 Control UI。如果加载成功，说明一切正常。
配置
基本配置文件
OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json。如果文件不存在，OpenClaw 会使用安全的默认值。
模型配置
{
“agents”: {
“defaults”: {
“model”: {
“primary”: “anthropic/claude-sonnet-4-6”,
“fallbacks”: [
“openai/gpt-5.4”
]
},
“models”: {
“anthropic/claude-sonnet-4-6”: {
“alias”: “Sonnet”
},
“openai/gpt-5.4”: {
“alias”: “GPT”
}
}
}
}
}
工具配置
OpenClaw 提供了内置工具和插件工具：
内置工具： – exec / process：运行 shell 命令 – browser：控制 Chromium 浏览器 – web_search / web_fetch：网络搜索和内容获取 – read / write / edit：文件操作 – message：跨渠道发送消息 – image / image_generate：图像分析和生成 – tts：文本转语音 – sessions_*：会话管理
工具配置示例：
{
“tools”: {
“profile”: “coding”,
“allow”: [
“group:fs”,
“browser”,
“web_search”
],
“deny”: [
“exec”
]
}
}
会话配置
{
“session”: {
“dmScope”: “per-channel-peer”,
“reset”: {
“mode”: “daily”,
“atHour”: 4,
“idleMinutes”: 120
}
}
}
渠道配置
Telegram 配置
{
“channels”: {
“telegram”: {
“enabled”: true,
“botToken”: “123:abc”,
“dmPolicy”: “pairing”,
“allowFrom”: [
“tg:123”
]
}
}
}
微信渠道配置
微信渠道需要安装官方的 Tencent iLink Bot 插件：
# 安装微信插件 openclaw plugins install "@tencent-weixin/openclaw-weixin" # 启用插件 openclaw config set plugins.entries.openclaw-weixin.enabled true # 重启网关 openclaw gateway restart # 微信渠道登录 openclaw channels login --channel openclaw-weixin用手机微信扫描二维码并确认登录。
MCP（Model Context Protocol）集成
OpenClaw 支持 MCP 工具集成，可以通过插件添加更多功能：
{
“tools”: {
“profile”: “full”,
“byProvider”: {
“google-antigravity”: {
“profile”: “minimal”
}
}
}
}
常见问题及解决方案
问题 1：端口被占用
现象：启动时提示端口被占用
解决方案：
# 查看端口占用 ss -tulpn | grep :18789 # 修改配置文件中的端口 nano ~/.openclaw/openclaw.json # 将端口改为其他值，比如 18790问题 2：内存占用过高
现象：OpenClaw 运行一段时间后内存占用很高
解决方案：
# 重启 OpenClaw sudo systemctl restart openclaw # 或者手动重启 pkill -f openclaw nohup openclaw start > /tmp/openclaw.log 2>&1 &问题 3：插件安装失败
解决方案：
# 检查插件列表 openclaw plugins list # 重新安装插件 openclaw plugins install "@tencent-weixin/openclaw-weixin" --force # 重启网关 openclaw gateway restart问题 4：配置文件验证失败
解决方案：
# 检查配置文件 openclaw doctor # 自动修复配置 openclaw doctor --fix性能优化建议
1. 系统级优化
# 启用 WSL2 的 linger 模式 sudo loginctl enable-linger "$(whoami)" # 优化文件系统性能 sudo nano /etc/wsl.conf添加以下配置：
[automount] options = "metadata" [mount] options = "metadata"2. OpenClaw 配置优化
{
“agents”: {
“defaults”: {
“model”: {
“primary”: “anthropic/claude-sonnet-4-6”,
“fallbacks”: [
“openai/gpt-5.4”
]
},
“imageMaxDimensionPx”: 800,
“heartbeat”: {
“every”: “30m”,
“target”: “last”
}
}
},
“gateway”: {
“channelHealthCheckMinutes”: 5,
“channelStaleEventThresholdMinutes”: 30,
“channelMaxRestartsPerHour”: 10,
“handshakeTimeoutMs”: 30000
},
“tools”: {
“profile”: “coding”,
“allow”: [
“group:fs”,
“group:web”,
“browser”,
“web_search”
],
“deny”: [
“exec”
]
}
}
3. 资源限制
# 限制内存使用 export NODE_OPTIONS="--max-old-space-size=4096" # 限制 CPU 使用（可选） export OPENCLAW_CPU_LIMIT=804. 日志管理
{
“logging”: {
“level”: “info”,
“maxFiles”: 7,
“maxSize”: “10m”
}
}
5. 会话优化
{
“session”: {
“dmScope”: “per-channel-peer”,
“reset”: {
“mode”: “daily”,
“atHour”: 4,
“idleMinutes”: 120
}
}
}
总结
通过 WSL2 部署 OpenClaw 为 Windows 用户提供了完整的 Linux 原生体验，解决了传统 Windows 环境下的各种兼容性问题。主要优势包括：
- 环境纯净
：避免了 Windows 下的各种依赖问题 - 性能优异
：接近原生的 Linux 文件系统性能 - 兼容性好
：完美支持 Node.js 生态和 OpenClaw 的所有功能 - 易于维护
：统一的环境配置和更新机制
下一步建议
- 连接更多渠道
：根据需要配置 Telegram、Discord、微信等渠道 - 自定义技能
：创建自己的技能文件来增强 AI 助手的能力 - 设置自动化
：配置 cron 任务实现定时任务自动化 - 探索高级功能
：尝试沙箱模式、多代理路由等高级功能
推荐关注
如果你想深入了解 OpenClaw 的更多功能，建议关注：
- 官方文档
：https://docs.openclaw.ai - GitHub 仓库
：https://github.com/openclaw/openclaw - 社区讨论
：加入 Discord 或 Telegram 社区 - 更新日志
：关注版本更新和新功能发布
AI Agent | OpenClaw | WSL2 | 微信自动化 | Windows 部署 | MCP