OpenClaw 飞书Bot配置教程

🚀 一、飞书的优势

💼

现代化办公 提供完整的办公套件，文档协作、日历、会议等功能一应俱全

⚡

高效沟通 消息实时同步，支持多端同时在线，沟通无障碍

🔧

开发友好 开放平台API丰富，机器人开发文档完善，接入门槛低

💰

免费使用 免费版功能丰富，满足中小团队日常使用需求

📖 二、OpenClaw接入飞书教程

方式一：通过安装向导添加（推荐）

bash

openclaw config add gateway lark

方式二：通过命令行添加

bash

openclaw config add gateway lark --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

🏗️ 三、创建飞书应用

打开飞书开放平台
访问 open.feishu.cn 并登录
创建应用
点击"创建企业自建应用"，填写应用名称和描述
获取应用凭证
在"凭证与基础信息"中获取 App ID 和 App Secret
配置应用权限
批量导入JSON配置，包含机器人所需的所有权限
启用机器人能力
在"机器人"页面开启机器人功能
配置事件订阅（WebSocket模式）
选择WebSocket模式，无需配置回调地址
发布应用
在"版本管理与发布"中创建版本并申请发布

⚙️ 四、配置OpenClaw

通过向导配置

bash

openclaw config add gateway lark

通过配置文件配置

json

{
  "gateways": [{
    "type": "lark",
    "appId": "cli_xxxxxxxxxx",
    "appSecret": "xxxxxxxxxx"
  }]
}

通过环境变量配置

bash

export LARK_APP_ID=cli_xxxxxxxxxx
export LARK_APP_SECRET=xxxxxxxxxx

🧪 五、启动并测试

启动网关

bash

openclaw gateway start lark

发送测试消息

在飞书中找到你的机器人，发送一条消息测试连接是否正常。

配对授权

首次使用需要发送 /pair 命令进行用户授权配对。

🔐 六、访问控制

私聊访问

通过 allowFrom 配置白名单，限制哪些用户可以私聊机器人：

json

{
  "allowFrom": ["ou_xxxxxxxxxx"]
}

群组访问

配置群组白名单，限制机器人在哪些群组中响应：

json

{
  "allowFrom": ["oc_xxxxxxxxxx"]
}

👥 七、群组配置示例

json

{
  "type": "lark",
  "appId": "cli_xxxxxxxxxx",
  "appSecret": "xxxxxxxxxx",
  "allowFrom": ["oc_xxxxxxxxxx"],
  "groupMention": true,
  "atOnly": true
}

groupMention: 是否响应群组中的@消息
atOnly: 是否只在被@时才响应

📝 八、常用命令

命令	说明
`/status`	查看机器人状态
`/reset`	重置当前会话
`/model`	切换AI模型

网关管理命令

bash

# 查看网关状态
openclaw gateway status

# 停止网关
openclaw gateway stop lark

# 重启网关
openclaw gateway restart lark

🔧 九、故障排除

⚠️ 常见问题

机器人在群组中不响应：检查群组白名单配置，确保机器人已添加到群组
机器人收不到消息：检查事件订阅配置，确认WebSocket连接正常
App Secret泄露：立即在飞书开放平台重置密钥，并更新OpenClaw配置
发送消息失败：检查应用权限是否包含"发送消息"权限

🚀 十、高级配置

多账号配置

支持同时配置多个飞书应用：

json

{
  "gateways": [
    {
      "type": "lark",
      "name": "lark-work",
      "appId": "cli_xxx",
      "appSecret": "xxx"
    },
    {
      "type": "lark",
      "name": "lark-personal",
      "appId": "cli_yyy",
      "appSecret": "yyy"
    }
  ]
}

消息限制

流式输出：支持逐字显示，提升交互体验
消息引用：支持引用上下文回复
多Agent路由：根据不同场景路由到不同Agent