OpenClaw 是一款灵活的AI智能体工具支持对接各类大模型本地/云端本文详细讲解全平台安装、配置流程以及Windows环境下的常见踩坑解决方案。一、环境准备核心依赖OpenClaw 基于 Node.js 运行需先安装Node.js 22.x LTS版本关键必须LTS版本避免兼容性问题。二、分平台安装步骤1. macOS 安装步骤1安装 Node.js从 Node.js 官网 下载 22.x LTS 版本安装包按引导完成安装。终端验证安装node--version# 输出 v22.x.x 即为成功npm--version# 输出对应版本号步骤2安装 OpenClawnpminstall-gopenclawlatest--registryhttps://registry.npmmirror.com验证安装openclaw--version# 输出版本号如 2026.3.2即为成功2. Windows 安装重点步骤1安装 Node.js从官网下载 22.x LTS 版本.msi安装包全程默认下一步即可建议勾选「添加到PATH」。验证安装打开CMD执行node --version确认版本。步骤2安装 OpenClaw必须以管理员身份打开 CMD/PowerShell右键开始菜单 → 选择「管理员: Windows PowerShell」npminstall-gopenclawlatest--registryhttps://registry.npmmirror.com若遇权限错误确认管理员身份或执行npm config set prefix C:\Users\你的用户名\AppData\Roaming\npm重新配置npm路径。验证安装openclaw --version。3. 云服务器Linux安装步骤1服务器基础配置购买Linux服务器CentOS/Ubuntu均可防火墙开放 22SSH、18789OpenClaw网关端口。通过SSH连接服务器更新系统# Ubuntuaptupdateaptupgrade-y# CentOSyum update-y步骤2安装 Node.js 22# 安装nvmNode版本管理器更稳定curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bashsource~/.bashrc# 安装Node.js 22 LTSnvminstall22nvm use22步骤3安装 OpenClawnpminstall-gopenclawlatest--registryhttps://registry.npmmirror.com openclaw--version# 验证三、交互式配置向导关键执行以下命令启动配置向导Windows需管理员身份openclaw onboard --install-daemon配置步骤全平台通用安全警告确认界面显示OpenClaw安全提示beta版、权限风险等选择Yes继续本地使用风险极低。初始化模式选QuickStart快速开始后续可通过openclaw configure改配置。现有配置处理若提示「Existing config detected」选Use existing values保留现有配置。模型/授权服务商选择对接云端模型如MiniMax/Kimi/OpenAI选对应服务商填写真实API Key对接本地模型如Ollama先选任意云端模型如MiniMax占位后续改配置文件见下文。API Key 提供方式选Paste API key now随便填字符串本地Ollama无需真实Key仅用于过验证。聊天渠道配置选Skip for now暂时跳过Telegram/WhatsApp等渠道本地使用无需配置。技能配置选No跳过技能安装后续需要再装。钩子功能配置选Skip for now跳过扩展钩子新手无需配置。四、Windows 环境常见问题及解决踩坑实录问题1配置向导按回车无反应现象选中Skip for now后按回车界面无任何变化。原因命令行交互界面需先「选中选项」再提交而非直接回车。解决用方向键↑/↓将光标移到目标选项如Skip for now按空格打勾选项前出现[x]再按回车提交。问题2Gateway服务启动失败核心现象执行openclaw status提示Gateway: unreachable (connect failed: connect ECONNREFUSED 127.0.0.1:18789) Gateway service: Scheduled Task installed · missing · unknown (系统找不到指定文件)原因Windows计划任务适配问题OpenClaw默认的服务安装命令失效。解决放弃系统服务方式手动启动网关# 1. 直接启动网关窗口保持打开关闭则网关停止openclaw gateway run# 2. 新开CMD窗口启动仪表盘openclaw dashboard问题3Dashboard自动打开失败现象执行openclaw dashboard提示「Copied to clipboard. Opened in your browser.」但浏览器无反应。原因Windows浏览器默认设置未关联OpenClaw自动调起失败。解决手动复制提示中的URL如http://127.0.0.1:18789/#tokenxxx到浏览器地址栏直接访问即可。五、对接本地Ollama模型进阶若需对接本地Ollama需修改配置文件找到配置文件路径C:\Users\你的用户名\.openclaw\openclaw.jsonWindows用记事本打开替换model段落model:{provider:openai,name:llama3,// 你的Ollama模型名如qwen2/phi3apiBase:http://localhost:11434/v1,// Ollama的OpenAI兼容接口apiKey:ollama-local// 随便填Ollama不验证}保存后重启网关关闭之前的网关窗口重新执行openclaw gateway run。六、访问Web Dashboard本地部署直接访问http://127.0.0.1:18789云服务器部署需配置反向代理/端口映射或直接访问http://服务器IP:18789确保18789端口开放。如果本文对你有帮助欢迎点赞收藏如有其他问题评论区交流