OpenClaw 安装配置全记录

OpenClaw 安装配置全记录 前言本文档记录了在 Windows 环境下安装和配置 OpenClaw 的全过程包括遇到的问题、解决方案。希望能帮助其他遇到类似问题的朋友。一、环境准备1.1 系统要求操作系统Windows 10/11Node.js22.x 或更高版本推荐 v24网络能够访问 DeepSeek API国内网络通常没问题1.2 安装方式选择OpenClaw 在 Windows 上有三种安装方式方式优点缺点推荐度WSL2 Ubuntu最稳定问题最少需要安装子系统⭐⭐⭐ 长期使用首选Windows PowerShell直接安装不用重启容易遇到权限问题⭐⭐ 适合尝鲜CMD简单直接功能受限⭐ 不推荐我选择了PowerShell 直接安装方案二虽然遇到了一些问题但最终都解决了。二、安装过程及问题解决2.1 第一阶段基础安装❌ 问题1iwr不是内部命令现象iwr:无法将iwr项识别为 cmdlet、函数、脚本文件或可运行程序的名称原因在 CMD 中运行了 PowerShell 的命令。✅ 解决方案以管理员身份打开 PowerShell先设置执行策略Set-ExecutionPolicyRemoteSigned-ScopeProcess-Force再运行安装命令iwr-useb https://openclaw.ai/install.ps1|iex❌ 问题2npm error code 128现象npmerror code128npmerror gitgithub.com: Permission denied(publickey)原因npm 试图通过 SSH 访问 GitHub但 Windows 的 SSH 认证失败。✅ 解决方案使用国内镜像源安装npm configsetregistry https://registry.npmmirror.com npm install-g openclawlatest--registryhttps://registry.npmmirror.com2.2 第二阶段基础配置安装成功后运行初始化向导openclaw onboard 配置项选择建议配置项我的选择说明频道 (Channel)Skip for now先测试核心功能以后再配聊天软件技能 (Skills)只选核心的几个clawhub、summarize、githubskill-vetter需要单独装HooksSkip for now高级功能新手先跳过2.3 第三阶段配置 DeepSeek 模型❌ 问题3配置文件找不到 DeepSeek现象Unknown model: deepseek/deepseek-chat根本原因配置文件中缺少models.providers部分只有模型名没有模型配置。✅ 解决方案手动编辑配置文件C:\Users\Administrator\.openclaw\openclaw.json添加完整的 DeepSeek 配置{agents:{defaults:{model:{primary:deepseek/deepseek-chat},models:{deepseek/deepseek-chat:{alias:DeepSeek}}}},models:{providers:{deepseek:{baseUrl:https://api.deepseek.com/v1,apiKey:你的DeepSeek API密钥,api:openai-completions,models:[{id:deepseek-chat,name:DeepSeek Chat}]}}}}关键点baseUrl必须以/v1结尾api字段必须是openai-completions模型需要在agents.defaults.models和models.providers两处都配置❌ 问题4模型状态为missing现象openclaw models list# 输出deepseek/deepseek-chat missing原因模型在白名单中但 provider 配置缺失。✅ 验证方法配置正确后运行openclaw models list应该看到状态变为configured。❌ 问题5LLM request timed out现象配置好后提问一直显示超时。原因排查API Key 是否正确用 curl 测试Base URL 格式是否正确必须是/v1结尾网关是否重启修改配置后必须重启✅ 解决方案# 重启网关使配置生效openclaw gateway restart# 测试连接openclaw ask你好三、最终成功配置3.1 完整的配置文件经过多次调整最终可用的完整配置如下{meta:{lastTouchedVersion:2026.3.8,lastTouchedAt:2026-03-10T10:01:41.400Z},wizard:{lastRunAt:2026-03-10T10:01:41.394Z,lastRunVersion:2026.3.8,lastRunCommand:onboard,lastRunMode:local},auth:{profiles:{openai:default:{provider:openai,mode:api_key}}},agents:{defaults:{model:{primary:deepseek/deepseek-chat},models:{openai/gpt-5.1-codex:{alias:GPT},deepseek/deepseek-chat:{alias:DeepSeek}},workspace:C:\\Users\\Administrator\\.openclaw\\workspace,compaction:{mode:safeguard},maxConcurrent:4,subagents:{maxConcurrent:8}}},models:{providers:{deepseek:{baseUrl:https://api.deepseek.com/v1,apiKey:你的DeepSeek API密钥,api:openai-completions,models:[{id:deepseek-chat,name:DeepSeek Chat}]}}},gateway:{port:18789,mode:local,bind:loopback,auth:{mode:token,token:你的网关token}},skills:{install:{nodeManager:npm}}}3.2 验证成功的命令# 1. 查看模型列表deepseek应显示configuredopenclaw models list# 2. 测试对话openclaw ask你好能听到我吗# 3. 进入TUI交互界面openclaw tui四、常见问题速查表问题现象可能原因解决方案iwr不是内部命令在 CMD 中运行 PowerShell 命令改用 PowerShellnpm error code 128Git SSH 认证失败换国内镜像源安装Unknown modelprovider 配置缺失添加models.providers部分模型状态为missing有模型名无 provider补全 provider 配置LLM request timed outAPI Key 错误/网络不通/配置格式错检查 Key、Base URL重启网关网关连不上端口占用/服务未启动openclaw gateway restart五、扩展配置浏览器控制5.1 安装 Chrome 扩展搜索并安装“OpenClaw Browser Relay for Chrome”5.2 获取连接信息Gateway URL: ws://127.0.0.1:18789 Token: 从配置文件获取gateway.auth.token5.3 验证连接扩展显示已连接后就可以让 AI 操作浏览器了。六、经验总结配置文件是关键OpenClaw 的配置中心化很多问题都源于配置不完整两处都要配模型需要在agents.defaults.models白名单和models.providers实际配置都出现格式要准确DeepSeek 的baseUrl必须带/v1api必须是openai-completions重启大法好任何配置修改后都要openclaw gateway restart日志遇到问题先看openclaw logs --follow