最近有小伙伴联系小白想在Windows电脑上部署OpenClaw配置通义千问大模型。今天就来写一篇超详细的教程手把手教你完成每一步。本教程包含内容在Windows电脑上安装OpenClaw配置通义千问大模型01准备工作1.1 系统要求小白大概阅读了一下OpenClaw的配置要求目前比较好的配置大概是这个项目要求操作系统Windows 10/1164位内存8GB以上推荐16GB硬盘至少10GB可用空间网络能访问互联网当然如果内存达不到8GB也没关系但建议至少要有4GB。1.2 需要准备的账号通义千问API访问阿里云DashScope注册并获取API Key可选飞书机器人访问飞书开放平台创建企业自建应用注意本教程以Windows 10为例Windows 11步骤类似。建议使用管理员账户操作。1.3 整体配置流程流程比较繁杂需要安装完成清单如下Node.js v22 已安装Git 已安装OpenClaw 已安装Gateway 已配置并启动通义千问API已配置Dashboard可正常访问安装完成上面的内容之后AI对话功能才能正常进行。02安装Node.jsOpenClaw需要Node.js运行环境版本要求22.0.0以上因此一开始就需要先配置Node.js。打开浏览器访问Node.js官网点击【获取Node.js】https://nodejs.org/点击下【Windows 安装程序(.msi)】双击下载的msi文件一路点击Next即可使用默认设置小白提示安装路径建议使用默认路径不要修改。安装成功之后在开始菜单点击【鼠标右键】-【终端管理员】或者【Windows PowerShell管理员】输入以下命令验证node --version如果显示版本高于v22.14.0说明安装成功。再验证npmnpm --version此时应该显示类似11.9.0的版本号如果出现一屏幕的红字……则先复制粘贴下面内容回车会提示执行策略更改输入【y】回车。Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser再执行【npm --version】这样就可以继续下一步了。03安装GitOpenClaw的部分依赖需要通过Git下载。访问Git官网Git官网https://git-scm.com/download/win或使用国内镜像更快https://mirrors.huaweicloud.com/git-for-windows/下载合适的版本如果Git安装文件无法下载则在公众号后台回复【CLAW】获取。双击下载的安装文件一路点击Next使用默认设置即可安装成功之后关闭PowerShell再重新打开PowerShell输入git --version如果显示git version 2.53.0.windows.2说明安装成功。04设置PowerShell执行策略Windows默认禁止运行脚本需要修改执行策略。这里关闭PowerShell然后再重新打开PowerShell管理员输入以下命令并按回车Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser当提示确认时输入Y并按回车这样就可以了。05安装OpenClaw小白测试到在国内访问npm官方源较慢建议配置国内镜像npm config set registry https://registry.npmmirror.com接着在PowerShell中输入npm install -g openclaw等待安装完成可能需要几分钟。小白提示如果安装过程中出现警告warning可以忽略不影响使用。只要没有报错error就行。如果出现error通常是网络问题无法连接到GitHub。国内访问GitHub经常超时。解决方法一分别执行下面两条命令使配置Git使用HTTPS代替SSHgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/git config --global url.https://github.com/.insteadOf gitgithub.com:然后再执行一次下面内容npm install -g openclaw等待……出现【added xxx packages in 1m】即可复制下面内容粘贴过去回车openclaw --version应该显示类似OpenClaw 2026.3.13的版本号此时就可以了。06配置GatewayGateway是OpenClaw的网关服务负责处理外部请求没安装好无法访问OpenClaw的。复制下面内容粘贴回车openclaw config set gateway.mode local接着设置局域网访问设置为lan模式openclaw config set gateway.bind lan再设置一个安全的Token用于访问Gateway时认证openclaw config set gateway.auth.token 你的密码比如openclaw config set gateway.auth.token xiaobaidn117小白提示Token相当于密码建议设置复杂一些且建议大小写数字。接着安装网关服务复制粘贴回车之后会出现一个openclaw-gateway的黑框不用关闭。openclaw gateway install接着启动Gateway复制粘贴回车之后之前的黑框的关闭再弹出另外一个窗口openclaw gateway start启动后Gateway会在后台运行监听18789端口。最后检查Gateway状态openclaw gateway status这样就可以了。打开浏览器输入【localhost:18789】回车网关令牌填写刚刚设置的token小白这里是【xiaobaidn117】密码留空点击【连接】这就进来了。07配置通义千问大模型这是最重要的一步配置AI模型。这里咱们获取通义千问API Key。访问阿里云DashScope控制台https://dashscope.console.aliyun.com/登录之后点击左侧【API-KEY管理】-【创建新的API-KEY】复制生成的API Key格式类似sk-xxxxxxxxxxxxxxxx注意API Key只显示一次请务必保存好不要泄露给他人配置文件位置C:\Users\你的用户名\.openclaw\openclaw.json修改之前记得做一下文件备份。在配置文件中添加以下内容如果文件为空直接粘贴{models: {mode: merge,providers: {qwen: {baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey: ${QWEN_API_KEY},api: openai-completions,models: [{id: qwen-max, name: Qwen Max, contextWindow: 128000, maxTokens: 8192},{id: qwen-plus, name: Qwen Plus, contextWindow: 128000, maxTokens: 8192},{id: qwen-turbo, name: Qwen Turbo, contextWindow: 128000, maxTokens: 8192}]}}},env: {QWEN_API_KEY: sk-0fxxxxxxxxxxe//替换成你自己的API},agents: {defaults: {model: {primary: qwen/qwen-max,fallbacks: [qwen/qwen-plus, qwen/qwen-turbo]}}}小白提示把你的API Key替换成你刚才复制的通义千问API Key。搞定之后保存一下文件不知道怎么修改的可以在后台回复【CLAW】获取文件然后重启Gateway使配置生效openclaw gateway restart如果执行之后出现错误请按【Ctrl】【C】中断。接着依次执行下面命令openclaw gateway stopopenclaw gateway start弹出了窗口且没有闪退即可这个窗口不能关09访问Dashboard接着访问【localhost:18789】输入token登录到这个界面就可以发个消息给OpenClaw看看行不行了。这样就完成了接下来就是配置飞书。飞书只要获取到APP ID和APP Secret两个码发给OpenClaw让它自行配置。教程太长了下次讲10常见问题解决问题1npm install报错错误npm ERR! network timeout解决配置国内镜像源npm config set registry https://registry.npmmirror.com问题2Gateway启动失败错误Gateway start blocked解决设置gateway.modeopenclaw config set gateway.mode local问题3手机访问提示origin not allowed错误control ui requires device identity解决在配置文件中添加controlUi: { dangerouslyAllowHostHeaderOriginFallback: true }问题4PowerShell脚本执行被禁止错误running scripts is disabled on this system解决设置执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser问题5端口被占用错误Port 18789 is already in use解决查看占用端口的进程并结束netstat -ano | findstr 18789 taskkill /PID 进程ID /F11验证安装成功1、测试AI对话打开Dashboard在聊天框输入你好请介绍一下你自己如果AI正常回复说明通义千问配置成功2、查看配置状态openclaw status应该显示Gateway状态、模型配置等信息。12常用命令汇总命令说明openclaw --version查看版本openclaw status查看状态openclaw gateway status查看Gateway状态openclaw gateway start启动Gatewayopenclaw gateway stop停止Gatewayopenclaw gateway restart重启Gatewayopenclaw config get查看配置openclaw config validate验证配置openclaw logs --follow查看日志13安全建议⚠️ 重要安全提示设置强TokenGateway的Token要设置复杂密码不要暴露到公网除非有安全防护否则不要把18789端口暴露到公网保护API Key通义千问API Key不要泄露不要上传到GitHub等公开平台定期更新定期运行npm update -g openclaw更新OpenClaw--End--内容好长……
Windows安装OpenClaw完整教程，小白轻松上手
最近有小伙伴联系小白想在Windows电脑上部署OpenClaw配置通义千问大模型。今天就来写一篇超详细的教程手把手教你完成每一步。本教程包含内容在Windows电脑上安装OpenClaw配置通义千问大模型01准备工作1.1 系统要求小白大概阅读了一下OpenClaw的配置要求目前比较好的配置大概是这个项目要求操作系统Windows 10/1164位内存8GB以上推荐16GB硬盘至少10GB可用空间网络能访问互联网当然如果内存达不到8GB也没关系但建议至少要有4GB。1.2 需要准备的账号通义千问API访问阿里云DashScope注册并获取API Key可选飞书机器人访问飞书开放平台创建企业自建应用注意本教程以Windows 10为例Windows 11步骤类似。建议使用管理员账户操作。1.3 整体配置流程流程比较繁杂需要安装完成清单如下Node.js v22 已安装Git 已安装OpenClaw 已安装Gateway 已配置并启动通义千问API已配置Dashboard可正常访问安装完成上面的内容之后AI对话功能才能正常进行。02安装Node.jsOpenClaw需要Node.js运行环境版本要求22.0.0以上因此一开始就需要先配置Node.js。打开浏览器访问Node.js官网点击【获取Node.js】https://nodejs.org/点击下【Windows 安装程序(.msi)】双击下载的msi文件一路点击Next即可使用默认设置小白提示安装路径建议使用默认路径不要修改。安装成功之后在开始菜单点击【鼠标右键】-【终端管理员】或者【Windows PowerShell管理员】输入以下命令验证node --version如果显示版本高于v22.14.0说明安装成功。再验证npmnpm --version此时应该显示类似11.9.0的版本号如果出现一屏幕的红字……则先复制粘贴下面内容回车会提示执行策略更改输入【y】回车。Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser再执行【npm --version】这样就可以继续下一步了。03安装GitOpenClaw的部分依赖需要通过Git下载。访问Git官网Git官网https://git-scm.com/download/win或使用国内镜像更快https://mirrors.huaweicloud.com/git-for-windows/下载合适的版本如果Git安装文件无法下载则在公众号后台回复【CLAW】获取。双击下载的安装文件一路点击Next使用默认设置即可安装成功之后关闭PowerShell再重新打开PowerShell输入git --version如果显示git version 2.53.0.windows.2说明安装成功。04设置PowerShell执行策略Windows默认禁止运行脚本需要修改执行策略。这里关闭PowerShell然后再重新打开PowerShell管理员输入以下命令并按回车Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser当提示确认时输入Y并按回车这样就可以了。05安装OpenClaw小白测试到在国内访问npm官方源较慢建议配置国内镜像npm config set registry https://registry.npmmirror.com接着在PowerShell中输入npm install -g openclaw等待安装完成可能需要几分钟。小白提示如果安装过程中出现警告warning可以忽略不影响使用。只要没有报错error就行。如果出现error通常是网络问题无法连接到GitHub。国内访问GitHub经常超时。解决方法一分别执行下面两条命令使配置Git使用HTTPS代替SSHgit config --global url.https://github.com/.insteadOf ssh://gitgithub.com/git config --global url.https://github.com/.insteadOf gitgithub.com:然后再执行一次下面内容npm install -g openclaw等待……出现【added xxx packages in 1m】即可复制下面内容粘贴过去回车openclaw --version应该显示类似OpenClaw 2026.3.13的版本号此时就可以了。06配置GatewayGateway是OpenClaw的网关服务负责处理外部请求没安装好无法访问OpenClaw的。复制下面内容粘贴回车openclaw config set gateway.mode local接着设置局域网访问设置为lan模式openclaw config set gateway.bind lan再设置一个安全的Token用于访问Gateway时认证openclaw config set gateway.auth.token 你的密码比如openclaw config set gateway.auth.token xiaobaidn117小白提示Token相当于密码建议设置复杂一些且建议大小写数字。接着安装网关服务复制粘贴回车之后会出现一个openclaw-gateway的黑框不用关闭。openclaw gateway install接着启动Gateway复制粘贴回车之后之前的黑框的关闭再弹出另外一个窗口openclaw gateway start启动后Gateway会在后台运行监听18789端口。最后检查Gateway状态openclaw gateway status这样就可以了。打开浏览器输入【localhost:18789】回车网关令牌填写刚刚设置的token小白这里是【xiaobaidn117】密码留空点击【连接】这就进来了。07配置通义千问大模型这是最重要的一步配置AI模型。这里咱们获取通义千问API Key。访问阿里云DashScope控制台https://dashscope.console.aliyun.com/登录之后点击左侧【API-KEY管理】-【创建新的API-KEY】复制生成的API Key格式类似sk-xxxxxxxxxxxxxxxx注意API Key只显示一次请务必保存好不要泄露给他人配置文件位置C:\Users\你的用户名\.openclaw\openclaw.json修改之前记得做一下文件备份。在配置文件中添加以下内容如果文件为空直接粘贴{models: {mode: merge,providers: {qwen: {baseUrl: https://dashscope.aliyuncs.com/compatible-mode/v1,apiKey: ${QWEN_API_KEY},api: openai-completions,models: [{id: qwen-max, name: Qwen Max, contextWindow: 128000, maxTokens: 8192},{id: qwen-plus, name: Qwen Plus, contextWindow: 128000, maxTokens: 8192},{id: qwen-turbo, name: Qwen Turbo, contextWindow: 128000, maxTokens: 8192}]}}},env: {QWEN_API_KEY: sk-0fxxxxxxxxxxe//替换成你自己的API},agents: {defaults: {model: {primary: qwen/qwen-max,fallbacks: [qwen/qwen-plus, qwen/qwen-turbo]}}}小白提示把你的API Key替换成你刚才复制的通义千问API Key。搞定之后保存一下文件不知道怎么修改的可以在后台回复【CLAW】获取文件然后重启Gateway使配置生效openclaw gateway restart如果执行之后出现错误请按【Ctrl】【C】中断。接着依次执行下面命令openclaw gateway stopopenclaw gateway start弹出了窗口且没有闪退即可这个窗口不能关09访问Dashboard接着访问【localhost:18789】输入token登录到这个界面就可以发个消息给OpenClaw看看行不行了。这样就完成了接下来就是配置飞书。飞书只要获取到APP ID和APP Secret两个码发给OpenClaw让它自行配置。教程太长了下次讲10常见问题解决问题1npm install报错错误npm ERR! network timeout解决配置国内镜像源npm config set registry https://registry.npmmirror.com问题2Gateway启动失败错误Gateway start blocked解决设置gateway.modeopenclaw config set gateway.mode local问题3手机访问提示origin not allowed错误control ui requires device identity解决在配置文件中添加controlUi: { dangerouslyAllowHostHeaderOriginFallback: true }问题4PowerShell脚本执行被禁止错误running scripts is disabled on this system解决设置执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser问题5端口被占用错误Port 18789 is already in use解决查看占用端口的进程并结束netstat -ano | findstr 18789 taskkill /PID 进程ID /F11验证安装成功1、测试AI对话打开Dashboard在聊天框输入你好请介绍一下你自己如果AI正常回复说明通义千问配置成功2、查看配置状态openclaw status应该显示Gateway状态、模型配置等信息。12常用命令汇总命令说明openclaw --version查看版本openclaw status查看状态openclaw gateway status查看Gateway状态openclaw gateway start启动Gatewayopenclaw gateway stop停止Gatewayopenclaw gateway restart重启Gatewayopenclaw config get查看配置openclaw config validate验证配置openclaw logs --follow查看日志13安全建议⚠️ 重要安全提示设置强TokenGateway的Token要设置复杂密码不要暴露到公网除非有安全防护否则不要把18789端口暴露到公网保护API Key通义千问API Key不要泄露不要上传到GitHub等公开平台定期更新定期运行npm update -g openclaw更新OpenClaw--End--内容好长……
