Shell / BashSaaSAI
OpenClaw 配置飞书机器人教程（本地部署）
如何在本地部署环境下配置 OpenClaw 以连接飞书机器人。主要步骤包括在飞书开放平台创建企业自建应用、配置必要权限并获取凭证、在 OpenClaw 中填入配置信息。此外，提供了通过 Shell 脚本查询用户 OpenID 的方法，以便实现消息推送测试。整个过程适用于具备基本命令行操作能力的开发者。
如何在本地部署环境下配置 OpenClaw 以连接飞书机器人。主要步骤包括在飞书开放平台创建企业自建应用、配置必要权限并获取凭证、在 OpenClaw 中填入配置信息。此外，提供了通过 Shell 脚本查询用户 OpenID 的方法，以便实现消息推送测试。整个过程适用于具备基本命令行操作能力的开发者。
在开始之前，请确保你具备以下条件：
OpenClaw 已安装
# 检查是否已安装 openclaw --version
OpenClaw AI 助手（可自定义）基于 OpenClaw 的 AI 智能助手（可自定义）创建成功后，你会看到：
App ID: cli_xxxxxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ 重要：立即保存这两个值，后面会用到！
在应用详情里面，添加应用能力，选择机器人。
| 权限名称 | 权限标识 | 用途 |
|---|---|---|
| 获取与发送单聊、群组消息 | im:message | 接收和发送消息 |
| 获取用户基本信息 | contact:user.base:readonly | 获取用户信息 |
| 获取群组信息 | im:chat:readonly | 获取群聊信息 |
| 发送富文本消息 | im:message:send_as_bot | 以机器人身份发送消息 |
点击 '批量添加' → '确认'
1.0.0首次发布，支持基础对话功能你会看到：
App ID: cli_xxx
App Secret: xxxxx
这是开发者应用的凭证，也是对应机器人的凭证。
编辑 OpenClaw 配置文件，或者直接通过对话配置：我正在配置飞书，对应的开发者应用 appid 是 xxx, appSecret 是 xxx ,帮我配置一下。
# 重启服务
openclaw gateway
# 检查状态
openclaw status
预期输出：
✓ OpenClaw 运行中
✓ Gateway: http://0.0.0.0:18789
✓ 飞书通道：已连接
由于本地部署无法实现双向交流（其实也可以通过 ngrok 实现，但是不安全），所以这里是实现单项推送。
首先我们已经配置好了机器人和开发者应用的信息。那么怎么让机器人给我们的飞书发送消息呢？
每个飞书用户在每个开发者应用中都有一个唯一的 openid（同一个飞书用户在不同的应用下 openid 不同），所以我们需要获取在对应应用下的 openid。正常我们是看不到的，需要通过接口获取。
#!/bin/bash
# =================🔧 配置区域 (请修改这里) =================
APP_ID="cli_xxx"
APP_SECRET="xxx"
PHONE_NUMBER="xxxx" # 替换为你要查询的手机号 (不需要加 +86，接口通常自动识别或根据企业设置，若报错可尝试 "+86156...")
# =======================================================
echo "🚀 开始执行三步查询流程..."
echo "--------------------------------------------------"
# --- 第一步：获取 tenant_access_token ---
echo "1️⃣ 正在获取 Access Token..."
TOKEN_RESP=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
-H "Content-Type: application/json" \
-d "{ \"app_id\": \"$APP_ID\", \"app_secret\": \"$APP_SECRET\" }")
# 解析 Token
ACCESS_TOKEN=$(echo "$TOKEN_RESP" | grep -o '"tenant_access_token":"[^"]*"' | cut -d'"' -f4)
if [ -z "$ACCESS_TOKEN" ]; then
echo "❌ 第一步失败：无法获取 Token。"
echo "返回信息：$TOKEN_RESP"
exit 1
fi
echo "✅ Token 获取成功：${ACCESS_TOKEN:0:10}..."
echo ""
# --- 第二步：通过手机号获取 user_id ---
echo "2️⃣ 正在通过手机号 ($PHONE_NUMBER) 查询 user_id..."
# 注意：根据你的案例，mobiles 数组直接传字符串即可
STEP2_RESP=$(curl -s -X POST \
-H \
-H \
-d )
-v python3 &> /dev/null;
USER_ID=$( | python3 -c 2>/dev/null)
USER_ID=$( | grep -o | -1 | -d -f4)
[ -z ];
1
TARGET_URL=
STEP3_RESP=$(curl -s -X GET \
-H )
-v python3 &> /dev/null;
OPEN_ID=$( | python3 -c 2>/dev/null)
NAME=$( | python3 -c 2>/dev/null)
OPEN_ID=$( | grep -o | -1 | -d -f4)
NAME=$( | grep -o | -1 | -d -f4)
[ -z ];
1
修改上面的 3 个配置：
然后保存为 lark.sh。然后 sh lark.sh(如果是 win，就把这段代码给到豆包，让它翻译成 win 版本的）
拿到 openid 之后，告诉 OpenClaw，你的飞书用户 openid 是这个。让它记下来。
然后就可以告诉 OpenClaw 做一些事情了，比如写一篇最新的育儿文章，然后发到你的飞书。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online