前言
OpenClaw （后续统称龙虾）本身并不是AI模型，其更多的是作为 “网关” 沟通智能体和各类API接口，所以使用龙虾需要其他的AI协同。
龙虾官方文档位置：https://docs.openclaw.ai/zh-CN
在操作前需要先了解，根据运行平台的不同，对于Windows 系统龙虾提供了三类安装方法：
- 直接安装在Windows : 官方脚本、源码编译、NPM手动安装
- 安装在Windows的Linux子系统（官方推荐）
- Docker 容器化安装
由于网络工程师广泛使用的HCL、ENSP等模拟器均要求关闭“Hyper-V 虚拟化”，而“安装在Windows的Linux子系统（官方推荐）”、“Docker 容器化安装” 都需要开启H-V， 会直接导致模拟器不可用，所以本篇以直接安装在Windows 说明，其他安装方法可以参考龙虾官网。
由于龙虾本身需要前置运行环境，官方脚本默认环境均正常，直接导致使用官方脚本安装极易报错，源码编译不建议非开发者操作，这里只说明NPM手动安装流程。
环境准备
龙虾需要三个环境：nodejs >= 22 、 git（建议最新）、npm (跟随nodejs版本)
前置环境安装
安装Nodejs
nodejs 是nodejs 编程语言的开发和运行环境，npm是nodejs的包管理工具，安装nodejs会自动装好npm。
访问nodejs 官网下载：https://nodejs.org/zh-cn/download
全部下一步即可。
注意：这里非常建议整合一个路径不携带中文字符的文件夹作为环境目录，将所有编程、软件运行环境都安装在里面，后续方便整理。否则一旦环境出了问题极难修复。
这里我将环境均安装在
C:\MySelf\Env\目录
安装Git
Git是用来让电脑ssh\https 访问github平台的工具，需要用这个工具从github拉取代码。
访问git 工具官网 https://git-scm.com/install/ 下载
x64 或者ARM64 以电脑CPU型号为准，个人电脑一般为X64 架构
- Intel / AMD → x64
- Microsoft Snapdragon / Qualcomm → ARM64
CPU型号可以CMD执行命令查看：
echo %PROCESSOR_ARCHITECTURE%
同样一路下一步即可安装完成
环境检查与配置
1、安装后在“系统环境变量-Path” 应当有四条环境变化，初次安装会不全，需要手动补全
如上图，初次安装一般少下面椭圆框出的两条，需要按实际安装路径补全，关于环境变量的必要性，可以参考我这篇博客：
https://atmujie.com/2023/02/09/浅谈环境变量/
2、打开新cmd输入以下命令，如果有版本打印说明安装无误，否则说明安装有误或环境变量配置有误，需要重新部署环境
注意：一定要新开CMD，在配置环境变量前打开的CMD不用调用新的环境变量信息
node -v
npm -v
# node 和 npm有一个没有打印重装nodejs
git -v
# git 没有打印重装git
3、配置GIT工具通过HTTPS 或SSH 访问github
ssh 访问 github 平台需要登录，没有登录拉取文件报错，https不用登录。所以使用git 工具有两个思路：
- 临时使用：强制使用https 拉取信息。 需要管理员权限运行CMD配置以下三条命令：
# 关闭SSL校验
git config --global http.sslverify "false"
# 全局配置 Git 优先用 HTTPS
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
git config --global url."https://github.com/".insteadOf git@github.com:
git config --global url."https://".insteadOf git://
- 长期使用：注册github 账号，完成ssh公钥绑定
百度或者参考我的博客：https://atmujie.com/2020/11/03/学习第一步，使用hexo搭建自己的博客/#toc-heading-13；
只需要配置以下两步，这里不做赘述：
如果安装遇到下面的报错，就说明git工具没有接入到github，需要重做通过HTTPS 或SSH 访问github
安装龙虾
通过NPM手动安装龙虾
龙虾官网命令需要科学上网，这里不使用，执行以下命令通过npm 下载
npm install -g openclaw@beta --ignore-scripts --registry=https://registry.npmmirror.com
如果npm 报错，调整环境后再次安装前先使用npm cache clean --force 清除缓存，避免出现其他问题。
出现如下提示说明安装成功：
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead 只是WARN，告警某个库不适用，不影响使用龙虾，忽略即可。
首次运行配置
CMD 执行openclaw onboard 启动龙虾，初次启动速度较慢，需要耐心等待几分钟。
完成首次引导后，后续启动使用openclaw gateway start 命令。
启动后进入配置页面，上下左右移动、空格选中、回车确认进入下一项。
1、 I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
● Yes / ○ No
免责条款，只能Yes
2、Onboarding mode
● QuickStart (Configure details later via openclaw configure.)
○ Manual
默认QuickStart ，直接回车
3、选择模型
这里可以用Qwen，阿里千问有少量免费试用。我这里买了方舟大模型所以选 Volcano Engine。
如果需要完全免费，可以本地部署Ollama 选择OpenAI。 暂时没想好可以到最下面跳过。
4、接入聊天软件
暂时直接跳过，避免安装其他插件导致龙虾首次配置失败，后续启动成功让龙虾自己配置即可。
5、其他配置：保持默认不变全部回车
6、设置龙虾技能：这里是多选，按需选择即可。
7、包管理器：选择NPM (这里我们是NPM安装的)
8、其他配置：全No
9、hooks： 全选
10、怎么试用龙虾
分别是命令行使用、Web页面使用、稍后选择，这里建议Web UI。
配置完成，等待安装即可。
接入聊天软件（这里以QQ为例）
进入https://q.qq.com/qqbot/openclaw/index.html 创建机器人并获取ID和Secret，直接告诉龙虾让他自己接入（需要先提高权限，并且有点费token，建议手动操作）
QQ也提供了安装方法，可以手动操作：
1.安装OpenClaw开源社区QQBot插件
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
2.配置绑定当前QQ机器人
openclaw channels add --channel qqbot --token "XXXXX:XXXXXXXXXXXXXXXXX"
3.重启本地OpenClaw服务
openclaw gateway restart
提高龙虾权限
使用命令提权
openclaw config get tools.profile
messaging：最低权限，适合聊天和简单的操作（默认）coding：大多数本地读写/命令场景full：全开权限
一般给coding权限就足够：
openclaw config set tools.profile coding
openclaw gateway restart
致谢
本文参考以下大佬文章思路以及OpenClaw 官网，在此致谢：
个人博客站MaJianyu：https://mjy.js.org/posts/openclaw-installation-and-configuration-guide/
bilibili 我叫胡青川：https://jbblz3ue5k.feishu.cn/wiki/HcXXwdYsGiaek8kSFnpczNQ5nBg
知乎 xcrossed ：https://zhuanlan.zhihu.com/p/2000972060445414672
最后安利下胡青川大佬的一键化工具，安装使用非常方便：【谁说 Windows 安装不了 OpenClaw，全网最简单安装方式来了】
