本文档整合 OpenClaw 中文社区 安装说明与 飞书接入教程,从零完成安装并接入飞书。
1.1 环境说明
- 系统:支持 macOS、Windows、Linux
- 包管理:脚本会自动安装 Node.js 与依赖;也可使用 npm / pnpm 或 Docker
- 国内用户:建议使用下方带 国内镜像 的命令,加速下载
1.2 macOS / Linux(一键脚本)
国际源:
国内镜像:
GPT plus 代充 只需 145
1.3 Windows(PowerShell)
国际源:
国内镜像:
GPT plus 代充 只需 145
1.4 npm 全局安装
安装后执行向导:
GPT plus 代充 只需 145
1.5 pnpm 全局安装
同样执行:
GPT plus 代充 只需 145
1.6 Docker 一键部署
适合服务器、NAS,无需单独安装 Node.js:
详细步骤见官网 Docker 部署指南。
1.7 首次配置(向导)
安装完成后在终端执行:
GPT plus 代充 只需 145
2.1 前提条件
- 已完成 OpenClaw 服务部署(本地或云服务器)
- 拥有飞书账号(企业版或个人版均可)
2.2 创建飞书企业自建应用
步骤 1:打开飞书开发者平台
浏览器访问 open.feishu.cn/app,使用飞书账号登录。
步骤 2:创建应用
- 点击「创建企业自建应用」
- 填写应用名称(如「OpenClaw 助手」)、选择应用图标
- 点击「创建」,进入应用管理页
步骤 3:添加机器人能力
- 左侧导航找到「添加应用能力」
- 选择「机器人」→ 点击「添加」
步骤 4:获取应用凭证
- 左侧进入「凭证与基础信息」
- 复制并保存 App ID 和 App Secret(后续在 OpenClaw 中填写)
2.3 事件与权限配置
2.3.1 事件配置(必须用长连接)
- 左侧进入「事件与回调」
- 「事件配置」中,订阅方式选择「使用长连接接收事件」
- 点击「保存」
⚠️ 必须选「长连接」模式,这样无需公网 IP 和回调地址,OpenClaw 可主动连接飞书接收消息。
2.3.2 添加事件订阅
- 点击「添加事件」
- 在「消息与群组」分类下勾选「接收消息」(im.message.receive_v1)
- 点击「确定」
2.3.3 权限配置(批量导入)
- 左侧进入「权限管理」
- 点击「批量导入权限」
- 将下面 JSON 粘贴到导入框,点击「导入」:
确认列表中出现上述权限即表示导入成功。
2.3.4 发布应用
- 左侧进入「版本管理与发布」
- 点击「新建版本」,填写版本号与描述
- 保存并「发布」
2.4 在 OpenClaw 中配置飞书
- 打开 OpenClaw 管理页面:(云服务器可用 SSH 隧道:,本地浏览器访问 )
- 左侧点击「Channels」
- 找到「Feishu」,点击配置
- 填入 App ID 和 App Secret
- 点击「Save」
- 等待几秒,确认状态为「Connected」;异常时可点击「Restart」重连
2.5 验证飞书接入
- 打开飞书 APP(手机或电脑),使用与开发者平台相同的账号
- 进入「工作台」→ 找到已发布应用(如「OpenClaw 助手」)→ 进入
- 在私聊中发送任意消息(如「你好」)
若收到 AI 回复,即表示飞书接入成功。
2.6 群聊使用说明
群聊中,机器人默认仅在以下情况回复:
- 被 @ 时
- 消息以 问号 结尾
- 消息包含 求助词(如:帮、请、怎么、如何…)
可避免刷屏。
安装与运行
问题 建议 国内下载慢 使用 或国内镜像脚本 管理页打不开 确认 OpenClaw 已启动,并检查端口 18789 是否被占用
飞书相关
问题 排查步骤 机器人收不到消息 ① 应用是否已发布(非草稿)② 事件是否选「长连接」③ 权限是否已开通 ④ 管理页 Feishu 状态是否为 Connected 飞书提示「未建立长连接」 ① 检查 App ID / App Secret 是否正确 ② 确认 OpenClaw Gateway 在运行 ③ 在管理页点击 Restart 群聊 @ 机器人不回复 确认已开通「接收消息」事件,且权限中包含群消息相关权限
资源 链接 OpenClaw 中文社区(官网与文档) clawd.org.cn/ 飞书接入详细教程 openclawchina.com/channels/fe… GitHub(上游) openclaw/openclaw
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/236968.html