最近折腾了一下 OpenClaw,想把它接入到飞书里做个私人助手。踩了不少坑,记录一下完整的安装配置过程,给有需要的朋友参考。
OpenClaw 是个开源的 AI 助手框架,支持接入飞书、钉钉、企业微信这些平台。官方文档有是有,但不够详细,这篇就尽量把每个步骤都讲清楚。
环境:Windows 11 耗时:大概 30 分钟(不算等审核的时间)
先使用 npm 安装 openclaw:

安装完使用 看下版本,我这是 2026.3.2
注意:PowerShell 要用管理员模式运行
它会提示一些安全相关的东西,看一下,确认没问题就继续。

这里选 QuickStart 就行,快速配置。

这一步可以跳过,后面改配置文件也行。

这里我们先选择默认模型:

我后面用的是通义千问阿里云和智谱的。
选择 IM 通道,这里也选择跳过(一会再配):

这一步让你配置技能直接回车:

选择一种和 openclaw 交互的方式,我这使用 web 方式:



选 Feishu/Lark(飞书)

这里需要飞书应用的 App ID 和 App Secret,我们先去飞书开放平台搞(下一步就说),有了appid和secert后再分别填到这里。

注意:填入 App ID 和 App Secret后需要重启Gateway
上 open.feishu.cn,创建企业自建应用。

名字随便起,我填的"眠空的 Open Claw 助手"。
在"凭证与基础信息"里能看到 App ID 和 App Secret。

App Secret 别泄露,这玩意儿跟密码一样。
点"添加应用能力",选机器人。

这个比较关键,权限少了机器人没法用。我加的这些 一次性全部开放哈哈:
批量导入下边权限的 json 文件:

在"事件配置"里加消息接收事件。

用长连接就行,不用搞公网 IP,适合本地测试。
然后添加这几个事件:
- 机器人进群
- 机器人被移除群
- 消息已读
- 接收消息

最后点发布,等审核。

审核过了会通知。
发布成功在飞书客户端可以收到通知:

CODE 换成实际的配对码。

浏览器打开

看 Gateway 是不是 Running,当然也可以命令看:

打开飞书,搜你的机器人名字,发消息试试:

能回复就成功了。
配置文件在这:
复制以下内容到配置文件(注意文件位置!)。将 替换为 Coding Plan 专属 API Key。

最终我的 配置(敏感信息已脱敏):
这些命令是我平时用得比较多的,整理一下:




另外也可以在飞书中查看和切换模型:


Skill 就是扩展包,让 OpenClaw 能干更多活。比如:
- 处理文件
- 跑代码
- 上网搜东西
- 操作浏览器
- OpenClaw 官方文档
- OpenClaw GitHub
- Skills 文档

# 启用
openclaw skills enable
# 禁用
openclaw skills disable
# 卸载
openclaw skills uninstall
见 OpenClaw 中/英文官方技能库 英文见这里:github.com/VoltAgent/a…
中文见这里:github.com/clawdbot-ai…
提醒:务必去官方skills库安装 否则风险很大!
CC 就是 Claude Code,Anthropic 官方的 CLI 工具,主要用来写代码和处理工程任务。
ACP = Agent Client Protocol
这是 OpenClaw 内部的协议,让 IDE 能通过 WebSocket 连接 Gateway 来调度 Agent。
重点:普通用户不需要关心 ACP。你平时直接用 命令就行,ACP 是底层自动处理的。
就这么简单,中间的细节不用管。
直接用 命令:
给 CC 派活儿时,描述清楚点儿:
如果你真的需要调试 ACP:

再次强调:普通用户用不到这些命令,知道有这么个东西就行。
我工作目录下有这么 8 个核心配置文件,每个都有特定用处:注意这8个配置文件非常重要,写的好与坏直接觉得你的openclaw是否好用!
干啥用的:定义 AI 助手是个啥角色、有啥原则、咋干活。
示例内容(脱敏版):
干啥用的:记用户的基本信息、分工、偏好。
示例内容(脱敏版):
干啥用的:定义开发规范、协作流程、记忆规则。
示例内容(脱敏版):
干啥用的:记项目信息、技术架构、服务器清单、工作规则。
示例内容(脱敏版):
干啥用的:记服务器配置、项目架构、开发环境。
示例内容(脱敏版):
干啥用的:定义定时任务、检查项、汇报模板。
示例内容(脱敏版):
干啥用的:定义 AI 助手的身份、职责、工作节奏。
示例内容(脱敏版):
干啥用的:记初始化完成情况、已配置的规则。
示例内容(脱敏版):
看下日常使用情况:


一般是端口被占了,或者没开管理员权限。
查一下端口:
大概率是权限没配好,或者没发布。
检查一下:
- 权限有没有加全
- 发布了没有
- 看日志:
网络问题吧,重启 Gateway 试试,或者重新发起配对。
检查配置文件 中的 是否正确。
有啥问题可以去看看官方文档:
- OpenClaw 文档
- 飞书开放平台
- GitHub
- skills技能库
到此这篇关于OpenClaw 从零配置指南:接入飞书 + 常用命令 + 原理图解的文章就介绍到这了,更多相关OpenClaw 配置接入飞书内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/237363.html