OpenClaw 学习中心

下一代AI Agent 开发与运行平台,让智能代理开发更简单、更高效、更强大

核心 特性

多技能生态

支持丰富的技能市场,开箱即用的工具链,快速搭建符合业务需求的智能代理,无需从零开始开发。

🔒

安全可控

完善的权限控制、行为审计和沙箱机制,确保AI代理的操作可追溯、可管控、可审计。

🔗

多平台集成

原生支持飞书、企业微信、Slack、Discord等主流办公平台,无缝融入现有工作流。

🧠

多模型支持

兼容GPT、Claude、Gemini、通义千问、文心一言等主流大模型,按需切换最佳算力。

🚀

低代码开发

声明式技能定义,可视化流程编排,降低AI Agent开发门槛,提升开发效率。

📊

可观测性

完整的运行监控、日志追踪和性能分析,实时掌握Agent运行状态,快速定位问题。

学习 路径

1

入门基础

了解OpenClaw核心概念,完成本地安装部署,运行第一个Hello World Agent。

2

技能开发

学习技能开发规范,掌握技能的创建、调试、发布流程,开发第一个自定义技能。

3

平台集成

学习如何将OpenClaw接入飞书、企业微信等办公平台,实现消息互通与能力输出。

4

高级特性

掌握记忆系统、工具调用、多Agent协作等高级功能,构建复杂业务场景的智能代理。

5

生产部署

学习生产环境部署方案、高可用配置、监控告警体系,保障Agent稳定运行。

6

生态贡献

参与开源社区建设,贡献技能、提交Bug、分享最佳实践,共同推动生态发展。

飞书插件 实战教程

飞书官方插件介绍

飞书官方新出了 OpenClaw 插件(@larksuite/openclaw-lark-tools),能力大幅提升,解决了之前机器人创建文档无编辑权限等问题,新增核心能力包括:

  • 对话增强:流式卡片回复、表情回复、读取合并转发消息
  • 多维表格:创建/管理表格、数据表、字段(27种)、记录增删改查、批量操作、高级筛选、视图
  • 日历日程:日历管理、日程创建/查询/修改/删除/搜索、参会人管理、忙闲查询
  • 任务管理:任务创建/查询/更新/完成、清单管理、子任务、评论
  • 消息操作:消息读取(群聊/单聊历史、话题回复)、发送、回复、搜索、图片/文件下载
  • 云文档:创建(Markdown → 飞书文档)、更新(7种模式)、读取云文档内容

新增更多以用户身份操作飞书的能力,让 OpenClaw 升级为个人的办公助手。

安装飞书插件

先查看已安装的插件列表:

openclaw plugins list

执行安装命令,自动禁用旧版飞书插件:

npx -y @larksuite/openclaw-lark-tools install
提示:如果执行出错,可在命令前增加 sudo 重新执行。

手动禁用旧版飞书插件(新版会自动处理,可选):

openclaw config set plugins.entries.feishu.enabled false

创建飞书机器人

前往飞书开发者后台创建机器人应用,记录两个关键凭证:App IDApp Secret,后续配置需要使用。

配置凭证

方式一:Web UI 配置
直接在 OpenClaw 的 Web UI 输入框里发送 App ID 和 App Secret,让 OpenClaw 自动配置。

方式二:命令行手动配置

openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId {你的appid}
openclaw config set channels.feishu.appSecret {你的appsecret}
openclaw config set channels.feishu.domain feishu
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing/allowlist/open

openclaw config set plugins.allow '["feishu-openclaw-plugin"]'

飞书机器人权限设置

在飞书开发者后台导入权限配置,完整权限JSON如下:

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access",
      "base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message.send_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

添加「接收消息 v2.0」事件:飞书开发者平台 → 你的应用 → 左侧菜单「开发配置」→「事件与回调」 → 添加事件。

发布注意:发布后部分权限需要审核,个人账号会收到手机飞书APP提醒,点击审核即可。发布时可用范围需要添加需要使用的成员。

首次配对与测试

第一次对话时,发送任意消息给飞书机器人,会返回匹配码,将匹配码发送到OpenClaw Web UI完成配对。

配对完成后即可正常使用,通过飞书与OpenClaw对话处理任务。

流式输出与插件升级

开启流式输出(更流畅的回复体验):

openclaw config set channels.feishu.streaming true

关闭流式输出:

openclaw config set channels.feishu.streaming false

开启卡片底部状态显示:

openclaw config set channels.feishu.footer.elapsed true
openclaw config set channels.feishu.footer.status true

版本要求:飞书插件需要 OpenClaw 版本 ≥ 2026.2.26(Linux/macOS)或 ≥ 2026.3.2(Windows),版本不足执行升级:

npm install -g openclaw

升级飞书插件到最新版本:

npx -y @larksuite/openclaw-lark-tools update

学习 资源

📚

官方文档

最权威的开发指南、API参考、最佳实践

💻

GitHub 仓库

源码、Issue、PR,参与开源贡献

💬

Discord 社区

与全球开发者交流,获取技术支持

🛒

技能市场

海量开箱即用的技能,快速搭建业务场景

📋

示例代码

丰富的示例项目,快速上手开发

📝

技术博客

最新动态、技术深度解析、实战案例