 Windows 安装完全指南)
OpenClaw (龙虾) Windows 安装完全指南 重要说明所有操作均在C:\Users\czd17目录下执行你的用户主目录最终稳定版本Node.js v22.14.0避免在C:\WINDOWS\system32下执行任何命令一、环境准备1. 安装 nvm-windows (Node版本管理器)下载地址https://github.com/coreybutler/nvm-windows/releases 下载文件nvm-setup.exe 安装方式双击安装全部默认选项2. 安装 Node.js v22.14.0# 安装指定版本nvm install 22.14.0# 切换到该版本nvm use 22.14.0# 验证版本node-v# 应显示 v22.14.0npm-v# 应显示 10.x⚠️踩坑提醒最初尝试 Node.js v20.18.0 失败OpenClaw强制要求 Node.js ≥22.12.0如果nvm install下载慢可用淘宝镜像手动下载 ZIP 放入 nvm 目录3. 配置 npm 国内镜像解决网络问题npm configsetregistry https://registry.npmmirror.com/二、安装 OpenClaw方法一一键安装脚本推荐iwr-useb https://openclaw.ai/install.ps1|iex⚠️踩坑提醒如果报错无法加载文件...禁止运行脚本先执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser方法二手动 npm 安装如果脚本失败# 设置环境变量跳过本地模型编译$env:NODE_LLAMA_CPP_SKIP_BINARY_DOWNLOADtrue$env:NODE_LLAMA_CPP_FORCE_NO_GPUtrue# 安装忽略编译脚本npm install-g openclawlatest--registryhttps://registry.npmmirror.com/--ignore-scripts⚠️踩坑提醒node-llama-cpp在 Windows 上编译容易失败用--ignore-scripts跳过跳过不影响使用云端 API如阿里云、DeepSeek三、配置与启动1. 安装网关服务只需一次openclaw gateway install2. 设置网关模式openclaw configsetgateway.mode local openclaw configsetgateway.port 18789⚠️踩坑提醒命令格式是openclaw config set key value不是--key--value如果命令报错可以直接修改配置文件notepad C:\Users\czd17\.openclaw\openclaw.json添加或修改为{gateway:{mode:local,port:18789}}3. 启动网关openclaw gatewaystart4. 查看访问地址和令牌openclaw dashboard浏览器访问显示的 URL例如http://127.0.0.1:18789/?token四、常用命令速查功能命令启动网关openclaw gateway start停止网关openclaw gateway stop重启网关openclaw gateway restart查看状态openclaw doctor查看实时日志openclaw logs follow查看配置openclaw config list设置配置openclaw config set key value获取配置openclaw config get key删除配置openclaw config delete key更新版本npm update -g openclawlatest前台运行调试openclaw gateway start --foreground五、验证成功运行的标志执行openclaw gateway start --foreground后看到类似日志11:15:26 [gateway] listening on ws://127.0.0.1:18789 11:15:26 [browser/server] Browser control listening on http://127.0.0.1:18791/浏览器能正常打开 dashboard 显示的 URL且界面可交互。六、常见问题与解决方案❌ 错误Cannot find module openclaw.mjs原因在错误目录执行命令如C:\WINDOWS\system32解决切换到用户目录cd C:\Users\czd17❌ 错误Node.js v22.12 is required (current: v20.18.0)原因Node.js 版本过低解决nvm install 22.14.0并nvm use 22.14.0❌ 错误npm error code 3221225477node-llama-cpp 崩溃原因本地模型编译失败解决npm install -g openclawlatest --ignore-scripts❌ 错误gitgithub.com: Permission denied原因依赖包尝试用 SSH 克隆解决git config--global url.https://github.com/.insteadOf gitgithub.com: git config--global url.https://.insteadOf git://❌ 浏览器访问显示“拒绝连接”原因网关服务未运行解决openclaw gateway start或openclaw gateway start --foreground查看错误❌ 配置文件修改不生效解决直接编辑C:\Users\czd17\.openclaw\openclaw.json后重启网关 最终确认清单Node.js 版本v22.14.0npm 镜像https://registry.npmmirror.com/OpenClaw 安装npm list -g openclaw网关服务openclaw gateway statusWeb 访问浏览器打开 dashboard URL提示首次使用需要在网页左下角设置中添加 AI 模型 API Key如阿里云百炼、DeepSeek 等之后就可以让“龙虾”帮你干活啦OpenClaw 配置过程总结 一、问题诊断阶段 初始错误⚠️ Agent failed before reply: No API key found for provider anthropic系统找不到 Anthropic API 密钥默认在寻找mainagent 的配置查看现有 agentsopenclaw agents list结果显示只有mainagent之前配置的czdzl没有成功创建。二、创建新 Agent 1. 创建名为czdzl的 agentopenclaw agentsaddczdzl2. 配置认证方式出现选项Z.AI auth method选择Coding-Plan-Global全球版或其他选项根据地域选择3. 配置 API 密钥出现提示How do you want to provide this API key?选择Paste API key now直接粘贴粘贴 Z.AI API 密钥4. 配置完成确认Model configured ---------------------------------- | | | Default model set to zai/glm-5 for agent czdzl. | | | -----------------------------------------------------三、聊天通道配置 出现提示Configure chat channels now?选项Yes/No选择No跳过后续可随时配置聊天通道选项列表✅ Telegram (Bot API) - 新手推荐✅ WhatsApp (QR link)✅ Discord (Bot API)✅ 飞书 (Feishu/Lark)以及其他20平台四、Web 界面访问 启动成功后显示的地址1. 主控制界面http://127.0.0.1:18789/ 2. Canvas画板http://127.0.0.1:18789/__openclaw__/canvas/ 3. 浏览器控制http://127.0.0.1:18791/需token五、切换 Agent 使用 方法1切换默认 agentopenclaw agents use czdzl方法2直接指定 agent 运行openclaw--agentczdzl ask你好六、配置文件路径 主配置目录C:\Users\czd17\.openclaw\agents\ - main agentC:\Users\czd17\.openclaw\agents\main\agent\ - czdzl agentC:\Users\czd17\.openclaw\agents\czdzl\agent\ - 认证文件auth-profiles.json七、常见问题及解决 ❓问题1Agent failed before reply错误No API key found for provider zai 解决复制配置或重新添加agentcopy C:\Users\czd17\.openclaw\agents\czdzl\agent\auth-profiles.json C:\Users\czd17\.openclaw\agents\main\agent\问题2切换agent不生效# 直接指定agent运行openclaw--agentczdzl ask问题问题3配置中断# 重新配置openclaw agentsaddczdzl# 或按 CtrlC 退出不影响已有配置八、最终验证 ✅命令行测试openclaw--agentczdzl ask你好Web界面测试打开http://127.0.0.1:18789/输入消息测试对话九、关键命令速查 功能命令查看agentsopenclaw agents list添加agentopenclaw agents add 名称切换agentopenclaw agents use 名称指定agent运行openclaw --agent 名称 ask 问题查看日志openclaw logs --follow查看版本openclaw --version十、注意事项 ⚠️API密钥安全不要分享给他人配置文件在.openclaw目录下聊天通道可后续随时配置不影响基本使用Web界面只能本地访问127.0.0.1agent切换如果use不生效直接用--agent参数配置完成现在可以通过命令行或Web界面正常使用 OpenClaw 了
OpenClaw (龙虾) Windows 安装完全指南
发布时间：2026/7/7 12:48:25
OpenClaw (龙虾) Windows 安装完全指南 重要说明所有操作均在C:\Users\czd17目录下执行你的用户主目录最终稳定版本Node.js v22.14.0避免在C:\WINDOWS\system32下执行任何命令一、环境准备1. 安装 nvm-windows (Node版本管理器)下载地址https://github.com/coreybutler/nvm-windows/releases 下载文件nvm-setup.exe 安装方式双击安装全部默认选项2. 安装 Node.js v22.14.0# 安装指定版本nvm install 22.14.0# 切换到该版本nvm use 22.14.0# 验证版本node-v# 应显示 v22.14.0npm-v# 应显示 10.x⚠️踩坑提醒最初尝试 Node.js v20.18.0 失败OpenClaw强制要求 Node.js ≥22.12.0如果nvm install下载慢可用淘宝镜像手动下载 ZIP 放入 nvm 目录3. 配置 npm 国内镜像解决网络问题npm configsetregistry https://registry.npmmirror.com/二、安装 OpenClaw方法一一键安装脚本推荐iwr-useb https://openclaw.ai/install.ps1|iex⚠️踩坑提醒如果报错无法加载文件...禁止运行脚本先执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser方法二手动 npm 安装如果脚本失败# 设置环境变量跳过本地模型编译$env:NODE_LLAMA_CPP_SKIP_BINARY_DOWNLOADtrue$env:NODE_LLAMA_CPP_FORCE_NO_GPUtrue# 安装忽略编译脚本npm install-g openclawlatest--registryhttps://registry.npmmirror.com/--ignore-scripts⚠️踩坑提醒node-llama-cpp在 Windows 上编译容易失败用--ignore-scripts跳过跳过不影响使用云端 API如阿里云、DeepSeek三、配置与启动1. 安装网关服务只需一次openclaw gateway install2. 设置网关模式openclaw configsetgateway.mode local openclaw configsetgateway.port 18789⚠️踩坑提醒命令格式是openclaw config set key value不是--key--value如果命令报错可以直接修改配置文件notepad C:\Users\czd17\.openclaw\openclaw.json添加或修改为{gateway:{mode:local,port:18789}}3. 启动网关openclaw gatewaystart4. 查看访问地址和令牌openclaw dashboard浏览器访问显示的 URL例如http://127.0.0.1:18789/?token四、常用命令速查功能命令启动网关openclaw gateway start停止网关openclaw gateway stop重启网关openclaw gateway restart查看状态openclaw doctor查看实时日志openclaw logs follow查看配置openclaw config list设置配置openclaw config set key value获取配置openclaw config get key删除配置openclaw config delete key更新版本npm update -g openclawlatest前台运行调试openclaw gateway start --foreground五、验证成功运行的标志执行openclaw gateway start --foreground后看到类似日志11:15:26 [gateway] listening on ws://127.0.0.1:18789 11:15:26 [browser/server] Browser control listening on http://127.0.0.1:18791/浏览器能正常打开 dashboard 显示的 URL且界面可交互。六、常见问题与解决方案❌ 错误Cannot find module openclaw.mjs原因在错误目录执行命令如C:\WINDOWS\system32解决切换到用户目录cd C:\Users\czd17❌ 错误Node.js v22.12 is required (current: v20.18.0)原因Node.js 版本过低解决nvm install 22.14.0并nvm use 22.14.0❌ 错误npm error code 3221225477node-llama-cpp 崩溃原因本地模型编译失败解决npm install -g openclawlatest --ignore-scripts❌ 错误gitgithub.com: Permission denied原因依赖包尝试用 SSH 克隆解决git config--global url.https://github.com/.insteadOf gitgithub.com: git config--global url.https://.insteadOf git://❌ 浏览器访问显示“拒绝连接”原因网关服务未运行解决openclaw gateway start或openclaw gateway start --foreground查看错误❌ 配置文件修改不生效解决直接编辑C:\Users\czd17\.openclaw\openclaw.json后重启网关 最终确认清单Node.js 版本v22.14.0npm 镜像https://registry.npmmirror.com/OpenClaw 安装npm list -g openclaw网关服务openclaw gateway statusWeb 访问浏览器打开 dashboard URL提示首次使用需要在网页左下角设置中添加 AI 模型 API Key如阿里云百炼、DeepSeek 等之后就可以让“龙虾”帮你干活啦OpenClaw 配置过程总结 一、问题诊断阶段 初始错误⚠️ Agent failed before reply: No API key found for provider anthropic系统找不到 Anthropic API 密钥默认在寻找mainagent 的配置查看现有 agentsopenclaw agents list结果显示只有mainagent之前配置的czdzl没有成功创建。二、创建新 Agent 1. 创建名为czdzl的 agentopenclaw agentsaddczdzl2. 配置认证方式出现选项Z.AI auth method选择Coding-Plan-Global全球版或其他选项根据地域选择3. 配置 API 密钥出现提示How do you want to provide this API key?选择Paste API key now直接粘贴粘贴 Z.AI API 密钥4. 配置完成确认Model configured ---------------------------------- | | | Default model set to zai/glm-5 for agent czdzl. | | | -----------------------------------------------------三、聊天通道配置 出现提示Configure chat channels now?选项Yes/No选择No跳过后续可随时配置聊天通道选项列表✅ Telegram (Bot API) - 新手推荐✅ WhatsApp (QR link)✅ Discord (Bot API)✅ 飞书 (Feishu/Lark)以及其他20平台四、Web 界面访问 启动成功后显示的地址1. 主控制界面http://127.0.0.1:18789/ 2. Canvas画板http://127.0.0.1:18789/__openclaw__/canvas/ 3. 浏览器控制http://127.0.0.1:18791/需token五、切换 Agent 使用 方法1切换默认 agentopenclaw agents use czdzl方法2直接指定 agent 运行openclaw--agentczdzl ask你好六、配置文件路径 主配置目录C:\Users\czd17\.openclaw\agents\ - main agentC:\Users\czd17\.openclaw\agents\main\agent\ - czdzl agentC:\Users\czd17\.openclaw\agents\czdzl\agent\ - 认证文件auth-profiles.json七、常见问题及解决 ❓问题1Agent failed before reply错误No API key found for provider zai 解决复制配置或重新添加agentcopy C:\Users\czd17\.openclaw\agents\czdzl\agent\auth-profiles.json C:\Users\czd17\.openclaw\agents\main\agent\问题2切换agent不生效# 直接指定agent运行openclaw--agentczdzl ask问题问题3配置中断# 重新配置openclaw agentsaddczdzl# 或按 CtrlC 退出不影响已有配置八、最终验证 ✅命令行测试openclaw--agentczdzl ask你好Web界面测试打开http://127.0.0.1:18789/输入消息测试对话九、关键命令速查 功能命令查看agentsopenclaw agents list添加agentopenclaw agents add 名称切换agentopenclaw agents use 名称指定agent运行openclaw --agent 名称 ask 问题查看日志openclaw logs --follow查看版本openclaw --version十、注意事项 ⚠️API密钥安全不要分享给他人配置文件在.openclaw目录下聊天通道可后续随时配置不影响基本使用Web界面只能本地访问127.0.0.1agent切换如果use不生效直接用--agent参数配置完成现在可以通过命令行或Web界面正常使用 OpenClaw 了
与value_counts()原理与选型指南)
 获取与实战)
