1.安装node.js1.1下载地址为https://nodejs.org/zh-cn/download/https://nodejs.org/zh-cn/download/选择Windows 平台推荐下载Windows 安装程序 (.msi)64 位系统对应 x64 版本如node-v24.16.0-x64.msi1.2 准备安装将下载好的.msi文件放到一个无中文、无空格的路径下例如D:\tool\nodejs\避免后续因路径问题报错。1.2.下载后放在自己特定的文件夹里面双击进行安装路径选择自己要安装到的路径最好不要放在C盘放到其他盘我就放到了D盘1.3 安装过程中会遇到一个「Tools for Native Modules」的步骤这里有个选项一定要注意因为我们后续要安装「龙虾」这类需要编译原生模块的项目必须勾选「Automatically install the necessary tools」。勾选后程序会自动装好 Python、VS Build Tools 这些编译需要的环境还会顺带装个 Windows 包管理器 Chocolatey安装完会自动弹个窗口跑配置脚本不用自己折腾。要是不勾这个选项后面装「龙虾」的时候大概率会报找不到编译工具的错误新手就直接选自动安装就行此时应该是会卡主如果不是已管理身份运行1.4 此时在开始搜索nodejs找到这个后以管理员身份运行脚本安装详细内容解释组件名称全称 / 说明核心作用对你的项目的意义Visual Studio Build Tools微软 C/C 构建工具集提供 C/C 编译器MSVC、Windows SDK、构建工具是编译原生模块的核心没有它你的项目里的 C/C 代码根本无法被编译npm install 会直接报错PythonPython 运行环境脚本会自动安装兼容版本为 Node.js 的构建工具node-gyp提供运行环境执行构建配置脚本node-gypNode.js 官方的原生模块构建工具依赖 Python 运行没有 Python 就无法启动编译流程ChocolateyWindows 平台的包管理器一个自动化的工具安装 / 管理工具脚本用它来自动下载、安装上面的 Python 和 Build Tools不用你手动找安装包、配置环境相当于帮你「一键托管」了所有依赖的安装流程避免手动安装时的各种坑Required Windows Updates必要的 Windows 系统更新安装 Build Tools/Python 所需的系统运行库、API 补丁确保工具能正常运行很多旧版本 Windows 会因为缺少特定更新导致 Build Tools 安装失败或运行报错1.5 之后点击任意键一直到弹出powershell为止进行安装必要的文件这个比较耗时要一直等1.6 按enter键结束1.7 检查打开命令提示符输入node -v如果显示版本则显示安装好了npm -v2. 安装OpenClaw2.1打开powershell并且已管理员身份运行并且输入以下命令Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y后回车命令全称 / 说明核心作用Set-ExecutionPolicy RemoteSigned -Scope CurrentUserPowerShell 脚本执行策略配置命令修改当前用户的 PowerShell 脚本执行权限将策略设置为RemoteSignedSet-ExecutionPolicyPowerShell 内置安全策略管理 Cmdlet专门用于修改 PowerShell 的脚本执行策略是该功能的核心指令RemoteSignedPowerShell 中等安全级别执行策略允许本地创建的脚本直接运行仅对网络下载的脚本要求可信数字签名-Scope CurrentUser执行策略作用域参数将策略生效范围限定为「当前登录用户」无需管理员权限即可执行环境限制仅 PowerShell 可执行PowerShell 专属安全机制依赖该命令依赖 PowerShell 运行时引擎、专属注册表配置路径和脚本校验逻辑Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass命令全称 / 说明核心作用Set-ExecutionPolicy -Scope Process -ExecutionPolicy BypassPowerShell 临时会话执行策略配置命令为当前 PowerShell 会话设置无限制执行策略完全绕过脚本安全检查且仅对当前会话生效Microsoft LearnSet-ExecutionPolicyPowerShell 内置安全策略管理 Cmdlet专门用于修改 PowerShell 脚本执行策略的核心指令属于 PowerShell 安全机制专属命令-Scope Process执行策略作用域参数进程级限定策略仅对当前 PowerShell 会话生效配置存储于环境变量$Env:PSExecutionPolicyPreference而非注册表关闭会话后自动删除Microsoft Learn-ExecutionPolicy Bypass无限制执行策略参数完全绕过 PowerShell 所有脚本安全检查不阻止任何脚本执行不显示警告和提示是限制最低的执行策略Microsoft Learn环境限制仅 PowerShell 可执行PowerShell 专属安全机制依赖该命令依赖 PowerShell 运行时引擎、专属环境变量存储和脚本校验逻辑是 PowerShell 独有的安全管控功能接下来输入以下的命令iwr -useb https://openclaw.ai/install.ps1 | iex命令全称 / 说明核心作用意义解释备注iwr -useb https://openclaw.ai/install.ps1iexPowerShell 远程脚本一键执行命令用于 OpenClaw 项目安装从指定 URL 下载 OpenClaw 官方安装脚本并直接在 PowerShell 内存中执行无需将脚本保存到本地实现 OpenClaw 项目的自动化安装自动检测并安装缺失依赖如 Git、Node.js 工具链完成项目运行环境的配置iwrInvoke-WebRequestPowerShell 内置 HTTP/HTTPS 请求 Cmdlet向指定 URL 发送 Web 请求获取远程脚本的原始内容用于下载 OpenClaw 的官方安装脚本是整个命令的 “下载环节”获取安装逻辑-useb-UseBasicParsingInvoke-WebRequest的参数强制使用基础解析引擎处理请求结果不依赖 IE 浏览器的 DOM 解析引擎避免依赖本地 IE 环境确保脚本下载过程在无 IE 或精简环境下也能正常工作提升兼容性https://openclaw.ai/install.ps1OpenClaw 项目的官方远程安装脚本 URL包含完整的安装逻辑依赖检测如 Node.js、Git、工具安装、项目初始化等提供标准化的一键安装流程自动解决项目依赖缺失问题如自动下载便携版 Git避免手动配置错误iex管道符 iex全称Invoke-ExpressionPowerShell 脚本执行机制将前序命令iwr的输出脚本内容直接传入 PowerShell 解析器执行无需本地保存文件实现 “下载即执行” 的无文件安装流程简化操作步骤同时确保安装脚本在当前 PowerShell 会话中生效环境限制仅 PowerShell 可执行PowerShell 专属 Cmdlet 与管道执行机制iwr和iex是 PowerShell 内置命令管道执行逻辑依赖 PowerShell 运行时CMD、Bash 等终端不支持这些 Cmdlet 和管道解析因此该命令仅能在 PowerShell 中执行确保 OpenClaw 安装流程正常运行在安装的过程当中会消耗的时间也比较长同时也在这个过程当中如果你的电脑有安全设置在这个过程当中会执行一些操作弹窗出来的时候直接运行就可以了如果没有则继续就可以了2.2 正式开始安装之后输入yes,继续进行执行通过上下键选择到quickStart之后回车2.3 选择模型对于可以爬墙的你就可以选择国外的这些大模型啦我可是一个守法的好公民所以我只能稍后进行配置了我选择skip for now也是通过上下键去进行选择enter之后进行下一步的配置默认继续进行回车就可以了不然又又又要卡主了2.4 选择聊天接入方式聊天的也可以选择先跳过2.5 技能配置这个也可以选择跳过技能先选择no,通过鼠标移动放到no上面之后进行回车2.6 hooks 配置接下来一样选择跳过就是默认的先上下选择skip for now 按空格后选择后直接回车就可以了就会弹出一下的界面了呀说明已经可以了呢但是我之前没有配置大模型所以会报以下的错误大概的意思是没有apikey而导致的2.7 交互模式配置选择稍后配置hatch later到此时配置初次已经全部完成了2.8 国内大模型配置不过此时是没是的我直接ctrlc先进行停止配置国内的大模型就可以啦接下来看我的操作先输入以下的命令这个命令作为所有的配置其他的配置也用这个命令openclaw configure直接回车就可以了现在选择模型的配置model之后选择more...选择more会弹出更多所以选择国内的喽我就拿deepseek来举例啦首先拿到apikey,先访问一下地址喽https://platform.deepseek.com/usagehttps://platform.deepseek.com/usage创建apikey,自己的key自己保存好,关闭后就没有了所有提前要复制出来之后选择deepseek输入apikey进行回车选择done完成配置弹出的这个窗口可以关闭2.9 重新启动openclaw gatewayopenclaw gateway重新打开一个powershell之后输入以下的命令就可以访问前端的简单的web页面了openclaw dashboard之后会自动弹出这么一个界面喽或者是用以下命令也可以直接获取tokenGet-Content $env:USERPROFILE\.openclaw\openclaw.json | Select-String token将获取到的token填入到里面就可以了2.10 完美访问http://127.0.0.1:18789/chat?sessionagent%3Amain%3Amainhttp://127.0.0.1:18789/chat?sessionagent%3Amain%3Amain3. 附录-命令的详细解释3.1 常用命令命令核心功能适用场景关键参数 / 示例openclaw onboard交互式引导设置完成网关、工作区、认证和频道配置首次安装使用快速完成初始化openclaw onboard默认无需额外参数openclaw setup创建基线配置、工作区和会话文件夹初始化基础环境手动初始化系统适合高级用户openclaw setup基础初始化openclaw configure交互式配置模型、网关、频道、插件、技能和健康检查修改系统配置调整运行参数openclaw configure进入配置向导openclaw status检查网关、频道、模型和最近会话状态日常系统监控快速排查连接问题openclaw status显示完整状态openclaw doctor诊断并修复配置、服务、插件和频道常见问题系统故障排查自动修复错误openclaw doctor --fix自动修复openclaw doctor --deep深度诊断openclaw gateway运行、检查和查询 OpenClaw 网关服务核心进程网关管理启动 / 停止 / 监控核心服务openclaw gateway run --force强制启动openclaw --dev gateway开发模式openclaw channels添加、删除、登录和检查消息频道管理聊天平台连接如 Telegramopenclaw channels add添加频道openclaw channels status查看状态openclaw models列出、扫描和设置模型提供商管理 AI 模型配置检查认证状态openclaw models status查看模型健康openclaw chat/tui打开本地终端 UI连接到网关进行聊天日常交互通过终端使用 AI 功能openclaw chat本地聊天openclaw tui终端 UIopenclaw update更新 OpenClaw 并检查更新频道状态系统升级获取最新功能和修复openclaw update check检查更新openclaw update apply应用更新3.2其他命令命令核心功能适用场景关键参数 / 示例acp运行和管理 ACP 支持的编码智能体代码生成、调试和优化场景openclaw acp run --task 编写Python脚本agent通过网关运行一个智能体轮次单次智能体任务执行openclaw agent --to 15555550123 --message 运行摘要agents管理隔离的智能体工作区、认证、路由多智能体环境管理隔离不同任务openclaw agents create --name 数据分析助手approvals管理执行审批网关或节点主机安全管控审批敏感操作openclaw approvals list查看审批列表backup创建和验证 OpenClaw 状态的本地备份档案数据备份与恢复防止数据丢失openclaw backup create --path D:\backupcapability/infer运行提供商功能命令模型、媒体、搜索等直接调用 AI 能力无需完整智能体openclaw infer --model gpt-4 --prompt 解释量子计算clawbot传统 clawbot 命令别名兼容旧版操作习惯openclaw clawbot legacy-commandcommitments列出和管理推断的后续承诺任务跟踪管理智能体承诺事项openclaw commitments listcompletion生成 shell 补全脚本提升命令行使用效率自动补全openclaw completion powershell生成 PowerShell 补全config非交互式配置助手get/set/unset 等脚本化配置管理批量修改参数openclaw config set gateway.port 19000crestodian打开交互式设置和修复助手系统维护解决复杂配置问题openclaw crestodiancron调度和检查网关后台作业定时任务管理自动化执行操作openclaw cron add --command backup --schedule dailydaemon管理网关服务传统别名兼容旧版命令同 gatewayopenclaw daemon startdashboard用当前令牌打开控制 UI图形化管理通过浏览器操作openclaw dashboarddevices设备配对 令牌管理多设备连接管理认证令牌openclaw devices pairdirectory查找联系人 / 群组 ID自身、同伴、群组消息发送获取目标 IDopenclaw directory search --name JohndnsDNS 助手用于广域发现Tailscale CoreDNS网络配置多节点发现openclaw dns setupdocs搜索实时 OpenClaw 文档快速查询帮助获取官方指南openclaw docs search gatewayexec-policy显示或同步请求的执行策略与主机审批安全策略管理控制执行权限openclaw exec-policy synchealth从运行的网关获取详细健康信息系统监控深度健康检查openclaw healthhooks管理内部智能体钩子自定义智能体行为添加扩展功能openclaw hooks add --name custom-hooklogs本地或通过 RPC 跟踪网关日志故障排查查看系统运行记录openclaw logs --tail 100查看最后 100 行mcp管理 OpenClaw MCP 配置和频道桥多频道管理消息桥接openclaw mcp setupmemory搜索、检查和重新索引内存文件记忆管理优化上下文存储openclaw memory search 重要信息message发送、读取和管理频道消息直接消息操作无需智能体openclaw message send --channel telegram --target mychat --message Himigrate从其他智能体系统导入状态数据迁移整合旧系统数据openclaw migrate import --source old-agent-datanode运行和管理无头节点主机服务分布式部署扩展计算能力openclaw node startnodes配对节点并通过网关运行节点主机命令节点集群管理协调多节点openclaw nodes pairpairing安全 DM 配对批准入站请求设备连接安全配对验证openclaw pairing approveplugins安装、启用、禁用和检查插件扩展功能管理第三方插件openclaw plugins install meeting-notesproxy运行 OpenClaw 调试代理并检查捕获的流量调试网络请求排查通信问题openclaw proxy startqr生成移动配对 QR / 设置码移动设备连接快速配对openclaw qrreset重置本地配置 / 状态保留 CLI 安装系统重置解决严重配置错误openclaw resetsandbox管理智能体隔离的沙箱容器安全执行隔离危险操作openclaw sandbox createsecrets审计、应用和重新加载 SecretRef 支持的凭据凭据管理安全存储敏感信息openclaw secrets auditsecurity安全工具和本地配置审计系统安全检查漏洞扫描openclaw security auditsessions列出存储的对话会话会话管理查看历史对话openclaw sessions listskills列出、检查和安装智能体技能智能体能力扩展添加新技能openclaw skills install 数据分析system系统事件、心跳和状态系统监控查看运行状态openclaw system eventstasks检查持久化后台任务和流程任务管理监控长期运行任务openclaw tasks listterminal打开本地终端 UItui --local 别名日常交互同 chat/tuiopenclaw terminaluninstall卸载网关服务 本地数据保留 CLI系统清理卸载核心服务openclaw uninstallwebhooksWebhook 助手和集成外部系统集成接收 Webhook 事件openclaw webhooks setup4. 参考链接链接名称链接地址用途说明OpenClaw 官方文档首页https://docs.openclaw.aiOpenClaw 完整官方文档入口包含安装、配置、使用全流程指南是本教程的核心参考来源OpenClaw CLI 命令官方参考https://docs.openclaw.ai/cliOpenClaw 所有 CLI 命令的详细说明文档包含参数、示例和使用场景对应教程中的命令部分OpenClaw 官方一键安装脚本https://openclaw.ai/install.ps1教程中使用的iwr -useb https://openclaw.ai/install.ps1 | iex命令的官方脚本地址Node.js 官方下载与文档https://nodejs.org/zh-cn/download/教程中 Node.js 安装步骤的官方参考包含不同平台的安装包和版本说明node-gyp 官方 Windows 安装指南https://github.com/nodejs/node-gyp#on-windows教程中安装 Node.js 原生模块依赖Python、VS Build Tools的官方参考文档PowerShell 执行策略官方文档https://learn.microsoft.com/zh-cn/powershell/module/microsoft.powershell.security/set-executionpolicy教程中Set-ExecutionPolicy命令的官方说明解释执行策略的作用与参数