基于window+wsl+Ubuntu的openclaw私有化部署

基于window+wsl+Ubuntu的openclaw私有化部署

#openclaw简介

--OpenClaw是一款开源、自托管、可执行操作的AI智能体平台，核心优势在于不仅能完成对话交互，还可直接操作本地文件、执行终端命令、控制浏览器、接入多平台消息渠道，实现真正的 "AI 干活"

--本地部署OpenClaw具备三大核心价值

--数据完全本地化（避免敏感信息上传第三方）

--自定义能力强（可修改源码、开发插件、接入私有模型）

--成本可控（仅消耗本地算力，无云端 API 持续付费）

#openclaw架构

--Gateway：管理会话、路由请求、做鉴权。它通常在本地运行，并支持通过 Tailscale 等私有网络扩展远程访问

--Skills+Tools（工具箱）：一组插件/技能（以 Markdown 与脚本描述），让 Agent 可以做事

--tool：是基础操作能力，比如打开文件、读取文件内容

--skills：是一组tools调用所形成的能力模板，比如审核报文内容，会调用打开文件、读取文件等tool

--Channels（通道）：连接各种app，如WhatsApp、Telegram、Discord、Slack、SMS 等，让 AI 与用户的日常通信无缝对接。

--Memory ：实现持久化记忆和自我进化

--Agent（大脑）：有专门的人设，负责理解上下文意图、制定分步计划、决定要调用哪些工具或技能。

--Nodes（传感器/终端）：运行在用户端设备（手机、笔记本）的小智能体，可以提供摄像头、地理位置等本地能力。

--多Agent模式：可以互不干扰，也可以相互协作。每个Agent有自己的工作区，放置专属配置与记忆，甚至自己的技能。

--Heartbeat 心跳机制，实现定时任务的自动行为------openClaw 可在无用户提示时主动联系用户。

#前置准备

--基于WSL2（Ubuntu 子系统）部署

--Windows 原生环境部署 OpenClaw 易出现权限、路径、兼容性问题

--强烈推荐使用 WSL2（Ubuntu 子系统）部署

--BIOS启用虚拟化支持（VT-x/AMD-V）

--进入BIOS开启cpu的虚拟化支持，正常默认开启

--任务管理器》性能》CPU》虚拟化需为【已启用】

--安装 WSL2 和 Ubuntu

--安装 WSL2》管理员powershell》wsl --install -d Ubuntu

--重启电脑》开始菜单》Ubuntu》设置Linux 用户名密码

--更新系统包》Ubuntu》sudo apt update && sudo apt upgrade -y

--重新打开 Ubuntu 终端，验证 systemd 是否生效

--命令systemctl --user status

--如果看到状态信息（而不是报错），说明配置成功

--依赖Node.js 22.0+（LTS 版）安装

--安装Node.js命令》管理员powershell》winget install --id=OpenJS.NodeJS.LTS --exact --silent --source winget

--验证node命令》关闭并重新打开powershell》node -v

--依赖pnpm（推荐，替代 npm）安装

--管理员powershell》npm install -g pnpm

--验证npm》管理员powershell》pnpm -v

--依赖git安装

--安装git命令》winget install --id Git.Git -e --source winget

--验证git》重启管理员powershell》git -v

--依赖docker（可选，容器化部署必装）

--实现环境隔离，避免与本地其他服务冲突，适合生产环境与多项目并行部署

--如需docker后续补充

--解锁PowerShell执行策略（原生部署时）

--管理员powershell》Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass，避免脚本执行报错

--选择【Y】

--一键脚本部署（新手推荐，零配置）

--官方提供跨系统一键安装脚本，自动检测并安装 Node.js、pnpm 等依赖，无需手动配置环境

--管理员powershell》pnpm install -g openclaw@latest

--等待 2-5 分钟，出现 OpenClaw installed successfully 即为安装完成

--验证openclaw命令》openclaw -v

#初始化配置

--一键初始化（含安装网关服务）》openclaw onboard --install-daemon

--向导步骤（实测）

--接受风险提示：按左方向键选择 yes，回车确认

--选择部署模式：输入 quickstart（快速启动，推荐）

--选择 AI 模型服务商，我选择的是Qwen (Alibaba Cloud Model Studio)，因为我有阿里云的大模型资源，有哪个选哪个

--前往阿里云》阿里云百炼》API Key，创建或者获取API Key（根据实际情况自行获取，这里为参考）

--选择 Standard API Key for China (pay-as-you-go)

--输入模型 API Key

--选择模型版本：如 Kimi 选择 kimi-v2.5，回车确认

--Select channel (QuickStart)，选择Skip for now，后面再配置

--Web search，选择Skip for now，后面再配置

--其它根据情况选择，不清楚的选择Skip for now或NO，后面再配置

--最后How do you want to hatch your bot?

--选择Hatch in TUI (recommended)

--配置工作区：默认路径 ~/.openclaw，直接回车。

--安装网关服务：选择 yes，自动创建开机自启任务。

--启动 OpenClaw 网关

--管理powershell》openclaw gateway start》如果已启动则openclaw gateway restart

--提示 gateway started successfully 即启动成功，默认监听端口18789

--问 Web 控制台与功能验证

--打开浏览器，访问本地地址：http://127.0.0.1:18789（Docker 部署同地址）

--首次访问进入初始化页面：设置管理员账号密码（6 位以上，含数字 + 字母），选择「本地部署模式」，跳过云端配置，点击「完成初始化」。

--进入中文 Web 控制台，核心功能包括

--指令执行：输入自然语言命令（如 "整理桌面文件""统计代码行数"），AI 自动执行本地操作

--插件管理：安装文件处理、浏览器自动化、定时任务等插件

--渠道配置：接入飞书、钉钉、Telegram 等消息平台，实现远程控制。

--服务健康验证：终端执行 curl http://127.0.0.1:18789/api/v1/health，输出 {"status":"healthy"} 即为服务正常。