OpenClaw 手把手教学配置飞书机器人 目录前置准备创建飞书应用配置机器人能力获取必要凭证配置 OpenClaw测试机器人前置准备在开始之前请确保你具备以下条件✅ 必需条件OpenClaw 已安装# 检查是否已安装openclaw--version飞书管理员权限需要创建企业自建应用的权限或联系管理员协助创建 准备清单OpenClaw 已安装并运行有飞书企业管理员权限基本的命令行操作能力创建飞书应用步骤 1进入飞书开放平台打开浏览器访问 飞书开放平台使用书账号登录点击右上角“开发者后台”步骤 2创建企业自建应用点击“创建企业自建应用”填写应用信息应用名称OpenClaw AI 助手可自定义应用描述基于 OpenClaw 的 AI 智能助手可自定义应用图标上传一个喜欢的图标建议 120x120点击“创建”步骤 3记录应用信息创建成功后你会看到App ID: cli_xxxxxxxxxxxxxxxx App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx⚠️重要立即保存这两个值后面会用到配置机器人能力步骤 4启用机器人功能在应用详情里面添加应用能力选择机器人。步骤 5配置权限点击左侧“权限管理”搜索并添加以下权限权限名称权限标识用途获取与发送单聊、群组消息im:message接收和发送消息获取用户基本信息contact:user.base:readonly获取用户信息获取群组信息im:chat:readonly获取群聊信息发送富文本消息im:message:send_as_bot以机器人身份发送消息点击“批量添加”→“确认”步骤 6发布版本重要点击左侧“版本管理与发布”点击“创建版本”填写版本信息版本号1.0.0更新说明首次发布支持基础对话功能点击“保存”点击“申请发布”等待管理员审批通常几分钟内获取必要凭证步骤 7获取 App ID 和 App Secret在应用详情页点击左侧“凭证与基础信息”你会看到App ID: cli_xxx App Secret: xxxxx就是前面保存的。这个是开发者应用的凭证。其实也是对应机器人的凭证。配置 OpenClaw步骤 8创建配置文件编辑 OpenClaw 配置文件或者直接和龙虾对话配置我正在配置飞书对应的开发者应用 appid 是 xxx, appSecret 是 xxx ,帮我配置一下步骤 11重启 OpenClaw# 重启服务openclaw gateway# 检查状态openclaw status预期输出✓ OpenClaw 运行中 ✓ Gateway: http://0.0.0.0:18789 ✓ 飞书通道: 已连接测试机器人由于本地部署无法实现双向交流其实也可以通过ngrok 实现但是不安全所以这里是实现单项推送。首先我们已经配置好了机器人和开发者应用的信息。那么怎么让机器人给我们的飞书发送消息呢。首先每个飞书在每个开发者应用中都有一个唯一的openid 同一个飞书用户在不同的应用下openid 不同所以我们需要获取在对应应用下的openid 。正常我们是看不到的需要通过接口获取。#!/bin/bash# 配置区域 (请修改这里) APP_IDcli_xxxAPP_SECRETxxxPHONE_NUMBERxxxx# 替换为你要查询的手机号 (不需要加86接口通常自动识别或根据企业设置若报错可尝试 86156...)# echo 开始执行三步查询流程...echo--------------------------------------------------# --- 第一步获取 tenant_access_token ---echo1️⃣ 正在获取 Access Token...TOKEN_RESP$(curl-s-XPOSThttps://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal\-HContent-Type: application/json\-d{\app_id\:\$APP_ID\,\app_secret\:\$APP_SECRET\})# 解析 TokenACCESS_TOKEN$(echo$TOKEN_RESP|grep-otenant_access_token:[^]*|cut-d-f4)if[-z$ACCESS_TOKEN];thenecho❌ 第一步失败无法获取 Token。echo返回信息:$TOKEN_RESPexit1fiecho✅ Token 获取成功:${ACCESS_TOKEN:0:10}...echo# --- 第二步通过手机号获取 user_id ---echo2️⃣ 正在通过手机号 ($PHONE_NUMBER) 查询 user_id...# 注意根据你的案例mobiles 数组直接传字符串即可STEP2_RESP$(curl-s-XPOSThttps://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_typeuser_id\-HAuthorization: Bearer$ACCESS_TOKEN\-HContent-Type: application/json\-d{\emails\: [],\include_resigned\: false,\mobiles\: [\$PHONE_NUMBER\] })# 解析 user_id (从 data.user_list[0].user_id 中提取)# 使用 python 解析更稳妥如果没装 python 则用 grep/sed 简易解析ifcommand-vpython3/dev/null;thenUSER_ID$(echo$STEP2_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user_list,[{}])[0].get(user_id,))2/dev/null)else# 简易解析 fallbackUSER_ID$(echo$STEP2_RESP|grep-ouser_id:[^]*|head-1|cut-d-f4)fiif[-z$USER_ID];thenecho❌ 第二步失败未找到 user_id。echo返回信息:$STEP2_RESPecho 提示请检查手机号是否正确或应用是否有【读取用户手机号】权限。exit1fiecho✅ 找到 user_id:$USER_IDecho# --- 第三步通过 user_id 获取 open_id ---echo3️⃣ 正在通过 user_id ($USER_ID) 查询 open_id...# 构造 URL: .../users/{user_id}?department_id_typeopen_department_iduser_id_typeuser_idTARGET_URLhttps://open.feishu.cn/open-apis/contact/v3/users/${USER_ID}?department_id_typeopen_department_iduser_id_typeuser_idSTEP3_RESP$(curl-s-XGET$TARGET_URL\-HAuthorization: Bearer$ACCESS_TOKEN)# 解析 open_idifcommand-vpython3/dev/null;thenOPEN_ID$(echo$STEP3_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user,{}).get(open_id,))2/dev/null)NAME$(echo$STEP3_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user,{}).get(name,))2/dev/null)elseOPEN_ID$(echo$STEP3_RESP|grep-oopen_id:[^]*|head-1|cut-d-f4)NAME$(echo$STEP3_RESP|grep-oname:[^]*|head-1|cut-d-f4)fiif[-z$OPEN_ID];thenecho❌ 第三步失败未找到 open_id。echo返回信息:$STEP3_RESPecho 提示请检查应用是否有【读取用户信息】权限。exit1fiecho--------------------------------------------------echo 查询成功echo 姓名$NAMEecho User ID:$USER_IDecho Open ID :$OPEN_IDecho--------------------------------------------------修改上面的3个配置APP_ID“cli_xxx”APP_SECRET“xxx”PHONE_NUMBER“xxxx” # 替换为你要查询的手机号 (不需要加86接口通常自动识别或根据企业设置若报错可尝试 “86156…”)然后保存为lark.sh。 然后 sh lark.sh(如果是win就把这段代码给到豆包让它翻译成win 版本的拿到openid 之后告诉小龙虾你的飞书用户openid 是这个。让它记下来。然后就可以告诉小龙虾做一些事情了比如写一篇最新的育儿文章然后发到你的飞书。
小龙虾配置飞书机器人（适合本地部署）
OpenClaw 手把手教学配置飞书机器人 目录前置准备创建飞书应用配置机器人能力获取必要凭证配置 OpenClaw测试机器人前置准备在开始之前请确保你具备以下条件✅ 必需条件OpenClaw 已安装# 检查是否已安装openclaw--version飞书管理员权限需要创建企业自建应用的权限或联系管理员协助创建 准备清单OpenClaw 已安装并运行有飞书企业管理员权限基本的命令行操作能力创建飞书应用步骤 1进入飞书开放平台打开浏览器访问 飞书开放平台使用书账号登录点击右上角“开发者后台”步骤 2创建企业自建应用点击“创建企业自建应用”填写应用信息应用名称OpenClaw AI 助手可自定义应用描述基于 OpenClaw 的 AI 智能助手可自定义应用图标上传一个喜欢的图标建议 120x120点击“创建”步骤 3记录应用信息创建成功后你会看到App ID: cli_xxxxxxxxxxxxxxxx App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx⚠️重要立即保存这两个值后面会用到配置机器人能力步骤 4启用机器人功能在应用详情里面添加应用能力选择机器人。步骤 5配置权限点击左侧“权限管理”搜索并添加以下权限权限名称权限标识用途获取与发送单聊、群组消息im:message接收和发送消息获取用户基本信息contact:user.base:readonly获取用户信息获取群组信息im:chat:readonly获取群聊信息发送富文本消息im:message:send_as_bot以机器人身份发送消息点击“批量添加”→“确认”步骤 6发布版本重要点击左侧“版本管理与发布”点击“创建版本”填写版本信息版本号1.0.0更新说明首次发布支持基础对话功能点击“保存”点击“申请发布”等待管理员审批通常几分钟内获取必要凭证步骤 7获取 App ID 和 App Secret在应用详情页点击左侧“凭证与基础信息”你会看到App ID: cli_xxx App Secret: xxxxx就是前面保存的。这个是开发者应用的凭证。其实也是对应机器人的凭证。配置 OpenClaw步骤 8创建配置文件编辑 OpenClaw 配置文件或者直接和龙虾对话配置我正在配置飞书对应的开发者应用 appid 是 xxx, appSecret 是 xxx ,帮我配置一下步骤 11重启 OpenClaw# 重启服务openclaw gateway# 检查状态openclaw status预期输出✓ OpenClaw 运行中 ✓ Gateway: http://0.0.0.0:18789 ✓ 飞书通道: 已连接测试机器人由于本地部署无法实现双向交流其实也可以通过ngrok 实现但是不安全所以这里是实现单项推送。首先我们已经配置好了机器人和开发者应用的信息。那么怎么让机器人给我们的飞书发送消息呢。首先每个飞书在每个开发者应用中都有一个唯一的openid 同一个飞书用户在不同的应用下openid 不同所以我们需要获取在对应应用下的openid 。正常我们是看不到的需要通过接口获取。#!/bin/bash# 配置区域 (请修改这里) APP_IDcli_xxxAPP_SECRETxxxPHONE_NUMBERxxxx# 替换为你要查询的手机号 (不需要加86接口通常自动识别或根据企业设置若报错可尝试 86156...)# echo 开始执行三步查询流程...echo--------------------------------------------------# --- 第一步获取 tenant_access_token ---echo1️⃣ 正在获取 Access Token...TOKEN_RESP$(curl-s-XPOSThttps://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal\-HContent-Type: application/json\-d{\app_id\:\$APP_ID\,\app_secret\:\$APP_SECRET\})# 解析 TokenACCESS_TOKEN$(echo$TOKEN_RESP|grep-otenant_access_token:[^]*|cut-d-f4)if[-z$ACCESS_TOKEN];thenecho❌ 第一步失败无法获取 Token。echo返回信息:$TOKEN_RESPexit1fiecho✅ Token 获取成功:${ACCESS_TOKEN:0:10}...echo# --- 第二步通过手机号获取 user_id ---echo2️⃣ 正在通过手机号 ($PHONE_NUMBER) 查询 user_id...# 注意根据你的案例mobiles 数组直接传字符串即可STEP2_RESP$(curl-s-XPOSThttps://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_typeuser_id\-HAuthorization: Bearer$ACCESS_TOKEN\-HContent-Type: application/json\-d{\emails\: [],\include_resigned\: false,\mobiles\: [\$PHONE_NUMBER\] })# 解析 user_id (从 data.user_list[0].user_id 中提取)# 使用 python 解析更稳妥如果没装 python 则用 grep/sed 简易解析ifcommand-vpython3/dev/null;thenUSER_ID$(echo$STEP2_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user_list,[{}])[0].get(user_id,))2/dev/null)else# 简易解析 fallbackUSER_ID$(echo$STEP2_RESP|grep-ouser_id:[^]*|head-1|cut-d-f4)fiif[-z$USER_ID];thenecho❌ 第二步失败未找到 user_id。echo返回信息:$STEP2_RESPecho 提示请检查手机号是否正确或应用是否有【读取用户手机号】权限。exit1fiecho✅ 找到 user_id:$USER_IDecho# --- 第三步通过 user_id 获取 open_id ---echo3️⃣ 正在通过 user_id ($USER_ID) 查询 open_id...# 构造 URL: .../users/{user_id}?department_id_typeopen_department_iduser_id_typeuser_idTARGET_URLhttps://open.feishu.cn/open-apis/contact/v3/users/${USER_ID}?department_id_typeopen_department_iduser_id_typeuser_idSTEP3_RESP$(curl-s-XGET$TARGET_URL\-HAuthorization: Bearer$ACCESS_TOKEN)# 解析 open_idifcommand-vpython3/dev/null;thenOPEN_ID$(echo$STEP3_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user,{}).get(open_id,))2/dev/null)NAME$(echo$STEP3_RESP|python3-cimport sys, json;djson.load(sys.stdin);print(d.get(data,{}).get(user,{}).get(name,))2/dev/null)elseOPEN_ID$(echo$STEP3_RESP|grep-oopen_id:[^]*|head-1|cut-d-f4)NAME$(echo$STEP3_RESP|grep-oname:[^]*|head-1|cut-d-f4)fiif[-z$OPEN_ID];thenecho❌ 第三步失败未找到 open_id。echo返回信息:$STEP3_RESPecho 提示请检查应用是否有【读取用户信息】权限。exit1fiecho--------------------------------------------------echo 查询成功echo 姓名$NAMEecho User ID:$USER_IDecho Open ID :$OPEN_IDecho--------------------------------------------------修改上面的3个配置APP_ID“cli_xxx”APP_SECRET“xxx”PHONE_NUMBER“xxxx” # 替换为你要查询的手机号 (不需要加86接口通常自动识别或根据企业设置若报错可尝试 “86156…”)然后保存为lark.sh。 然后 sh lark.sh(如果是win就把这段代码给到豆包让它翻译成win 版本的拿到openid 之后告诉小龙虾你的飞书用户openid 是这个。让它记下来。然后就可以告诉小龙虾做一些事情了比如写一篇最新的育儿文章然后发到你的飞书。
