OpenClaw的安装过程核心分为环境预配置、初始化向导核心配置、功能进阶配置三大阶段配置的合理性直接决定了AI智能体的运行稳定性、功能完整性和数据安全性。本文基于官方最新稳定版完整拆解Windows系统下OpenClaw安装全流程的每一项配置明确配置含义、推荐选项、避坑要点新手可直接照着操作进阶用户可按需自定义。一、配置前置说明与必备前提1.1 配置核心阶段划分配置阶段核心作用操作时机安装前环境预配置解决Windows系统兼容性、权限、网络问题避免安装中断、报错执行安装命令之前初始化向导核心配置完成OpenClaw核心能力搭建决定模型接入、功能权限、运行模式安装脚本执行完成后自动进入/手动执行onboard命令安装后进阶功能配置优化运行稳定性、提升安全性、解锁高阶功能适配个人使用场景初始化完成服务正常启动后1.2 必备操作前提全程以管理员身份运行PowerShell/Windows终端否则会出现权限不足、配置不生效问题确保Windows系统为Win10 20H2 / Win11 64位版本32位系统无法兼容稳定的网络环境国内用户建议提前配置好国内镜像源避免下载超时、依赖拉取失败二、第一阶段安装前环境预配置必做这一步是安装配置的基础90%的安装报错都源于前置环境配置缺失需严格按顺序完成。2.1 PowerShell脚本执行策略配置Windows系统默认禁止运行外部脚本需先解锁执行权限否则一键安装脚本会直接被拦截。右键开始菜单选择「Windows PowerShell (管理员)」/「终端(管理员)」UAC弹窗点击「是」执行永久权限配置命令推荐Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser终端出现提示后输入Y回车确认完成策略修改。避坑提示若永久策略修改失败如域控电脑、公司设备可执行临时解锁命令仅对当前终端窗口生效关闭后自动恢复安全性更高Set-ExecutionPolicyBypass-ScopeProcess-Force2.2 Node.js环境与镜像源预配置OpenClaw基于Node.js开发官方推荐Node.js 24.x版本兼容22.16 LTS版本低版本会出现兼容性报错。新手无需提前手动安装一键脚本会自动检测并安装适配版本进阶用户可提前安装Node.js安装完成后重启终端执行以下命令验证node-v npm-v国内用户必做配置npm国内镜像源解决依赖下载慢、超时问题npm configsetregistry https://registry.npmmirror.com验证镜像源配置生效npm config get registry终端输出https://registry.npmmirror.com即为配置成功。2.3 系统路径与权限预配置安装路径避免中文、空格、特殊符号如“我的文件夹”“Open Claw”建议使用纯英文路径关闭系统代理、VPN、第三方杀毒软件/防火墙避免拦截脚本执行、API请求确保系统盘有至少2GB可用空间用于存放核心程序、日志、模型缓存文件三、第二阶段安装中核心初始化向导配置核心必做无论使用一键脚本、npm手动安装还是源码编译安装完成核心程序部署后都会进入onboard交互式初始化向导这是OpenClaw安装过程中最核心的配置环节决定了核心能力的可用性下面分步详解每一项配置。若安装完成后未自动进入向导手动执行以下命令启动推荐带–install-daemon参数自动配置后台守护进程openclaw onboard--install-daemon3.1 第一步安全风险告知与确认进入向导后终端首先会弹出Security安全风险提示明确OpenClaw具备系统脚本执行、文件读写、自动化操作的权限需用户确认知晓风险。操作按左右方向键选择YES回车确认即可进入下一步。避坑提示必须选择YES才能继续配置无其他选项该提示仅首次初始化出现后续修改配置不会重复弹出。3.2 第二步运行模式选择这一步决定了配置的复杂度向导提供2种模式按需选择即可模式选项核心特点适用人群推荐选择QuickStart快速启动一键生成默认配置仅需配置核心模型参数全程3步完成自动启用基础功能纯新手、首次试用、快速上手✅ 90%用户首选Custom自定义模式全量配置项开放可自定义端口、工作目录、权限档位、多模型配置等进阶用户、有定制化需求、二次开发新手不建议选择操作按上下方向键选中对应模式回车确认即可。避坑提示新手选择QuickStart模式即可所有自定义配置都可以后续在Web界面/配置文件中修改无需首次配置就选择自定义模式避免配置错误导致功能异常。3.3 第三步核心大模型接入配置重中之重这是OpenClaw的“大脑”配置直接决定AI智能体的理解能力、执行效果支持云端大模型和本地大模型两大类新手优先选择云端模型配置简单、无需占用本地硬件资源。3.3.1 云端大模型配置新手首选向导会列出所有支持的模型服务商包括OpenAI、Anthropic Claude、通义千问、智谱GLM、Kimi(Moonshot)、DeepSeek、字节豆包等主流平台按上下方向键选中你要使用的服务商回车确认。选择API密钥区域国内服务商选择cn区域海外服务商选择global区域回车确认。输入对应平台的API Key粘贴你在对应平台控制台生成的API密钥回车确认。选择默认使用的具体模型向导会自动列出该服务商下适配的模型推荐选择高速免费/低资费的大模型如qwen3.5-flash、glm-4.7-flash、Kimi K2.5、DeepSeek V3等选中后回车确认。模型连通性测试配置完成后向导会自动测试API连通性提示Model connection successful即为配置成功。配置避坑提示API Key请妥善保管仅在对应平台控制台生成不要泄露给他人避免被盗刷确保API Key有可用额度/免费额度否则会出现模型调用失败国内用户优先选择国内大模型无需代理网络更稳定避免出现请求超时可先选择Skip for now暂不配置后续在Web管理界面中添加多模型配置3.3.2 本地大模型配置进阶用户无网环境适用若你想实现完全本地化运行无需联网调用云端API可选择本地模型接入前提是提前安装好Ollama并下载对应本地大模型。模型服务商选择Ollama回车确认输入Ollama服务地址本地默认地址为http://127.0.0.1:11434直接回车确认即可选择已下载的本地模型如llama3、qwen2.5等回车确认向导自动测试本地模型连通性成功后即可完成配置。本地模型配置要求建议电脑运行内存≥16GBNVIDIA显卡显存≥8GB否则会出现模型加载慢、运行卡顿、闪退问题。3.4 第四步交互渠道Channels配置这一步配置OpenClaw的交互入口决定你可以通过哪些平台和AI智能体对话支持微信、飞书、钉钉、Telegram、企业微信等多个平台。新手操作直接选择Skip for now暂不配置回车进入下一步后续可在Web界面按需配置。进阶操作选中你要接入的平台按向导提示完成对应平台的Token、密钥、回调地址等配置即可完成接入。避坑提示交互渠道配置非首次安装必做项新手先完成核心配置确保服务正常运行后再按需接入避免配置过于复杂导致部署失败。3.5 第五步核心技能Skills与工具权限配置这一步决定OpenClaw能执行的操作范围是核心的权限配置项。向导询问是否启用核心基础技能选择Yes推荐回车确认。选择技能包安装工具默认选择npm直接回车确认即可。工具权限档位配置自定义模式下开放向导提供4个权限档位按需选择| 权限档位 | 文件读写 | 代码执行 | 消息发送 | 适用场景 ||----------|----------|----------|----------|----------|| minimal | ❌ 否 | ❌ 否 | ✅ 是 | 仅纯聊天对话不操作本地 || messaging | ❌ 否 | ❌ 否 | ✅ 是 | 多平台消息助手仅收发消息 || coding | ✅ 是 | ❌ 否 | ✅ 是 | 编程开发、文件读写处理 || full | ✅ 是 | ✅ 是 | ✅ 是 | 全功能自动化本地操作全覆盖 |推荐选择新手选择full全功能档位否则会出现文件操作、自动化执行功能缺失仅需聊天功能可选择minimal档位。避坑提示权限档位可后续在配置文件中修改修改后需重启网关服务才能生效。3.6 第六步后台守护进程与服务安装若你执行的是openclaw onboard --install-daemon命令向导最后一步会自动完成Windows系统后台守护进程的安装与配置实现开机自启电脑重启后OpenClaw网关服务自动启动无需手动执行命令后台常驻关闭终端窗口服务仍在后台正常运行不影响Web界面访问和自动化任务执行异常自动重启服务崩溃、异常退出时自动重启保障运行稳定性完成标志终端提示Gateway service installed、OpenClaw is running即代表安装与初始化核心配置全部完成。四、第三阶段安装完成后的进阶功能配置优化必做初始化配置完成后建议完成以下进阶配置提升服务安全性、稳定性解锁完整功能。4.1 网关服务核心配置OpenClaw的核心运行依赖Gateway网关服务需完成基础配置优化查看服务运行状态openclaw gateway status若提示Gateway is stopped执行启动命令openclaw gatewaystart配置服务开机自启若初始化未配置openclaw gateway install自定义服务端口与访问地址默认端口为18789默认仅本地可访问若需局域网内其他设备访问修改配置文件中的gateway.bind为0.0.0.0同时在Windows防火墙中放行对应端口。4.2 Web管理界面安全配置OpenClaw提供可视化Web管理界面默认无访问密码需配置安全防护避免未授权访问。执行以下命令自动打开Web管理界面openclaw dashboard浏览器会自动访问http://127.0.0.1:18789进入控制台。2. 进入【设置】-【安全设置】配置控制台登录用户名和密码开启访问令牌验证。3. 配置IP访问白名单仅允许指定IP地址访问控制台最大化保障本地服务安全。4.3 存储与日志配置工作目录配置默认工作目录为C:\Users\你的用户名\.openclaw所有配置文件、日志、长期记忆数据均存放在此若系统盘空间不足可在配置文件中修改workspace路径到其他磁盘。日志配置进入Web控制台【系统设置】配置日志保留时长、日志级别默认保留30天日志可按需调整避免占用过多磁盘空间。长期记忆配置开启长期记忆功能配置记忆存储路径让AI智能体可记住历史对话和操作习惯提升执行效果。五、进阶核心配置文件详解OpenClaw所有配置均保存在JSON配置文件中进阶用户可直接修改文件完成自定义配置Windows系统默认路径C:\Users\你的用户名\.openclaw\openclaw.json也可执行以下命令直接用系统默认编辑器打开配置文件openclaw config edit查看当前完整配置openclaw config show核心配置项结构说明{// 核心模型配置agents:{defaults:{model:qwen/qwen3.5-flash,// 默认使用的模型models:[qwen/*,deepseek/*]// 支持的模型列表}},// 工具权限配置tools:{profile:full// 权限档位minimal/messaging/coding/full},// 网关服务配置gateway:{bind:127.0.0.1,// 服务绑定地址0.0.0.0为局域网可访问port:18789// 服务端口},// 工作区配置workspace:{path:C:\\Users\\xxx\\.openclaw\\workspace,// 工作目录maxFileSize:10485760// 最大文件大小限制}}注意修改配置文件后必须执行openclaw gateway restart重启网关服务配置才能生效。六、配置结果验证必做完成所有配置后执行以下3步验证确保所有配置生效服务正常运行核心命令验证关闭原有终端重新以管理员身份打开PowerShell执行openclaw--version终端输出版本号说明全局命令配置正常环境变量生效。环境健康诊断执行官方内置诊断命令全面检查配置与环境是否存在异常openclaw doctor所有检测项均为pass说明配置无异常若有警告项按终端提示完成修复即可。服务与模型验证执行openclaw gateway status提示Gateway is running说明网关服务配置正常打开Web管理界面进入【模型管理】执行模型测试提示调用成功说明大模型配置生效七、高频配置报错与解决方案1. 初始化向导提示「模型连接失败」常见原因API Key错误、无可用额度、网络不通、区域选择错误解决方案核对API Key是否正确是否开启了对应模型的访问权限确认API账户有可用额度未欠费、未被限流国内模型关闭代理海外模型确认代理网络正常核对模型服务商的区域选择是否正确国内模型必须选cn区域2. 配置完成后提示「openclaw不是内部或外部命令」常见原因Node.js环境变量未生效、npm全局安装路径未加入系统Path、未重启终端解决方案关闭所有已打开的终端窗口重新以管理员身份打开PowerShell重试重新安装Node.js全程默认下一步自动配置环境变量安装完成后重启电脑手动将npm全局安装路径添加到系统环境变量Path中重启终端后再次验证3. 修改配置文件后配置不生效常见原因未重启网关服务、配置文件格式错误、JSON语法错误解决方案修改配置后必须执行openclaw gateway restart重启网关服务检查JSON配置文件语法确保括号、引号、逗号格式正确无语法错误执行openclaw config show查看当前生效的配置确认修改是否成功保存4. Web管理界面无法访问常见原因网关服务未启动、端口被占用、防火墙拦截、地址配置错误解决方案执行openclaw gateway start确保服务正常启动检查端口18789是否被其他程序占用可在配置文件中修改为其他未占用端口在Windows防火墙中放行对应端口关闭第三方杀毒软件的网络拦截局域网访问需将bind地址改为0.0.0.0使用部署设备的局域网IP访问