openclaw接飞书保姆级教程

如何配置OpenClaw：从模型选择到飞书机器人接入

了解如何启动OpenClaw之后，接下来的关键步骤就是进行配置了。这个过程主要分为两大块：选择AI模型和配置通信渠道。下面我们按步骤来梳理一下。

1. 运行配置命令并选择模型

启动配置很简单，在终端输入 openclaw config 即可。首先遇到的是模型配置环节。你需要在这里填入你所使用的AI模型信息。模型来源很灵活，既可以使用自己购买的商业化模型，也可以利用各大平台提供的免费试用模型。目前，一个比较常见的选择是接入千问等模型。

2. 选择并配置通信渠道

模型选好后，下一步就是配置渠道（Channel）。这决定了OpenClaw将通过哪个平台与用户交互。

以飞书（Lark）为例，选择后需要填写飞书应用的凭证信息。

这里需要填入从飞书开放平台获取的 App ID 和 App Secret。这两项是机器人身份认证的关键。

完成以上两步，OpenClaw的基本环境配置就告一段落了。但要让机器人在飞书里真正跑起来，还得在飞书平台完成另一侧的配置。

设置飞书侧：创建并配置机器人应用

如果你还没有飞书账号，需要先注册一个。接下来，我们进入飞书开放平台，创建一个属于你自己的机器人应用。

1. 创建企业自建应用

访问飞书开放平台，找到“企业自建应用”并创建一个新应用。创建成功后，你会看到类似下面的应用概览页面。

2. 获取应用凭证

在应用的“凭证与基础信息”页面，你可以找到至关重要的 App ID 和 App Secret。这两串字符就是之前配置OpenClaw时需要填写的关键信息。

3. 为应用添加机器人能力

为了让应用能够收发消息，需要在“功能”部分添加“机器人”能力。

4. 配置必要的权限

添加机器人后，需要开启相应的API权限，否则机器人无法正常工作。通常需要开启以下几项核心权限：

• im:message：用于接收和发送消息，这是对话的基础。
• im:chat：用于获取群组信息，以便在群聊中响应。
• contact:user.base:readonly：读取用户基础信息，有助于提供个性化服务。

记得点击“申请权限”并等待审核通过（自建应用在测试环境通常自动通过）。

5. 配置事件回调（关键步骤）

这一步是打通飞书与OpenClaw服务的关键。进入“事件与回调”->“回调配置”。

这里有一个重要前提：必须确保你的OpenClaw服务已经成功启动并运行，因为飞书会尝试向你所配置的服务器地址发送验证请求。选择“使用长连接接收回调”，并保存配置。只有在OpenClaw服务在线且网络可达的情况下，才能保存成功。

保存成功后，就可以“添加事件”了。根据机器人的需要，订阅相应的事件类型，例如“接收消息”、“用户加群”等。

6. 发布应用并添加到会话

配置完成后，来到“版本管理与发布”页面，创建一个新版本，填写版本号和更新说明。

发布成功后，你可以直接将应用添加到某个飞书群组进行测试，或者让同事/小组成员自行安装。

7. 开始对话

一切就绪后，打开飞书，找到你添加的机器人应用。现在，你已经可以和它进行对话了。

至此，一个连接了强大AI模型、并通过飞书与用户交互的智能助手就完整配置好了。整个过程看似步骤不少，但一步步跟着走下来，其实逻辑非常清晰：先在本地服务端配置好模型和渠道连接，再在飞书平台创建一个合法的机器人应用并建立通信链路。两边对接成功，你的专属AI助手就能7x24小时待命了。