文章目录OpenClaw 实战入门在 VMware 虚拟机里部署第一个本地 AI Agent一、前言二、为什么使用虚拟机2.1 OpenClaw 不是普通聊天工具2.2 Workspace 不是天然沙箱2.3 为什么不直接用宿主机三、本文实验环境3.1 环境规划3.2 为什么选择 Windows 10 虚拟机四、安装 VMware 并创建虚拟机4.1 安装 VMware Workstation Pro4.2 创建 Windows 10 虚拟机4.3 安装 Windows 104.4 安装 VMware Tools4.5 创建快照五、安装基础环境5.1 安装 Node.js5.2 安装 Git5.3 安装 Python六、安装 OpenClaw6.1 使用官方 Windows 安装命令6.2 验证 OpenClaw 是否安装成功七、运行 onboard 配置向导7.1 onboard 是什么7.2 配置模型提供商7.3 配置文件在哪里八、启动 Gateway8.1 Gateway 是什么8.2 Gateway 认证问题九、打开 Dashboard9.1 启动 Dashboard9.2 发送第一条消息十、使用 TUI 测试十一、常见问题11.1 openclaw 不是内部或外部命令11.2 Dashboard 打不开11.3 Dashboard 提示 unauthorized11.4 对话时提示 API Key 错误11.5 虚拟机太卡十二、本篇总结OpenClaw 实战入门在 VMware 虚拟机里部署第一个本地 AI Agent一、前言这一篇讲什么在隔离的 Windows 虚拟机中安装并启动 OpenClaw核心内容为什么本系列统一使用 VMware 虚拟机环境如何准备 Windows 虚拟机实验环境如何安装 Node.js、Git、Python如何安装 OpenClaw如何完成 onboard 配置如何启动 Gateway、Dashboard并完成第一次对话本文定位本文不是 OpenClaw 所有部署方式的汇总而是本系列的第一篇实战文章。后续内容会继续围绕同一个实验环境展开包括 Tool 使用、Skill 开发、自动化任务和消息通道接入。OpenClaw 是一个本地优先的 AI Agent 执行环境。它和普通聊天 AI 的区别在于普通聊天 AI 主要返回文本而 OpenClaw 可以把模型、工具、工作区、Skill 和通信通道连接起来让 AI 在一定权限范围内执行实际任务。官方文档中对 OpenClaw 入门流程的描述很直接安装 OpenClaw、运行 onboarding、配置模型认证、启动 Gateway然后通过聊天界面发送第一条消息。官方安装文档也说明OpenClaw 推荐 Node 24同时支持 Node 22.19并支持 macOS、Linux、Windows 和 WSL2在 Windows 场景下官方说明 WSL2 更稳定。本文不走 WSL2而是使用 Windows 虚拟机这是为了把实验环境和宿主机隔离开。:本文采用的路线是Windows 宿主机 ↓ VMware Workstation Pro ↓ Windows 10 虚拟机 ↓ Node.js / Git / Python ↓ OpenClaw ↓ Gateway / Dashboard / TUI这样做的好处是环境固定、出问题可以回滚也不会直接影响宿主机里的文件和账号。二、为什么使用虚拟机2.1 OpenClaw 不是普通聊天工具OpenClaw 不是一个只负责回答问题的网页聊天框。它有自己的 Gateway、Agent Runtime、Workspace、Tools 和 Skills。官方文档中Agent Runtime 的描述是一个 Gateway 对应一个嵌入式 agent process并拥有自己的 workspace、bootstrap files 和 session store。也就是说OpenClaw 不是单次问答而是一个可以持续运行、携带工作区上下文、调用工具的 Agent 运行环境。(OpenClaw)可以先用一个简单流程理解用户输入任务 ↓ Gateway 接收请求 ↓ Agent 判断要做什么 ↓ 调用 Tool 或 Skill ↓ 读取执行结果 ↓ 继续执行或返回答案这里最需要注意的是Tool 和 Skill 可能会触碰真实环境。比如后续会接触到的能力包括读取文件修改文件执行命令抓取网页启动浏览器调用外部 API定时执行任务。这也是为什么本文不建议直接安装在主力机上。2.2 Workspace 不是天然沙箱OpenClaw 有 workspace 概念。官方文档说明workspace 是 agent 的工作目录也是文件工具和工作区上下文使用的目录。默认位置一般是~/.openclaw/workspace但官方文档同时提醒workspace 是默认工作目录不等于严格沙箱。如果没有开启 sandbox绝对路径仍然可能访问宿主机上的其他位置。(OpenClaw)这句话很关键。也就是说不能简单理解为只要 OpenClaw 有 workspace就一定不会碰到别的目录。更准确的理解是workspace 是默认工作目录 sandbox 才是隔离机制 如果 sandbox 没开工具可能仍然运行在宿主环境中。官方 sandboxing 文档也说明OpenClaw 可以把工具执行放到 sandbox backend 中以降低影响范围但这是可选配置如果 sandboxing 关闭工具会运行在 host 上。(OpenClaw)所以本系列第一步先做外层隔离先用虚拟机隔离整个实验环境 后续再讨论 OpenClaw 自己的 sandbox 配置。2.3 为什么不直接用宿主机直接安装在宿主机上不是不能用而是不适合作为第一套实验环境。主要原因有三个。第一文件风险。如果 Agent 被授权执行文件操作它可能读写本地文件。初学阶段还不熟悉 Tool 权限、工作区范围和配置项直接放在主力机上风险太大。第二命令风险。OpenClaw 的工具体系里包含运行命令、管理进程、读写文件、网页访问、浏览器控制等类别。官方工具文档中列出的代表性工具包括exec、process、read、write、edit、apply_patch、web_search、web_fetch、browser、cron等。(OpenClaw)其中exec这类命令执行工具最需要谨慎。只要允许执行命令就不能简单认为它是“只读”的。第三第三方 Skill 风险。OpenClaw 官方 Skill 文档明确提醒第三方 Skills 应该当作不受信任的代码处理启用前需要阅读内容对于不受信任输入和高风险工具优先使用 sandbox。(OpenClaw)因此本文采用 VMware 虚拟机作为基础实验环境。三、本文实验环境3.1 环境规划本文环境统一为项目配置宿主机系统Windows 10 / Windows 11虚拟机软件VMware Workstation Pro虚拟机系统Windows 10 64 位虚拟机内存建议 4GB 起步8GB 更稳虚拟机磁盘建议 60GB 起步网络模式NAT 即可OpenClaw 安装方式Windows PowerShell 官方安装脚本模型提供商根据自己已有 API Key 选择本文目标打开 Dashboard并完成第一次对话VMware Workstation Pro 当前可以免费使用。Broadcom 官方知识库说明VMware Desktop Hypervisor包括 VMware Workstation Pro 和 VMware Fusion Pro自 2024 年 11 月 11 日起面向商业、教育和个人用户免费其中 Workstation Pro 17.5.2 及以上版本适用该免费版本说明。(Support Portal)3.2 为什么选择 Windows 10 虚拟机这里选择 Windows 10 虚拟机安装门槛低图形界面直观PowerShell、Node.js、Git、Python 都容易安装后续 Skill 生成文件、查看目录比较方便虚拟机可以拍快照出错后直接恢复。Windows ISO 建议从 Microsoft 官方页面下载。Microsoft 官方页面说明该页面可用于下载 Windows 10 ISO 文件用于安装或重新安装 Windows 10。(微软)打开浏览器的开发者⼯具, 点击 “切换设备仿真” 图标此时⻚⾯会刷新并模拟成移动设备视图. ⻚⾯上原来⽴即下载⼯具的按钮, 已经变成了可以下拉,选择Windows版本和语⾔的ISO下载选项.四、安装 VMware 并创建虚拟机4.1 安装 VMware Workstation ProVMware 的安装过程不复杂保持默认配置即可。安装完成后打开 VMware Workstation Pro准备创建虚拟机。4.2 创建 Windows 10 虚拟机创建虚拟机的大致步骤文件 ↓ 新建虚拟机 ↓ 典型推荐 ↓ 选择 Windows 10 ISO ↓ 设置虚拟机名称和保存位置 ↓ 设置磁盘大小 ↓ 自定义硬件 ↓ 完成建议配置配置项建议值内存4GB 起步8GB 更好CPU2 核起步磁盘60GB 起步网络NAT固件默认即可USB / 打印机不需要可以移除这里不建议一开始给虚拟机分太少内存。OpenClaw 本身不是大型本地模型但运行 Node.js、浏览器、Dashboard、Python 脚本时4GB 以下会比较紧张。4.3 安装 Windows 10虚拟机启动后会进入 Windows 安装流程。安装时按正常步骤操作即可选择语言 ↓ 选择安装版本 ↓ 选择自定义安装 ↓ 选择虚拟磁盘 ↓ 等待安装完成 ↓ 创建本地用户建议创建本地账户不要在虚拟机里登录自己的主力 Microsoft 账号。原因很简单这是实验环境不需要绑定真实个人账号。后续 Agent 可能会操作浏览器、读取文件、访问网络虚拟机里尽量不要放和真实生活强绑定的数据。4.4 安装 VMware ToolsWindows 安装完成后建议安装 VMware Tools。作用包括改善分辨率改善鼠标切换支持剪贴板共享支持共享文件夹提升虚拟机使用体验。操作路径VMware 菜单栏 ↓ 虚拟机 ↓ 安装 VMware Tools然后进入虚拟机系统在“此电脑”中打开虚拟光驱运行安装程序。安装完成后重启虚拟机。4.5 创建快照这是本篇很重要的一步。在安装 OpenClaw 之前先给虚拟机创建一个快照。操作路径VMware 菜单栏 ↓ 虚拟机 ↓ 快照 ↓ 拍摄快照快照名称可以写clean-windows-before-openclaw说明可以写Windows 10 clean environment before installing OpenClaw后续如果环境装乱、配置错、依赖冲突直接回滚到这个快照即可。五、安装基础环境OpenClaw 官方安装文档说明推荐 Node 24同时支持 Node 22.19。如果使用官方安装脚本它会检测系统、安装缺失依赖、安装 OpenClaw 并启动 onboarding。(OpenClaw)不过为了减少安装脚本中途失败的概率本文先手动安装三个基础工具配置虚拟机共享文件夹把本地电脑下好的安装包放进去即可Node.js Git Python5.1 安装 Node.jsOpenClaw 依赖 Node.js。本文选择安装 Node 24 系列。Node.js 官方下载页提供 Windows 安装包。当前官方下载页显示 Node.js 是跨平台 JavaScript 运行时并提供 Windows 版本下载。(nodejs.org)安装时保持默认选项即可。安装完成后打开 PowerShell验证node-v npm-v正常情况下会输出类似v24.x.x 11.x.x这里不要求版本号和上面完全一致但要满足 OpenClaw 官方要求Node 24 推荐 Node 22.19 支持如果node -v没有输出说明 Node.js 没有正确加入 PATH。可以重启 PowerShell或者重启虚拟机后再试。5.2 安装 GitGit 后续用于拉取代码、安装某些依赖或处理 Skill 项目。Git 官方 Windows 安装页提供 Git for Windows 安装包。(Git)安装时保持默认选项即可。安装完成后验证git--version然后设置用户名和邮箱git config--global user.nameYour Namegit config--global user.emailemailexample.com这里的用户名和邮箱主要用于 Git 提交记录。学习阶段可以先填自己的常用昵称和邮箱。5.3 安装 PythonPython 不是 OpenClaw 最小安装的硬性前置条件但后续写 Skill 时会经常用到。例如二维码生成、文件处理、网页数据处理等都适合用 Python 写脚本。Python 官方下载页提供 Windows 版本安装器。(Python.org)安装时注意勾选Add Python to PATH安装完成后验证python--version pip--version如果python --version无法识别优先检查是否勾选了 PATH或者重新打开 PowerShell。六、安装 OpenClaw6.1 使用官方 Windows 安装命令OpenClaw 官方安装文档给出的 Windows PowerShell 安装命令是powershell-cirm https://openclaw.ai/install.ps1 | iex该命令会下载并执行官方安装脚本。官方文档说明推荐安装脚本会检测操作系统、必要时安装 Node、安装 OpenClaw并启动 onboarding。(OpenClaw)建议使用管理员身份打开 PowerShell。操作方式开始菜单 ↓ 搜索 PowerShell ↓ 右键 ↓ 以管理员身份运行如果 PowerShell 拦截脚本执行可以先设置当前用户的执行策略Set-ExecutionPolicyRemoteSigned-Scope CurrentUser如果当前窗口仍然不允许执行脚本可以对当前进程临时放行Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass然后重新执行安装命令。6.2 验证 OpenClaw 是否安装成功安装完成后先验证 CLI 是否可用openclaw--version然后运行诊断openclaw doctor再查看 Gateway 状态openclaw gateway status官方安装文档也把这些命令列为安装验证方式确认 CLI 可用、检查配置问题、确认 Gateway 运行状态。(OpenClaw)如果提示openclaw不是内部或外部命令通常是 PATH 没刷新。处理方式1. 关闭当前 PowerShell 2. 重新打开 PowerShell 3. 再执行 openclaw --version 4. 如果仍然失败重启虚拟机七、运行 onboard 配置向导7.1 onboard 是什么安装 OpenClaw 后需要运行 onboarding。官方 Getting Started 文档说明onboarding 会引导选择模型提供商、设置 API key并配置 Gateway。(OpenClaw)如果安装脚本没有自动进入配置向导可以手动执行openclaw onboard--install-daemon或者openclaw onboard两者区别可以先简单理解openclaw onboard 只运行配置向导 openclaw onboard --install-daemon 运行配置向导并尝试安装后台服务如果只是第一次学习可以优先根据安装过程提示走默认流程。7.2 配置模型提供商OpenClaw 自身不是大模型。它需要连接一个模型提供商。常见模型提供商包括OpenAIAnthropicGoogleMoonshot / KimiMiniMax其他 OpenAI-compatible 接口。这里按自己已有的 API Key 选择即可。配置时一般会遇到这些问题选择 provider 输入 API Key 选择默认模型 配置 Gateway 是否配置 Channel 是否配置 Skills 是否启用 Hooks初次安装建议保持简单配置项建议模型提供商选择自己已有 API Key 的服务Channel暂时跳过Search provider暂时跳过Skills暂时不额外安装Hooks暂时跳过Gateway auth保持 token 或默认安全配置7.3 配置文件在哪里OpenClaw 的配置文件通常位于C:\Users\你的用户名\.openclaw\openclaw.jsonLinux / macOS / WSL2 环境一般是~/.openclaw/openclaw.jsonOpenClaw FAQ 说明默认配置路径是~/.openclaw/openclaw.json也可以通过$OPENCLAW_CONFIG_PATH指定配置路径。(OpenClaw)Windows 下路径表现形式不同但核心含义一样.openclaw 目录保存 OpenClaw 的配置、凭据、会话等内容。后续如果需要修改模型、Gateway、Skill、工具权限都会逐渐接触这个文件。八、启动 Gateway8.1 Gateway 是什么Gateway 可以理解为 OpenClaw 的入口层。它负责接收来自 Dashboard、TUI、IM 通道、API 等入口的请求然后交给 Agent Runtime 处理。当前阶段先不展开 Gateway 的完整架构只需要记住没有 Gateway就没有稳定的 OpenClaw 会话入口。查看 Gateway 状态openclaw gateway status如果没有运行可以启动openclaw gateway或者根据安装方式使用后台服务。官方 Getting Started 文档中验证 Gateway 的命令是openclaw gateway status并说明应看到 Gateway 监听在 18789 端口。(OpenClaw)8.2 Gateway 认证问题OpenClaw 默认会对 Gateway 做认证包括本地 loopback 场景。官方 FAQ 说明如果没有显式配置认证路径Gateway 启动时会解析为 token 模式并生成本次运行的 token本地客户端也需要认证。(OpenClaw)简单理解Dashboard 不是随便打开就能用 它需要正确的 token 或认证信息。如果打开 Dashboard 后提示 unauthorized优先检查1. Gateway 是否正在运行 2. Dashboard URL 是否带 token 3. openclaw dashboard 是否输出了新的访问地址 4. 是否使用了旧 token不要把 Gateway 端口直接暴露到公网。OpenClaw 安全文档中明确提醒共享密钥认证等同于完整 operator 访问不应把这些凭据分享给不受信任调用方并建议不同信任边界使用独立 Gateway。(OpenClaw)九、打开 Dashboard9.1 启动 Dashboard执行openclaw dashboard官方 Getting Started 文档说明该命令会在浏览器中打开 Control UI如果页面能加载说明基本流程已经跑通。(OpenClaw)正常情况下浏览器会打开类似http://127.0.0.1:18789或者带 token 的地址。9.2 发送第一条消息在 Dashboard 输入一条简单消息例如你好帮我确认一下当前 OpenClaw 是否已经正常运行。如果能收到回复说明至少以下部分已经正常OpenClaw CLI Gateway Dashboard 模型认证 基础对话流程这里的成功标准不是“命令执行完了”而是浏览器能打开 Dashboard Dashboard 能发消息 模型能返回回答。十、使用 TUI 测试除了 DashboardOpenClaw 也支持 TUI也就是终端界面。执行openclaw tuiTUI 适合命令行场景Dashboard 更适合演示和初学阶段观察状态。本文后续主要使用 Dashboard因为更直观。测试消息请用一句话说明你现在能访问哪些基础工具。如果能收到回复说明 TUI 也可用。十一、常见问题11.1 openclaw 不是内部或外部命令现象openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。可能原因1. 安装没有完成 2. npm 全局路径没有加入 PATH 3. PowerShell 还没刷新环境变量处理方式node-v npm-v npm prefix-g然后关闭 PowerShell重新打开再试。如果仍然不行重启虚拟机。官方安装文档也把node -v、npm prefix -g和 PATH 检查列为openclaw找不到时的排查方向。(OpenClaw)11.2 Dashboard 打不开先检查 Gatewayopenclaw gateway status如果 Gateway 没运行openclaw gateway再打开 Dashboardopenclaw dashboard11.3 Dashboard 提示 unauthorized通常是 token 不对或 URL 过期。处理方式openclaw dashboard重新复制命令输出的新地址。不要手动猜 token。11.4 对话时提示 API Key 错误常见原因1. API Key 输入错误 2. API Key 已过期 3. 模型 provider 选错 4. base_url 配置不匹配 5. 账号没有开通对应模型处理方式openclaw onboard重新进入配置向导检查模型提供商和 API Key。11.5 虚拟机太卡可以尝试1. 给虚拟机分配 8GB 内存 2. 给虚拟机分配 2 核或更多 CPU 3. 关闭虚拟机中不必要的软件 4. 确认 VMware Tools 已安装 5. 不要同时打开太多浏览器标签页如果宿主机本身内存只有 8GB虚拟机分配 4GB 更稳不要把宿主机内存全部分出去。十二、本篇总结这一篇只完成一件事在 Windows 虚拟机里安装 OpenClaw并完成第一次对话。到这里基础环境应该已经具备1. Windows 10 虚拟机 2. VMware 快照 3. Node.js 4. Git 5. Python 6. OpenClaw CLI 7. Gateway 8. Dashboard 9. TUI 10. 可用的模型认证本文没有展开 Skill也没有接入飞书、钉钉等消息通道。原因是这些内容都依赖一个稳定的 OpenClaw 基础环境。下一篇开始进入 OpenClaw 的核心机制Gateway 是什么 Agent Runtime 是什么 Tool 为什么能操作文件和命令 exec 为什么危险 OpenClaw 的工作区到底是不是沙箱
【OpenClaw篇】OpenClaw 实战入门：在 VMware 虚拟机里部署第一个本地 AI Agent
发布时间：2026/5/29 3:56:21
文章目录OpenClaw 实战入门在 VMware 虚拟机里部署第一个本地 AI Agent一、前言二、为什么使用虚拟机2.1 OpenClaw 不是普通聊天工具2.2 Workspace 不是天然沙箱2.3 为什么不直接用宿主机三、本文实验环境3.1 环境规划3.2 为什么选择 Windows 10 虚拟机四、安装 VMware 并创建虚拟机4.1 安装 VMware Workstation Pro4.2 创建 Windows 10 虚拟机4.3 安装 Windows 104.4 安装 VMware Tools4.5 创建快照五、安装基础环境5.1 安装 Node.js5.2 安装 Git5.3 安装 Python六、安装 OpenClaw6.1 使用官方 Windows 安装命令6.2 验证 OpenClaw 是否安装成功七、运行 onboard 配置向导7.1 onboard 是什么7.2 配置模型提供商7.3 配置文件在哪里八、启动 Gateway8.1 Gateway 是什么8.2 Gateway 认证问题九、打开 Dashboard9.1 启动 Dashboard9.2 发送第一条消息十、使用 TUI 测试十一、常见问题11.1 openclaw 不是内部或外部命令11.2 Dashboard 打不开11.3 Dashboard 提示 unauthorized11.4 对话时提示 API Key 错误11.5 虚拟机太卡十二、本篇总结OpenClaw 实战入门在 VMware 虚拟机里部署第一个本地 AI Agent一、前言这一篇讲什么在隔离的 Windows 虚拟机中安装并启动 OpenClaw核心内容为什么本系列统一使用 VMware 虚拟机环境如何准备 Windows 虚拟机实验环境如何安装 Node.js、Git、Python如何安装 OpenClaw如何完成 onboard 配置如何启动 Gateway、Dashboard并完成第一次对话本文定位本文不是 OpenClaw 所有部署方式的汇总而是本系列的第一篇实战文章。后续内容会继续围绕同一个实验环境展开包括 Tool 使用、Skill 开发、自动化任务和消息通道接入。OpenClaw 是一个本地优先的 AI Agent 执行环境。它和普通聊天 AI 的区别在于普通聊天 AI 主要返回文本而 OpenClaw 可以把模型、工具、工作区、Skill 和通信通道连接起来让 AI 在一定权限范围内执行实际任务。官方文档中对 OpenClaw 入门流程的描述很直接安装 OpenClaw、运行 onboarding、配置模型认证、启动 Gateway然后通过聊天界面发送第一条消息。官方安装文档也说明OpenClaw 推荐 Node 24同时支持 Node 22.19并支持 macOS、Linux、Windows 和 WSL2在 Windows 场景下官方说明 WSL2 更稳定。本文不走 WSL2而是使用 Windows 虚拟机这是为了把实验环境和宿主机隔离开。:本文采用的路线是Windows 宿主机 ↓ VMware Workstation Pro ↓ Windows 10 虚拟机 ↓ Node.js / Git / Python ↓ OpenClaw ↓ Gateway / Dashboard / TUI这样做的好处是环境固定、出问题可以回滚也不会直接影响宿主机里的文件和账号。二、为什么使用虚拟机2.1 OpenClaw 不是普通聊天工具OpenClaw 不是一个只负责回答问题的网页聊天框。它有自己的 Gateway、Agent Runtime、Workspace、Tools 和 Skills。官方文档中Agent Runtime 的描述是一个 Gateway 对应一个嵌入式 agent process并拥有自己的 workspace、bootstrap files 和 session store。也就是说OpenClaw 不是单次问答而是一个可以持续运行、携带工作区上下文、调用工具的 Agent 运行环境。(OpenClaw)可以先用一个简单流程理解用户输入任务 ↓ Gateway 接收请求 ↓ Agent 判断要做什么 ↓ 调用 Tool 或 Skill ↓ 读取执行结果 ↓ 继续执行或返回答案这里最需要注意的是Tool 和 Skill 可能会触碰真实环境。比如后续会接触到的能力包括读取文件修改文件执行命令抓取网页启动浏览器调用外部 API定时执行任务。这也是为什么本文不建议直接安装在主力机上。2.2 Workspace 不是天然沙箱OpenClaw 有 workspace 概念。官方文档说明workspace 是 agent 的工作目录也是文件工具和工作区上下文使用的目录。默认位置一般是~/.openclaw/workspace但官方文档同时提醒workspace 是默认工作目录不等于严格沙箱。如果没有开启 sandbox绝对路径仍然可能访问宿主机上的其他位置。(OpenClaw)这句话很关键。也就是说不能简单理解为只要 OpenClaw 有 workspace就一定不会碰到别的目录。更准确的理解是workspace 是默认工作目录 sandbox 才是隔离机制 如果 sandbox 没开工具可能仍然运行在宿主环境中。官方 sandboxing 文档也说明OpenClaw 可以把工具执行放到 sandbox backend 中以降低影响范围但这是可选配置如果 sandboxing 关闭工具会运行在 host 上。(OpenClaw)所以本系列第一步先做外层隔离先用虚拟机隔离整个实验环境 后续再讨论 OpenClaw 自己的 sandbox 配置。2.3 为什么不直接用宿主机直接安装在宿主机上不是不能用而是不适合作为第一套实验环境。主要原因有三个。第一文件风险。如果 Agent 被授权执行文件操作它可能读写本地文件。初学阶段还不熟悉 Tool 权限、工作区范围和配置项直接放在主力机上风险太大。第二命令风险。OpenClaw 的工具体系里包含运行命令、管理进程、读写文件、网页访问、浏览器控制等类别。官方工具文档中列出的代表性工具包括exec、process、read、write、edit、apply_patch、web_search、web_fetch、browser、cron等。(OpenClaw)其中exec这类命令执行工具最需要谨慎。只要允许执行命令就不能简单认为它是“只读”的。第三第三方 Skill 风险。OpenClaw 官方 Skill 文档明确提醒第三方 Skills 应该当作不受信任的代码处理启用前需要阅读内容对于不受信任输入和高风险工具优先使用 sandbox。(OpenClaw)因此本文采用 VMware 虚拟机作为基础实验环境。三、本文实验环境3.1 环境规划本文环境统一为项目配置宿主机系统Windows 10 / Windows 11虚拟机软件VMware Workstation Pro虚拟机系统Windows 10 64 位虚拟机内存建议 4GB 起步8GB 更稳虚拟机磁盘建议 60GB 起步网络模式NAT 即可OpenClaw 安装方式Windows PowerShell 官方安装脚本模型提供商根据自己已有 API Key 选择本文目标打开 Dashboard并完成第一次对话VMware Workstation Pro 当前可以免费使用。Broadcom 官方知识库说明VMware Desktop Hypervisor包括 VMware Workstation Pro 和 VMware Fusion Pro自 2024 年 11 月 11 日起面向商业、教育和个人用户免费其中 Workstation Pro 17.5.2 及以上版本适用该免费版本说明。(Support Portal)3.2 为什么选择 Windows 10 虚拟机这里选择 Windows 10 虚拟机安装门槛低图形界面直观PowerShell、Node.js、Git、Python 都容易安装后续 Skill 生成文件、查看目录比较方便虚拟机可以拍快照出错后直接恢复。Windows ISO 建议从 Microsoft 官方页面下载。Microsoft 官方页面说明该页面可用于下载 Windows 10 ISO 文件用于安装或重新安装 Windows 10。(微软)打开浏览器的开发者⼯具, 点击 “切换设备仿真” 图标此时⻚⾯会刷新并模拟成移动设备视图. ⻚⾯上原来⽴即下载⼯具的按钮, 已经变成了可以下拉,选择Windows版本和语⾔的ISO下载选项.四、安装 VMware 并创建虚拟机4.1 安装 VMware Workstation ProVMware 的安装过程不复杂保持默认配置即可。安装完成后打开 VMware Workstation Pro准备创建虚拟机。4.2 创建 Windows 10 虚拟机创建虚拟机的大致步骤文件 ↓ 新建虚拟机 ↓ 典型推荐 ↓ 选择 Windows 10 ISO ↓ 设置虚拟机名称和保存位置 ↓ 设置磁盘大小 ↓ 自定义硬件 ↓ 完成建议配置配置项建议值内存4GB 起步8GB 更好CPU2 核起步磁盘60GB 起步网络NAT固件默认即可USB / 打印机不需要可以移除这里不建议一开始给虚拟机分太少内存。OpenClaw 本身不是大型本地模型但运行 Node.js、浏览器、Dashboard、Python 脚本时4GB 以下会比较紧张。4.3 安装 Windows 10虚拟机启动后会进入 Windows 安装流程。安装时按正常步骤操作即可选择语言 ↓ 选择安装版本 ↓ 选择自定义安装 ↓ 选择虚拟磁盘 ↓ 等待安装完成 ↓ 创建本地用户建议创建本地账户不要在虚拟机里登录自己的主力 Microsoft 账号。原因很简单这是实验环境不需要绑定真实个人账号。后续 Agent 可能会操作浏览器、读取文件、访问网络虚拟机里尽量不要放和真实生活强绑定的数据。4.4 安装 VMware ToolsWindows 安装完成后建议安装 VMware Tools。作用包括改善分辨率改善鼠标切换支持剪贴板共享支持共享文件夹提升虚拟机使用体验。操作路径VMware 菜单栏 ↓ 虚拟机 ↓ 安装 VMware Tools然后进入虚拟机系统在“此电脑”中打开虚拟光驱运行安装程序。安装完成后重启虚拟机。4.5 创建快照这是本篇很重要的一步。在安装 OpenClaw 之前先给虚拟机创建一个快照。操作路径VMware 菜单栏 ↓ 虚拟机 ↓ 快照 ↓ 拍摄快照快照名称可以写clean-windows-before-openclaw说明可以写Windows 10 clean environment before installing OpenClaw后续如果环境装乱、配置错、依赖冲突直接回滚到这个快照即可。五、安装基础环境OpenClaw 官方安装文档说明推荐 Node 24同时支持 Node 22.19。如果使用官方安装脚本它会检测系统、安装缺失依赖、安装 OpenClaw 并启动 onboarding。(OpenClaw)不过为了减少安装脚本中途失败的概率本文先手动安装三个基础工具配置虚拟机共享文件夹把本地电脑下好的安装包放进去即可Node.js Git Python5.1 安装 Node.jsOpenClaw 依赖 Node.js。本文选择安装 Node 24 系列。Node.js 官方下载页提供 Windows 安装包。当前官方下载页显示 Node.js 是跨平台 JavaScript 运行时并提供 Windows 版本下载。(nodejs.org)安装时保持默认选项即可。安装完成后打开 PowerShell验证node-v npm-v正常情况下会输出类似v24.x.x 11.x.x这里不要求版本号和上面完全一致但要满足 OpenClaw 官方要求Node 24 推荐 Node 22.19 支持如果node -v没有输出说明 Node.js 没有正确加入 PATH。可以重启 PowerShell或者重启虚拟机后再试。5.2 安装 GitGit 后续用于拉取代码、安装某些依赖或处理 Skill 项目。Git 官方 Windows 安装页提供 Git for Windows 安装包。(Git)安装时保持默认选项即可。安装完成后验证git--version然后设置用户名和邮箱git config--global user.nameYour Namegit config--global user.emailemailexample.com这里的用户名和邮箱主要用于 Git 提交记录。学习阶段可以先填自己的常用昵称和邮箱。5.3 安装 PythonPython 不是 OpenClaw 最小安装的硬性前置条件但后续写 Skill 时会经常用到。例如二维码生成、文件处理、网页数据处理等都适合用 Python 写脚本。Python 官方下载页提供 Windows 版本安装器。(Python.org)安装时注意勾选Add Python to PATH安装完成后验证python--version pip--version如果python --version无法识别优先检查是否勾选了 PATH或者重新打开 PowerShell。六、安装 OpenClaw6.1 使用官方 Windows 安装命令OpenClaw 官方安装文档给出的 Windows PowerShell 安装命令是powershell-cirm https://openclaw.ai/install.ps1 | iex该命令会下载并执行官方安装脚本。官方文档说明推荐安装脚本会检测操作系统、必要时安装 Node、安装 OpenClaw并启动 onboarding。(OpenClaw)建议使用管理员身份打开 PowerShell。操作方式开始菜单 ↓ 搜索 PowerShell ↓ 右键 ↓ 以管理员身份运行如果 PowerShell 拦截脚本执行可以先设置当前用户的执行策略Set-ExecutionPolicyRemoteSigned-Scope CurrentUser如果当前窗口仍然不允许执行脚本可以对当前进程临时放行Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass然后重新执行安装命令。6.2 验证 OpenClaw 是否安装成功安装完成后先验证 CLI 是否可用openclaw--version然后运行诊断openclaw doctor再查看 Gateway 状态openclaw gateway status官方安装文档也把这些命令列为安装验证方式确认 CLI 可用、检查配置问题、确认 Gateway 运行状态。(OpenClaw)如果提示openclaw不是内部或外部命令通常是 PATH 没刷新。处理方式1. 关闭当前 PowerShell 2. 重新打开 PowerShell 3. 再执行 openclaw --version 4. 如果仍然失败重启虚拟机七、运行 onboard 配置向导7.1 onboard 是什么安装 OpenClaw 后需要运行 onboarding。官方 Getting Started 文档说明onboarding 会引导选择模型提供商、设置 API key并配置 Gateway。(OpenClaw)如果安装脚本没有自动进入配置向导可以手动执行openclaw onboard--install-daemon或者openclaw onboard两者区别可以先简单理解openclaw onboard 只运行配置向导 openclaw onboard --install-daemon 运行配置向导并尝试安装后台服务如果只是第一次学习可以优先根据安装过程提示走默认流程。7.2 配置模型提供商OpenClaw 自身不是大模型。它需要连接一个模型提供商。常见模型提供商包括OpenAIAnthropicGoogleMoonshot / KimiMiniMax其他 OpenAI-compatible 接口。这里按自己已有的 API Key 选择即可。配置时一般会遇到这些问题选择 provider 输入 API Key 选择默认模型 配置 Gateway 是否配置 Channel 是否配置 Skills 是否启用 Hooks初次安装建议保持简单配置项建议模型提供商选择自己已有 API Key 的服务Channel暂时跳过Search provider暂时跳过Skills暂时不额外安装Hooks暂时跳过Gateway auth保持 token 或默认安全配置7.3 配置文件在哪里OpenClaw 的配置文件通常位于C:\Users\你的用户名\.openclaw\openclaw.jsonLinux / macOS / WSL2 环境一般是~/.openclaw/openclaw.jsonOpenClaw FAQ 说明默认配置路径是~/.openclaw/openclaw.json也可以通过$OPENCLAW_CONFIG_PATH指定配置路径。(OpenClaw)Windows 下路径表现形式不同但核心含义一样.openclaw 目录保存 OpenClaw 的配置、凭据、会话等内容。后续如果需要修改模型、Gateway、Skill、工具权限都会逐渐接触这个文件。八、启动 Gateway8.1 Gateway 是什么Gateway 可以理解为 OpenClaw 的入口层。它负责接收来自 Dashboard、TUI、IM 通道、API 等入口的请求然后交给 Agent Runtime 处理。当前阶段先不展开 Gateway 的完整架构只需要记住没有 Gateway就没有稳定的 OpenClaw 会话入口。查看 Gateway 状态openclaw gateway status如果没有运行可以启动openclaw gateway或者根据安装方式使用后台服务。官方 Getting Started 文档中验证 Gateway 的命令是openclaw gateway status并说明应看到 Gateway 监听在 18789 端口。(OpenClaw)8.2 Gateway 认证问题OpenClaw 默认会对 Gateway 做认证包括本地 loopback 场景。官方 FAQ 说明如果没有显式配置认证路径Gateway 启动时会解析为 token 模式并生成本次运行的 token本地客户端也需要认证。(OpenClaw)简单理解Dashboard 不是随便打开就能用 它需要正确的 token 或认证信息。如果打开 Dashboard 后提示 unauthorized优先检查1. Gateway 是否正在运行 2. Dashboard URL 是否带 token 3. openclaw dashboard 是否输出了新的访问地址 4. 是否使用了旧 token不要把 Gateway 端口直接暴露到公网。OpenClaw 安全文档中明确提醒共享密钥认证等同于完整 operator 访问不应把这些凭据分享给不受信任调用方并建议不同信任边界使用独立 Gateway。(OpenClaw)九、打开 Dashboard9.1 启动 Dashboard执行openclaw dashboard官方 Getting Started 文档说明该命令会在浏览器中打开 Control UI如果页面能加载说明基本流程已经跑通。(OpenClaw)正常情况下浏览器会打开类似http://127.0.0.1:18789或者带 token 的地址。9.2 发送第一条消息在 Dashboard 输入一条简单消息例如你好帮我确认一下当前 OpenClaw 是否已经正常运行。如果能收到回复说明至少以下部分已经正常OpenClaw CLI Gateway Dashboard 模型认证 基础对话流程这里的成功标准不是“命令执行完了”而是浏览器能打开 Dashboard Dashboard 能发消息 模型能返回回答。十、使用 TUI 测试除了 DashboardOpenClaw 也支持 TUI也就是终端界面。执行openclaw tuiTUI 适合命令行场景Dashboard 更适合演示和初学阶段观察状态。本文后续主要使用 Dashboard因为更直观。测试消息请用一句话说明你现在能访问哪些基础工具。如果能收到回复说明 TUI 也可用。十一、常见问题11.1 openclaw 不是内部或外部命令现象openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。可能原因1. 安装没有完成 2. npm 全局路径没有加入 PATH 3. PowerShell 还没刷新环境变量处理方式node-v npm-v npm prefix-g然后关闭 PowerShell重新打开再试。如果仍然不行重启虚拟机。官方安装文档也把node -v、npm prefix -g和 PATH 检查列为openclaw找不到时的排查方向。(OpenClaw)11.2 Dashboard 打不开先检查 Gatewayopenclaw gateway status如果 Gateway 没运行openclaw gateway再打开 Dashboardopenclaw dashboard11.3 Dashboard 提示 unauthorized通常是 token 不对或 URL 过期。处理方式openclaw dashboard重新复制命令输出的新地址。不要手动猜 token。11.4 对话时提示 API Key 错误常见原因1. API Key 输入错误 2. API Key 已过期 3. 模型 provider 选错 4. base_url 配置不匹配 5. 账号没有开通对应模型处理方式openclaw onboard重新进入配置向导检查模型提供商和 API Key。11.5 虚拟机太卡可以尝试1. 给虚拟机分配 8GB 内存 2. 给虚拟机分配 2 核或更多 CPU 3. 关闭虚拟机中不必要的软件 4. 确认 VMware Tools 已安装 5. 不要同时打开太多浏览器标签页如果宿主机本身内存只有 8GB虚拟机分配 4GB 更稳不要把宿主机内存全部分出去。十二、本篇总结这一篇只完成一件事在 Windows 虚拟机里安装 OpenClaw并完成第一次对话。到这里基础环境应该已经具备1. Windows 10 虚拟机 2. VMware 快照 3. Node.js 4. Git 5. Python 6. OpenClaw CLI 7. Gateway 8. Dashboard 9. TUI 10. 可用的模型认证本文没有展开 Skill也没有接入飞书、钉钉等消息通道。原因是这些内容都依赖一个稳定的 OpenClaw 基础环境。下一篇开始进入 OpenClaw 的核心机制Gateway 是什么 Agent Runtime 是什么 Tool 为什么能操作文件和命令 exec 为什么危险 OpenClaw 的工作区到底是不是沙箱
