目录

一、背景与运行环境说明

二、安装过程与踩坑填坑历程说明

三、安装向导的设置

四、初步使用时需要做的配置调整

4-1、去除网页顶部的TOKEN错误提示

4-2、调整对接大模型的配置值

4-3、下载一些基本的SKILL能力

4-4、提供OpenClaw操作文件资源等的权限(谨慎设置!!!)

4-5、修改完成配置后,重启网关服务


 一、背景与运行环境说明

       2026新年伊始,一款名为OpenClaw的开源AI Agent,掀起了一股热浪席卷整个国内的AI圈,同时,也引发了一股全民“养龙虾”的热潮。我这边,最近,也做了一次安装OpenClaw的本地环境操作。现将对应过程中遇到的相关问题均整理了一下,方便后续的回顾。

       OpenClaw安装的版本:20260302

       本地开发环境:windows 10操作系统。

       前置准备条件:请自行安装准备git,Node.js(Node.js ≥22)等基础运行环境。

       参考文献链接:

       1、OpenClaw官方网站:https://openclaw.ai/https://openclaw.ai/

      2、OpenClaw的说明文档网站:
https://docs.openclaw.ai/zh-CNhttps://docs.openclaw.ai/zh-CN      3、菜鸟教程
https://www.runoob.com/ai-agent/openclaw-clawdbot-tutorial.htmlhttps://www.runoob.com/ai-agent/openclaw-clawdbot-tutorial.html

二、安装过程与踩坑填坑历程说明

2-1、使用官网提供的CMD环境下的一键安装脚本命令进行安装

相关命令:

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

然而,直接执行之后,会遇到如下的报错问题:

       经过搜索引擎和AI问答机器人的协助,还是感觉有些难以明白其中报错的含义。因此,我这边放弃了此种安装方式,选择了菜鸟教程中推荐的另外一种使用Node.js的安装方式来进行安装操作。

Node.js的安装命令为:

npm install -g openclaw@latest

      可惜,执行之后,依旧没能如愿看到成功安装的提示信息。看到了如下截图中的报错信息:

报错内容如下:

npm error code 128
npm error A git connection error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm error ssh: connect to host github.com port 22: Connection timed out
npm error fatal: Could not read from remote repository.
npm error
npm error Please make sure you have the correct access rights
npm error and the repository exists.
npm notice
npm notice New major version of npm available! 10.9.4 -> 11.11.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.11.0
npm notice To update run: npm install -g npm@11.11.0
npm notice
npm error A complete log of this run can be found in: C:\Users\Administrator\AppData\Local\npm-cache\_logs\2026-03-05T02_43_17_410Z-debug-0.log

经过豆包的协助解读,我得到了如下的解决方案:

修改了git的全局配置后

git config --global url."https://github.com/".insteadOf ssh://git@github.com/

我重新执行了npm install的命令,然后,很悲剧,还是遇到了报错:

报错的具体内容如下:

npm error code 128
npm error An unknown git error occurred
npm error command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm error fatal: unable to access 'https://github.com/whiskeysockets/libsignal-node.git/': Proxy CONNECT aborted
npm error A complete log of this run can be found in: C:\Users\Administrator\AppData\Local\npm-cache\_logs\2026-03-05T03_13_39_395Z-debug-0.log

       我发现这个报错和官网提示的报错内容是基本一致的,这个时候,我发现在上一个报错的解决过程中,我只是按照提示修改了git的1处全局配置,此时,我重新补充了另外1处配置项,并且,也将安装方式做了调整,重新启用了官网中所提供的一键安装脚本命令进行再次安装。

执行命令如下:

git config --global url."https://github.com/".insteadOf git@github.com:

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

     经过调整后,这次终于看到成功安装后,进入安装引导的界面了。

三、安装向导的设置

     来到安装引导页面,请根据如下指引进行操作:

       选择OpenClaw需要对接的大模型,根据不同的大模型(:请自行前往各大AI大模型厂商官方网站订阅对接大模型的账号),选择操作之后,可能需要相应地进行不同的用户验证,请根据各自遇到的实际情况提示,完成操作即可。

安装引导设置完成后,可以看到如下的启动界面。

备注:OpenClaw运行过程中,切勿将此窗口关闭:

根据提示:我们通过浏览器直接来到这个链接:

http://127.0.0.1:18789,就可以看到如下的界面了。

四、初步使用时需要做的配置调整

4-1、去除网页顶部的TOKEN错误提示

来到C:\Users\{用户名}\.openclaw\目录下

找到.openclaw.json配置文件中的这个地方:

将找到的token值,并找到网站中的指定位置并填入保存,随后,这个报错问题就可以解决了。

4-2、调整对接大模型的配置值

在.openclaw.json文件中,找到相关models与agents节点,根据自身情况做配置项的调整设置。

4-3、下载一些基本的SKILL能力

前往以下链接:

https://clawhub.ai/skills?sort=downloadshttps://clawhub.ai/skills?sort=downloads

搜索你需要为OpenClaw添加的技能包,下载并解压至这个目录下:

C:\Users\{用户名}\.openclaw\workspace\skills

没有足够的技能包,OpenClaw响应起来,可能会显得比较笨拙,感觉很多事情都没法去完成。

4-4、提供OpenClaw操作文件资源等的权限(谨慎设置!!!)

      OpenClaw还有一项很重要的能力,就是可以操作(添加,修改,删除,分析等)所在机器的文件资源,利用好了这项能力,确实可以让咱们的工作事半功倍,但是,如果OpenClaw有误判处理等问题,往往会导致对文件资源的删改,如果没能及时人工介入,可能会造成重要资源文件受损,甚至无法恢复等问题,那就很麻烦了。目前,咱们国家工信部对OpenClaw的使用,已提出相关指导意见。因此,我这里也是建议大家可以将这项能力赋予非日常主力机的环境,谨慎用于日常工作的主力机,涉及机密数据等机器环境中。

4-5、修改完成配置后,重启网关服务

     在正确配置了OpenClaw的相关配置项之后,记得重启网关服务,从而,让相关配置可以生效。

     重新打开一个Windows下的CMD窗口,执行的命令如下:

openclaw gateway restart

    再次打开与OpenClaw聊天沟通的界面,可以发现OpenClaw的能力,就得到了很显著的提升。

       更多关于OpenClaw的使用体验,后续,还有很多需要学习的地方。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐