OpenClaw 最近这么火刚好趁着周末我也安装一个试试紧跟潮流。一、先确认你的环境必须满足1. 系统与硬件Windows 10 64 位内存 ≥ 4GB推荐 8GB磁盘可用 ≥ 5GB稳定网络2. 软件依赖已装 Node 可跳过OpenClaw 要求Node.js ≥ v22。检查当前 Node 版本打开PowerShell管理员执行node -v npm -v安装/升级 Node.js其实不需要自己升级后面安装openclaw时候会自动坚持环境它会帮你下载升级还是很智能的。二、一键安装 OpenClaw推荐最省事1. 以管理员身份打开 PowerShellWinX → 选择Windows PowerShell (管理员)或开始菜单搜索 PowerShell → 右键“以管理员身份运行”2. 执行官方安装脚本iwr -useb https://openclaw.ai/install.ps1 | iex脚本会自动检查 PowerShell 版本≥5.0检查/安装 Node.js 22检查/安装 Git全局安装openclaw配置环境变量运行openclaw doctor自检3. 验证安装openclaw --version出现版本号如2026.3.x即成功。三、初始化配置首次必做1. 运行初始化向导openclaw onboard --install-daemon按提示一路回车默认即可会让你选择模型服务商本地 Ollama / 云端 API网关模式本地 / 远程端口默认 18789聊天渠道飞书/微信等可选2. 启动服务# 启动网关默认端口 18789 openclaw gateway # 查看状态 openclaw status # 打开 Web 仪表盘 openclaw dashboard浏览器访问http://localhost:18789四、手动安装进阶适合定制1. 克隆源码git clone https://github.com/OpenClaw-Labs/OpenClaw.git cd OpenClaw2. 安装依赖用 pnpm 更快npm install -g pnpm pnpm install pnpm ui:build pnpm build3. 初始化并启动pnpm openclaw onboard --install-daemon pnpm openclaw gateway --port 18789五、常见问题与排错1. 执行脚本提示“策略禁止运行脚本”Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入Y确认再重新执行安装脚本。2. 安装卡在 node-gyp 编译# 安装 Windows 编译工具 npm install -g windows-build-tools3. 命令找不到 openclaw关闭所有 PowerShell 窗口重新打开手动添加 PATH此电脑 → 右键属性 → 高级系统设置 → 环境变量在用户变量 Path 中添加%APPDATA%\npm重启终端4. 国内网络慢# 切换 npm 淘宝镜像 npm config set registry https://registry.npmmirror.com六、安装完成后做什么打开 Web 面板openclaw dashboard配置你的大模型本地 Ollama 或 API Key开始用 OpenClaw 做自动化任务Win10 Node 环境下 OpenClaw 常用命令速查手册一、安装 自检# 一键安装 iwr -useb https://openclaw.ai/install.ps1 | iex # 查看版本 openclaw --version # 环境自检排查问题必用 openclaw doctor二、初始化 配置# 首次初始化向导 openclaw onboard # 只重置配置不删数据 openclaw config reset三、启动 运行# 启动核心网关Web 面板 API openclaw gateway # 后台守护进程关闭终端也不挂 openclaw daemon start # 停止后台 openclaw daemon stop # 重启 openclaw daemon restart四、面板 状态# 直接打开 Web 仪表盘 openclaw dashboard # 查看运行状态 openclaw status # 查看日志 openclaw logs五、模型相关# 列出支持的模型 openclaw model list # 拉取模型 openclaw model pull 模型名 # 删除模型 openclaw model remove 模型名六、常见排错命令# 修复权限/脚本禁止运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser # 切淘宝 npm 镜像解决安装慢/失败 npm config set registry https://registry.npmmirror.com # 重装依赖 npm install -g openclaw --force七、升级 卸载# 升级 npm update -g openclaw # 完整卸载 npm uninstall -g openclawOpenClaw API模式完整配置文档Win10Node环境文档适用场景已在Win10系统完成OpenClaw安装已解决iwr命令执行失败问题、搭载合规Node.js环境需对接云端大模型API不依赖本地模型部署主打轻量化快速使用。核心前提OpenClaw已安装成功、拥有目标平台有效的API密钥、终端为管理员权限PowerShell。一、配置前准备工作1.1 环境自检必做先确认OpenClaw安装正常、环境无异常避免后续配置报错打开管理员权限PowerShell依次执行以下命令# 查看OpenClaw版本确认安装成功 openclaw --version # 环境全面自检排查依赖、权限、端口占用问题 openclaw doctor # 停止可能正在运行的本地网关进程防止端口冲突 openclaw daemon stop自检通过标准无红色报错提示版本号正常显示端口18789默认未被占用。1.2 API密钥获取须知API模式需提前在对应大模型平台申请密钥注意区分Secret Key/API Key复制时避免携带空格、换行等多余字符国内平台优先选择豆包API无需代理即可使用OpenAI等海外平台需配置网络代理否则会出现连接超时。二、主流大模型API配置步骤成品命令直接复用以下配置均为一键命令式操作无需手动修改配置文件替换命令中的【你的API密钥】即可直接执行按平台分类整理适配绝大多数用户需求。2.1 豆包API配置国内首选无代理要求豆包API国内访问稳定免费额度充足适配日常基础使用是Win10用户最优选择。2.1.1 密钥获取渠道访问火山方舟控制台https://console.volcengine.com/ark/region:ark-cn-beijing/apikey登录账号后创建API密钥复制Secret Key备用。点击这里的API介入按钮登录实名后复制API这个是需要付费token的好像阿里的千问有免费token可以去看看免费token量肯定是不能大的只能测试用。。2.1.2 完整配置命令# 配置默认大模型提供商为豆包 openclaw config set --key llm.default.provider --value doubao # 填入复制的豆包Secret Key openclaw config set --key llm.default.apiKey --value 你的豆包Secret Key # 配置豆包API官方请求地址 openclaw config set --key llm.default.baseUrl --value https://ark.cn-beijing.volces.com/api/v3 # 设置默认调用模型doubao-pro为通用版可按需更换 openclaw config set --key llm.default.model --value doubao-pro # 启动OpenClaw网关服务 openclaw gateway # 测试API连通性验证配置是否生效 openclaw llm test --provider doubao2.2 DeepSeek API配置高性价比国内可直连2.2.1 密钥获取渠道访问DeepSeek平台https://platform.deepseek.com/api_keys注册登录后创建API密钥并复制。2.2.2 完整配置命令# 配置提供商为DeepSeek openclaw config set --key llm.default.provider --value deepseek # 填入DeepSeek API密钥 openclaw config set --key llm.default.apiKey --value 你的DeepSeek API密钥 # 配置官方API地址 openclaw config set --key llm.default.baseUrl --value https://api.deepseek.com # 设置默认模型deepseek-chat为通用对话模型 openclaw config set --key llm.default.model --value deepseek-chat # 启动网关并测试 openclaw gateway openclaw llm test --provider deepseek2.3 OpenAI API配置海外模型需代理2.3.1 密钥获取与前置要求访问OpenAI平台https://platform.openai.com/api-keys 创建密钥国内用户需提前开启网络代理记录代理地址常规为http://127.0.0.1:7890。2.3.2 完整配置命令# 配置提供商为OpenAI openclaw config set --key llm.default.provider --value openai # 填入OpenAI API Key openclaw config set --key llm.default.apiKey --value 你的OpenAI API密钥 # 设置默认模型gpt-3.5-turbo性价比最高 openclaw config set --key llm.default.model --value gpt-3.5-turbo # 配置本地代理地址根据自身代理端口修改 openclaw config set --key network.proxy --value http://127.0.0.1:7890 # 启动网关并测试 openclaw gateway openclaw llm test --provider openai三、配置验证与启动管理3.1 配置生效验证命令验证执行对应平台的openclaw llm test --provider 平台标识命令出现“测试成功”提示代表API密钥、地址配置无误。面板验证执行openclaw dashboard命令自动打开浏览器Web仪表盘登录后可在模型设置页查看当前API配置状态正常加载模型列表即为成功。状态查看执行openclaw status查看网关运行状态、API连接状态无异常报错即可正常使用。3.2 服务后台运行关闭终端不退出默认openclaw gateway命令关闭终端后服务会停止如需后台常驻执行以下命令# 启动后台守护进程 openclaw daemon start # 重启后台服务配置修改后需执行 openclaw daemon restart # 停止后台服务 openclaw daemon stop # 查看实时运行日志 openclaw logs四、API配置常见问题与排错必看注意事项核心注意事项API密钥严格区分大小写复制时切勿多复制空格、换行配置完成后若修改密钥或模型必须重启网关服务才会生效海外平台API务必配置正确代理否则会提示连接超时、密钥无效。4.1 常见报错及解决方案报错密钥无效/认证失败重新核对API密钥是否复制正确确认平台账号已完成实名认证、有可用额度部分平台新密钥需等待1-2分钟生效。报错连接超时/无法访问API地址国内平台检查网络是否正常海外平台确认代理地址和端口配置正确可执行ping 对应API域名测试网络连通性。报错端口18789被占用执行netstat -ano | findstr 18789找到占用进程关闭对应程序或启动时指定端口openclaw gateway --port 自定义端口。报错命令无法识别openclaw关闭所有PowerShell终端重新打开管理员权限终端环境变量会自动加载若仍无效手动将npm路径添加到系统环境变量。4.2 配置修改与重置# 查看当前全部API配置 openclaw config get llm.default # 切换默认模型无需重新配置密钥 openclaw config set --key llm.default.model --value 新模型名称 # 重置所有LLM配置配置混乱时使用 openclaw config reset llm # 重置全部配置慎用会清空所有自定义设置 openclaw config reset五、API模式常用命令速查命令内容功能说明openclaw llm test --provider 平台名测试对应平台API连通性openclaw dashboard快速打开Web管理面板openclaw status查看服务与API运行状态openclaw daemon start后台启动服务关闭终端不退出openclaw config get llm.default查看当前API配置详情不同的人用不同的玩儿法多动手试试吧。