OpenClaw（前身为MoltBot、Clawbot）作为一款功能全面的开源智能体AI助手，打破了传统AI“只对话不行动”的局限——它既具备自然语言交互能力，又能像“数字员工”一样动手执行任务：可读写本地文件、运行代码、操控命令行，还能联网搜索分析网页内容，同时支持对接Qwen、OpenAI等云端大模型，或利用本地GPU运行模型，兼顾数据隐私与功能灵活性。
本文专为零基础用户打造，聚焦Windows系统本地部署全流程，从环境准备、主程序安装到问题排查，每一步均提供详细操作指引与截图级说明，同时补充关键注意事项与避坑技巧，确保无技术基础的用户也能顺利搭建专属本地AI助手。
一、部署前核心认知与准备
在启动部署前，需明确OpenClaw的运行依赖与必备工具，避免因环境不达标或工具缺失导致流程中断，为后续操作奠定基础。
（一）核心功能与适用场景
OpenClaw的核心价值在于“本地化运行+实操能力”，具体可实现三类关键功能：
- 文件与命令操作：读取/修改本地文档（如分析F盘的项目报告）、执行代码（用Python生成数据图表）、调用系统命令（查看磁盘占用、批量重命名文件）；
- 自动化任务：监控文件夹（新增文件自动备份至云端）、定时执行任务（每天早7点生成前日邮件摘要）、跨平台同步（钉钉日程与本地日历联动）；
- 多渠道交互：支持Telegram、WhatsApp、钉钉等常用聊天工具，无需打开专用界面，在熟悉的渠道中即可发送指令（如@钉钉机器人“整理今日待办”）。
适用人群覆盖广泛：开发者可用于自动化测试与代码生成，职场人可解放邮件筛选、文档整理等重复工作，学生群体则能借助其实现知识点总结（如提取B站视频核心内容）。
（二）环境与工具要求
- 系统与硬件：仅支持Windows（需Windows 10及以上，推荐Windows 11），硬件需满足内存≥4GiB（运行更流畅）、磁盘预留≥10GiB（存储依赖与运行日志），无GPU强制要求（本地运行大模型需额外配置）；
- 核心依赖：Node.js（版本≥22，OpenClaw运行的基础环境）、npm（Node.js自带，用于安装扩展技能）；
- 必备工具：
- 终端工具：Windows自带PowerShell（无需额外安装）；
- 文本编辑器：系统记事本或Notepad++（用于修改配置文件）；
- 浏览器：Chrome、Edge等主流浏览器（访问OpenClaw Web管理界面）；
- 可选准备：目标大模型API Key（如阿里云百炼、Qwen账号，用于启用智能交互能力）、常用聊天工具账号（如Telegram、钉钉，后续对接交互渠道）。
二、第一阶段：搭建Node.js运行环境
OpenClaw完全依赖Node.js运行，且对版本有严格要求（≥22），需优先完成Node.js的安装或升级，这是部署成功的关键前提。
（一）全新安装Node.js（未安装过的用户）
1. 下载适配安装包
- 打开Node.js官方网站（https://nodejs.org/），网站会自动识别Windows系统，无需手动选择；
- 点击“Windows Installer (64-bit)”下载.msi格式安装包（64位是当前Windows主流架构，无需选择32位）；
- 建议将安装包保存到桌面或“下载”文件夹，避免后续找不到文件（如保存路径“C:\Users\你的用户名\Downloads”）。
2. 分步完成安装（新手全程默认下一步）
- 双击安装包启动向导，点击“Next”；
- 勾选“我接受许可协议（I accept the terms in the License Agreement）”，继续“Next”；
- 关键步骤1：确认安装路径：默认路径为“C:\Program Files\nodejs\”，新手切勿修改——自定义路径可能导致后续环境变量配置失败，直接点击“Next”；
- 关键步骤2：配置环境变量：进入“Custom Setup”页面，确保“Add Node.js to PATH”选项已勾选（该选项会自动将Node.js添加到系统环境变量，无需手动配置），其他选项保持默认，点击“Next”；
- 后续页面无需修改高级选项（如“Tools for Native Modules”保持默认），连续点击“Next”，最后点击“Install”开始安装；
- 等待10-30秒（安装速度取决于电脑配置），出现“Completed”提示后，点击“Finish”关闭向导。
3. 验证安装效果（必须重启终端）
- 重启终端：关闭所有已打开的PowerShell/CMD窗口（不重启会导致系统无法识别新安装的Node.js）；
- 按下“Win+R”，输入“PowerShell”，打开普通权限的PowerShell窗口；
- 输入命令
node -v，若输出“v22.x.x”或“v24.x.x”（如v22.10.0、v24.4.0），说明安装成功且版本符合要求； - 可选验证：输入
npm -v，若能正常输出版本号（如10.8.1），代表npm与环境变量配置无误。
（二）升级旧版Node.js（已安装但版本过低）
若此前安装过Node.js，执行node -v显示版本低于22（如v18.19.0），需手动卸载旧版并安装新版，避免版本冲突：
- 卸载旧版：
- 按下“Win+R”，输入“control”打开控制面板，进入“程序和功能”；
- 在程序列表中找到“Node.js”，右键选择“卸载”，按提示完成操作；
- 手动删除残留文件：打开“C:\Program Files\nodejs”文件夹，删除所有内容（若提示“文件正在使用”，重启电脑后再删除）；
- 清理环境变量（可选但推荐）：
- 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”；
- 在“系统变量”的“Path”中，删除包含“nodejs”的旧路径（如“C:\Program Files\nodejs\”）；
- 安装新版：按“全新安装”步骤下载v22或v24稳定版，完成安装后重启终端验证版本。
（三）解锁PowerShell脚本执行权限
Windows默认禁止运行脚本，会导致后续OpenClaw安装指令失效，需手动开启权限：
- 以管理员身份运行PowerShell：按下“Win”键，搜索“PowerShell”，右键选择“以管理员身份运行”；
- 输入命令：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser； - 出现“是否要更改执行策略”提示时，输入“Y”并回车，权限即刻生效（该设置仅对当前用户生效，不影响系统安全）。
三、第二阶段：安装OpenClaw主程序与初始化
环境准备完成后，通过一键安装脚本部署主程序，并通过初始化向导完成基础配置，让AI助手初步运行。
（一）执行一键安装命令
- 打开普通权限的PowerShell（无需管理员权限）；
- 输入以下命令，该命令会自动从官方服务器下载OpenClaw主程序并配置环境变量：
iwr -useb https://clawd.bot/install.ps1 | iex - 安装过程说明：
- 若长时间无进展（超过5分钟），可按回车键刷新终端，避免因PowerShell休眠导致误判；
- 出现“Clawdbot installed successfully”提示时，代表主程序安装完成（部分用户可能显示“Moltbot installed”，因更名历史导致，功能无差异）。
（二）运行初始化向导（Onboarding）
安装完成后，需通过向导配置基础参数（如模型选择、技能启用），新手按推荐选项操作即可，无需手动修改复杂设置：
- 在PowerShell中输入命令
moltbot onboard，启动配置向导； - 按以下步骤选择选项（括号内为推荐选择）：
- Mode（运行模式）：按上下键选择“QuickStart”（快速启动，跳过复杂配置），回车确认；
- Provider（模型提供商）：推荐选择“Qwen”（通义千问，无需额外API Key，适合新手），此时会自动弹出浏览器，登录或注册Qwen账号完成授权（授权后获取临时“大脑”，支持基础对话）；
- Default model（默认模型）：保持当前选项“qwen-portal/coder-model”，直接回车（无需手动输入）；
- Channels（交互渠道）：选择“Skip for now”（暂不配置远程渠道，先实现本地运行，后续可补充）；
- Skills（基础技能）：选择“Yes”（启用文件操作、命令执行等核心技能，推荐新手启用）；
- Skill install（技能安装工具）：选择“npm”（系统已预装，无需额外安装pnpm/bun）；
- Skill Dependencies（技能扩展依赖）：选择“Skip for now”（暂不安装扩展依赖，避免配置复杂，后续可按需添加）；
- 其他配置（如GOOGLE_PLACES_API_KEY、Hooks）：均选择“No”或“Skip for now”，留待后续按需配置；
- 完成标志：向导执行结束后，终端显示“Gateway service installed”，表示网关服务已部署，主程序安装与初始化全部完成。
（三）验证服务启动状态
- 输入命令
moltbot gateway status，若输出“Gateway is running”，说明服务正常启动； - 若显示“Gateway is stopped”，输入
moltbot gateway start手动启动服务，等待10秒后再次验证。
四、第三阶段：解决部署常见故障（关键步骤）
部署后可能遇到“命令失效”“网关未授权”等问题，需针对性排查，确保OpenClaw正常使用。
（一）“moltbot”命令失效（提示“无法识别”）
1. 现象
输入moltbot open时，终端提示“无法将‘moltbot’项识别为cmdlet、函数、脚本文件或可运行程序的名称”。
2. 原因
安装后环境变量未及时刷新，系统无法找到moltbot命令路径。
3. 解决方案
- 方案1：重启PowerShell：关闭当前窗口，重新打开后输入
moltbot open，多数情况下可解决； - 方案2：使用npx临时执行：若重启后仍失效，输入
npx moltbot open，该命令会直接调用本地安装的程序，无需依赖环境变量； - 方案3：手动配置环境变量（适用于极端情况）：
- 找到OpenClaw安装路径（默认“C:\Users\你的用户名\AppData\Roaming\npm”）；
- 按“升级旧版Node.js”中的步骤，将该路径添加到系统变量“Path”中；
- 重启终端后验证命令。
（二）网关未授权（令牌缺失）
1. 现象
打开浏览器访问“http://localhost:18789”（OpenClaw Web管理界面），页面显示“未授权：网关令牌缺失”，无法进入对话界面。
2. 原因
OpenClaw通过令牌（Token）验证访问权限，首次访问需手动输入配置文件中的令牌。
3. 解决方案
- 找到配置文件：
- 打开文件夹“C:\Users\你的用户名.clawdbot”（“你的用户名”替换为当前Windows登录账号名称，如“ZhangSan”）；
- 找到“clawdbot.json”文件（JSON格式，大小约3-5KB），右键选择“记事本”打开；
- 提取令牌：
- 在文件中按“Ctrl+F”搜索“token”，找到类似
"token": "c25bbh909c7xxxxxxxxxx"的行； - 复制引号内的长字符串（如“c25bbh909c7xxxxxxxxxx”），注意不要复制引号或逗号；
- 在文件中按“Ctrl+F”搜索“token”，找到类似
- 完成授权：
- 回到浏览器的“未授权”页面，点击右上角红色“未授权”提示框，粘贴复制的令牌；
- 点击“确认”，页面状态变为绿色“已授权”，自动跳转至对话界面，AI助手正式上线。
（三）Web界面无法访问（localhost:18789打不开）
1. 现象
输入“http://localhost:18789”后，浏览器提示“无法访问此网站”或“连接超时”。
2. 排查步骤
- 检查网关服务状态：在PowerShell中输入
moltbot gateway status，若显示“stopped”，执行moltbot gateway start启动服务； - 验证端口是否被占用：
- 以管理员身份运行PowerShell，输入
netstat -ano | findstr :18789； - 若输出结果包含“LISTENING”，说明端口被其他程序占用，需修改OpenClaw端口：
- 打开“C:\Users\你的用户名.clawdbot\clawdbot.json”；
- 搜索“gateway”，找到
"port": 18789，将18789改为未占用端口（如18790）； - 重启网关服务：
moltbot gateway restart，用新端口（如http://localhost:18790）访问；
- 以管理员身份运行PowerShell，输入
- 关闭防火墙干扰（临时测试）：
- 按下“Win+R”，输入“control firewall.cpl”打开防火墙；
- 点击“关闭Windows Defender防火墙”，测试是否能访问（访问成功后重新开启防火墙，无需长期关闭）。
四、第四阶段：基础功能验证与拓展配置
授权成功后，需通过简单指令测试核心功能，确保服务正常，同时可按需配置扩展能力，提升AI助手实用性。
（一）核心功能验证（必做）
登录OpenClaw Web界面（http://localhost:18789），在对话输入框发送以下指令，验证功能是否正常：
- 基础对话：输入“介绍一下你自己”，若返回包含“本地AI助手”“文件操作”等关键词的响应，说明模型调用正常；
- 文件读取：输入“读取C:\Users\你的用户名\Desktop\test.txt文件内容”（需提前在桌面创建test.txt并写入内容），若能正确返回文件内容，代表文件操作权限正常；
- 命令执行：输入“查看当前磁盘C的占用情况”，若返回类似“已用空间：40GB，剩余空间：100GB”的结果，说明系统命令调用正常。
若某功能无响应，参考第三阶段“问题排查”修复，确保基础功能可用后再进行拓展。
（二）拓展配置（可选，新手可后续探索）
1. 对接云端大模型（如阿里云百炼）
若需更强的推理能力（如复杂文档总结、代码生成），可对接阿里云百炼等平台的模型：
- 登录阿里云百炼控制台（https://bailian.console.aliyun.com），创建API-Key；
- 打开OpenClaw Web界面，左侧点击“Config > Models”；
- 选择“Add Provider”，填写百炼API-Key与baseUrl（https://dashscope.aliyuncs.com/compatible-mode/v1）；
- 保存后在对话时输入“使用百炼模型回答”，即可切换模型。
2. 绑定钉钉/Telegram交互渠道
以钉钉为例，实现“在钉钉@机器人发送指令”：
- 登录钉钉开放平台，创建企业内部机器人，获取Bot Token；
- 打开OpenClaw Web界面，左侧点击“Channels > 钉钉”；
- 粘贴Bot Token，设置“交互模式”为“群聊@响应”，保存后重启网关；
- 在钉钉群添加该机器人，@机器人发送“帮我整理今日待办”，测试响应。
3. 启用本地大模型（无网络也能用）
若需离线使用，可通过Ollama桥接本地模型（如Llama 3）：
- 下载Ollama（https://ollama.com/），安装后执行`ollama pull llama3:8b`拉取模型；
- 打开OpenClaw配置文件，添加Ollama模型地址（http://localhost:11434）；
- 在Web界面选择“本地模型”，即可离线发送指令（如“生成一篇关于AI的短文”）。
五、关键注意事项与优化建议
- 安全防护：
- 令牌（Token）是访问OpenClaw的关键凭证，切勿分享给他人，定期在“Config > Security”中刷新令牌；
- 限制文件操作权限：在“Config > Permissions”中，仅开放必要文件夹（如桌面、文档），禁止“全盘访问”；
- 性能优化：
- 关闭不必要的技能：在“Skills”页面，取消勾选无需使用的技能（如“语音识别”），减少内存占用；
- 清理日志：定期删除“C:\Users\你的用户名.clawdbot\logs”中的旧日志文件，释放磁盘空间；
- 版本更新：
- 执行
npm update -g moltbot可升级OpenClaw至最新版本，修复已知漏洞； - 更新前备份配置文件（clawdbot.json），避免配置丢失。
- 执行
六、阿里云一键部署Openclaw（原Clawdbot）教程
阿里云上线了轻量应用服务器 OpenClaw（原Clawdbot）一键部署功能，开箱即用更方便快捷！
第一步：前往阿里云OpenClaw专题页面：https://www.aliyun.com/activity/ecs/clawdbot，找到并点击【一键购买并部署】
第二步：购买阿里云轻量应用服务器，配置参考如下：
- 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
- 实例：内存必须2GiB及以上。
- 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
- 时长：根据自己的需求及预算选择。
第三步：前往阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。
前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。
- 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
- 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
- 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
- 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。
七、总结
通过以上步骤，Windows系统用户可零门槛完成OpenClaw本地部署，拥有一款“能动手、会跑腿”的专属AI助手。核心流程可概括为：搭建Node.js环境→安装主程序→初始化配置→解决常见故障→验证功能。
部署过程中，最易踩坑的点是“Node.js版本不足”“脚本权限未解锁”“令牌缺失”，按本文步骤逐一排查即可解决。新手无需追求一步到位配置所有功能，可先使用基础能力，后续逐步探索模型切换、多渠道对接等拓展功能，让AI助手随需求逐步进化。
若遇到未覆盖的问题，可访问OpenClaw官方文档或阿里云开发者社区，获取更多技术支持。
