windows安装
方式一:直接安装在windows上
如果是普通用户,想让龙虾操作本地文件等需求,选择这种方式,权限比较高
第一步:前期安装准备
- Node.js 网址https://nodejs.org
- git 网址 https://git-scm.com
验证:管理员身份打开CMDgit--version npm-v 出现下面版本号提示说明安装成功,windows傻瓜式安装一般这步不会有问题第二步:安装openclaw
openclaw官网:https://openclaw.ai/
上面官网提供了安装命令,但是下载可能会很慢,所以这里是用国内镜像源安装 npm i-g openclaw--ignore-scripts--registry=https://registry.npmmirror.com如果执行报错提示 npm error command git--no-replace-objectsls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git npm error git@github.com: Permission denied(publickey).npm error fatal: Could not readfromremote repository.这表示 npm 在拉取依赖 libsignal-node 时,尝试通过 SSH 协议访问 GitHub 仓库,但本地没有配置有效的 SSH 公钥,导致权限被拒绝。 解决:强制 Git 使用 HTTPS 而非 SSH(推荐) git config--global url."https://github.com/".insteadOf ssh://git@github.com/ git config--global url."https://github.com/".insteadOf git@github.com: 然后在重复上面npm安装的命令验证 openclaw--version 出现版本说明安装成功第三步:初始化配置
openclaw onboard--install-daemon同意条款
快速开始
选择本地模型提供商或者是云服务模型提供商
- 如果选择本地模型提供商则配置模型地址,apikey随便写,本地模型不用该参数,并填写本地模型名称
- 如果选择的是云提供商按照提示输入自己的apikey,和秘钥,自己的apikey和秘钥去注册的提供商开放平台去查询
选择一个通道,可以根据这个通道和龙虾沟通,也可以先跳过,等部署完龙虾后再配置
联网搜索,可以选择不同提供商,也看先跳过,先配置好龙虾后再慢慢配置联网功能
配置技能,每个想要的技能都要单独配置,可以跳过,后期根据需要或者在技能市场挑选配置
钩子能力,第一次可以关闭,这个功能主要是OpenClaw 用来 “插手、监听、修改 程序行为,会话记忆,处理文件等,后期也可以配置
因为我安装过,所以会出现已经存在一个gateway,这里选择重启即可,第一次安装会直接跳过启动gateway
启动后会在弹出gateway窗口
最后一步分别是选择是用图形界面打开,还是webui打开,选择webui即可
在gateway窗口中找如下的连接,复制到浏览器中去
http://127.0.0.1:18789/#token=988bb7103aa3fb984971c92a83090d66df3d0eb0f0666a07然后你就可以和龙虾对话了,可以给你的龙虾起名字
报错
如果找不到这个路径,或者ui报错unauthorized: gateway token mising
则可以在cmd运行下面命令,重新获取带token的地址 openclaw dashboard--no-open在执行错误框中第二个命令,设置通用token openclaw doctor--generate-gateway-token如果设置后,在使用带token URL访问,还会报错40008,大概率是浏览器内核版本太老,更换chrom最新版本即可,这个问题处理我参考下面这个博客
openclaw 报错 disconnected(4008): connect failed
如果前面配置错了,怎么办
方式一
该配置文件就是前面配置持久化地址,可以直接修改这个配置文件,如果不知道地址,可以去龙虾上面的ui页面问龙虾,你的配置地址在哪,它会告诉你的 C:\Users\Administrator\.openclaw\openclaw.json方式二
使用命令,然后选择自己要修改哪一步的配置 openclaw config
无论哪种方式,修改完成后执行,重启gateway生效
openclaw gateway restart方式二:wsl安装,这种安装方式相当于在windows上安装了一个linux的子系统,然后在子系统中养龙虾,安全性相对较高
第一步 安装wsl
wsl--install如果wsl运行提示找不到服务器,则需要配置dns,打开网络设置,设置IPv4首选 DNS:223.5.5.5(阿里云)
备用 DNS:114.114.114.114(114DNS)
执行完后重启,重启后会自动出现下面弹窗等待安装完成并设置一个用户名,密码
验证安装成功:再次打开管理员cmd,输入wsl -l -v
输出显示「Ubuntu Running Version 2」即为成功。
第二步:安装nvm
安装nvm curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bash 加载nvm配置."$HOME/.nvm/nvm.sh"安装node.js nvm install 24 验证,输出版本号则安装成功 node-v npm-v第三步:安装cmake
下载cmake wget https://github.com/Kitware/CMake/releases/download/v3.31.11/cmake-3.31.11-linux-x86_64.sh 赋予安装包可执行权限 sudo chmod+x cmake-3.31.11-linux-x86_64.sh 一键安装跳过协议,安装到系统默认目录 sudo./cmake-3.31.11-linux-x86_64.sh--prefix=/usr/local--skip-license验证安装 cmake--version第四步:安装openclaw
npm install-g openclaw@latest初始化配置并安装守护进程 openclaw onboard--install-daemon到这一步往后就是配置了,可参考第一种方案
OpenClaw基础指令
| 序号 | 命令 | 功能 | 常用参数 / 示例 | 适用场景 |
|---|---|---|---|---|
| 1 | openclaw onboard | 重新进入初始化向导(最常用) | --install-daemon(自动安装后台服务)--no-onboard(仅安装不向导) | 首次安装、想重置模型/渠道/权限时 |
| 2 | openclaw config | 交互式修改配置(推荐) | openclaw config set model claude-4openclawopenclaw config set channel telegram | 只改模型、渠道、端口等,不想重走全流程 |
| 3 | openclaw status | 实时查看整体状态 | openclaw status --allopenclaw status --json | 快速诊断“界面打不开”“不回复消息”等 |
| 4 | openclaw gateway(restart)系列 | 管理后台服务(最核心) | openclaw gateway installopenclaw gateway startopenclaw gateway stopopenclaw gateway restartopenclaw gateway status | 服务挂了、改配置后必须重启、开机自启 |
| 5 | openclaw dashboard | 一键打开控制面板 | 无参数(自动处理端口 + Token) | 浏览器访问http://127.0.0.1:18789最快方式 |
| 6 | openclaw logs --follow | 实时跟踪日志 | openclaw logs --followopenclaw logs --json | 精准定位报错、技能失败、模型超时 |
| 7 | openclaw update | 一键升级 | openclaw update(自动拉最新版 + 重启) | 每周执行,获取新功能 + 安全补丁 |
| 8 | openclaw doctor、openclaw doctor --fix | 健康诊断 | openclaw doctor,openclaw doctor --fix | 一键检查配置错误、端口占用、权限问题 /–fix修复问题 |
| 9 | openclaw health | 轻量健康检查 | openclaw health | 快速确认 Gateway 是否存活 |
| 10 | openclaw channels status | 查看所有聊天渠道状态 | openclaw channels status --probe | Telegram/飞书/微信是否正常连接 |