Windows上安装OpenClaw实践和踩坑记录

515 阅读4分钟

1. 背景介绍

OpenClaw最近爆火,关于该项目本身就不过多介绍,相信对于关注Agentic相关内容的读者看到网上的一些内容和文章后,大家都会跃跃欲试想在自己的环境中搭建试用,本人也不例外。

目前部署的方式有很多种,个人电脑自建(Mac Mini、笔记本、Windows、Linux等等),云厂商提供的快捷搭建套装并且销售火爆(参考阿里云如下) image.png

既然是个人研究和测试使用,本人还是基于个人自己的Windows笔记本(型号 ThinkPad P1 Gen4 + Windows 11)这种成本最低的方式进行实践。

OpenClaw的本质是一个用来操作个人电脑(或服务器)的工作助手Agent,本文中后续简称为目标机器。

它本身没有大模型、操作路径(或者叫指令下发路径,Channel等)等能力,只是巧妙的将现有的主流能力进行了整合,例如:使用IM软件的开发者扩展能力(Telegram、飞书等)作为交互入口和操作路径,使用各大厂商提供的MaaS/Tokens模型能力(GPT、Gemini、zhipu、Kimi等)作为算力基础,最终将用户的命令或诉求转换为目标机器上的可执行的命令(PowerShell、Shell等)、执行、并且最终得出结果的过程。

OpenClaw的架构图网上已经有比较多的分析了,此处就引用一个作者看到写的比较清楚图和介绍

image.png

2. 实践过程

2.1 安装和部署

在Windows电脑上需要安装OpenClaw主要需要以下几个组件和步骤:

  1. 安装WSL,可以参考如何使用 WSL 在 Windows 上安装 Linux
  2. 安装Nodejs并且配置国内可用的源(或者使用梯子),此步骤网上教程较多,此不提供参考内容。
  3. 安装OpenClaw,此处可能会碰到几个坑,后续会单独有章节介绍,参考流程:【保姆级教程】手把手教你安装OpenClaw并接入飞书,让AI在聊天软件里帮你干活
  4. 申请飞书开发者权限和开通应用入口,同样可以参考步骤3中文章
  5. 安装OpenClaw飞书插件并且配置接入,参考步骤3中文章,但是该文章中关于安装OpenClaw飞书插件部分中碰到的问题解决方案不太正确(或者说不太适用于一般人,有更好的解决办法,可以参考下文坑2)

2.2 效果展示

搭建和集成完成后,可以最终达到的效果是直接用飞书直接指挥OpenClaw操作目标机器。

效果1:飞书发送指令并且最终获取执行结果

请OpenClaw帮我看看目标机器磁盘空间还剩下多少,最终能通过飞书给出正确的答案 8d8680f2fdf1db505b4fbe6c3585f387.jpg

image.png

效果2:OpenClaw服务端侧可以看到具体的执行过程

可以看到收到飞书的指令后,开始调用大模型进行思考,转换为PowerShell命令查询磁盘情况 image.png

image.png

image.png

其中经过多轮执行错误并且重新思考和执行,得到磁盘空间的最终情况并且返回给飞书。

执行过程中大模型会多次输出错误的命令并且尝试自己进行修正,重新执行。这可能也是为什么执行非常慢,同时网上大量试用的帖子后控诉OpenClaw消耗Tokens数量异常大的原因,万幸作者在这几次试用过程中没有碰到模型输出后进入 "生成命令 -> 执行错误 -> 重新生成" 的循环过程中(从网上其他人试用的经验来看这种情况也会经常发生)

2.3 特别注意点(或者说坑)

坑1:操作权限

过程中建议都使用管理员权限,因为OpenClaw运行过程需要涉及修改系统配置、运行守护进程等,因此需要此处需要重点注意。

image.png

坑2:安装飞书插件

直接使用Openclaw命令安装飞书插件,在本人的实践过程中大概率会报错,因为OpenClaw命令目前版本大概率识别不到系统已经安装的npm命令,造成命令执行失败。 image.png

此处通过原理和报错分析,OpenClaw命令安装飞书插件也只是调用npm命令进行安装,同时安装后将对应的插件集成到OpenClaw中。 因此我们解决问题的步骤可以参考:

  1. 参考OpenClaw-在windows上安装部署中 " Error: spawn npm ENOENT " 部分先手动使用npm安装飞书插件
  2. 找到npm安装的内容(使用everything,或者npm已经指定好安装目录)
  3. 手动复制对应的extension到openclaw中,并且执行npm进行修复

image.png