本文记录从 0 开始在 Windows 上安装 OpenClaw 并配置飞书的完整流程,以及踩过的坑。
- Windows 10
- 管理员权限
- 稳定的网络连接,有条件可以访问github
- 使用千问等大模型,出现报错实时分析
本人IT行业从业者,从0开始安装,到配置好最高权限,用了5小时。
下载安装
- 下载 64-bit Git for Windows Setup
- 一路 Next(默认配置即可)
- 验证安装:
下载安装
- 下载 Windows Installer (.msi)
- 安装时勾选 “Automatically install the necessary tools”
- 验证安装:
笔者直接下载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 配置
- 访问 飞书开放平台
- 登录后点击「创建应用」
- 选择「企业自建应用」
- 填写应用名称(如 “OpenClaw助手”)
- 记录 App ID 和 App Secret
5.2 配置权限
进入应用后台 → 权限管理,开启以下权限:
笔者将云文档的所有权限均配置,以上配置只能收发消息。
5.3 配置事件订阅
- 进入「事件订阅」
- 订阅方式,使用接收事件,并添加事件
- 开启「接收消息」事件
- 配置请求地址(需要公网可访问,或内网穿透)
- 验证 URL 有效性
5.4 配置 OpenClaw
编辑 OpenClaw 配置文件:
5.5 启动 Gateway
发送测试消息
飞书发消息指令
查看日志
- OpenClaw 官方文档
- 飞书开放平台
- Node.js 官网
- Git 官网
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/287992.html原文链接:https://javaforall.net
