Windows安装OpenClaw实践指南

Windows安装OpenClaw实践指南

本文记录从 0 开始在 Windows 上安装 OpenClaw 并配置飞书的完整流程,以及踩过的坑。


  • Windows 10
  • 管理员权限
  • 稳定的网络连接,有条件可以访问github
  • 使用千问等大模型,出现报错实时分析

本人IT行业从业者,从0开始安装,到配置好最高权限,用了5小时。


下载安装

  1. 下载 64-bit Git for Windows Setup
  2. 一路 Next(默认配置即可)
  3. 验证安装:

下载安装

  1. 下载 Windows Installer (.msi)
  2. 安装时勾选 “Automatically install the necessary tools”
  3. 验证安装:

笔者直接下载ZIP文件,本地解压,环境变量Path配置中增加,以上是ZIP压缩文件解压的位置,大家可自行替换


克隆仓库

clone的时候,可能会报400或者403错误,结合具体的报错,配置正确的git配置即可。

安装依赖

在安装过程中,需要选择外接具体哪个大模型,笔者尝试过deepseek或者kimi,发现kimi配置更为简单,首冲会送15元。

编译构建

验证安装

⚠️ 常见问题

问题:openclaw 命令找不到

  • 解决:添加环境变量
    此前的openclaw仅安装到依赖node.js运行环境中,使用 npm 进行全局安装

注意不要遗漏最后面的,把这个当前目录下的程序注册为系统级的全局命令。

最简安装后openclaw只拥有聊天的功能,默认配置通常为 messaging,这限制了 AI 只能聊天,无法执行系统命令或操作文件。

如何让openclaw拥有读写文件的权限,可以在最简安装后修改核心配置:解锁工具执行权限。OpenClaw 通过 tools.profile 参数来控制 AI 能调用哪些工具。

问题原因:

解决方法:你需要将配置修改为 full 或包含具体高权限工具的集合。

messaging: 仅聊天(默认,低权限)

full: 完整权限(可执行 Shell 命令、文件操作、网络请求等)

执行

检查支持的技能

检查支持的技能


5.1 创建飞书应用

openclaw 配置

  1. 访问 飞书开放平台
  2. 登录后点击「创建应用」
  3. 选择「企业自建应用」
  4. 填写应用名称(如 “OpenClaw助手”)
  5. 记录 App IDApp Secret

5.2 配置权限

进入应用后台 → 权限管理,开启以下权限:

权限 说明 读取群组信息 发送消息 接收消息 群组管理

笔者将云文档的所有权限均配置,以上配置只能收发消息。

5.3 配置事件订阅

  1. 进入「事件订阅」
  2. 订阅方式,使用接收事件,并添加事件
  3. 开启「接收消息」事件
  4. 配置请求地址(需要公网可访问,或内网穿透)
  5. 验证 URL 有效性

5.4 配置 OpenClaw

编辑 OpenClaw 配置文件:

5.5 启动 Gateway


发送测试消息

飞书发消息指令

查看日志


步骤 关键命令 安装 Git 安装 Node 克隆仓库 安装依赖 编译构建 启动网关

  • OpenClaw 官方文档
  • 飞书开放平台
  • Node.js 官网
  • Git 官网
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/287992.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月17日 上午7:16
下一篇 2026年3月17日 上午7:17


相关推荐

关注全栈程序员社区公众号