本地部署 OpenClaw 配置飞书机器人指南

2. 重启服务

配置完成后，重启网关服务并检查状态：

# 重启服务
openclaw gateway

# 检查状态
openclaw status

预期输出应包含类似以下内容：

✓ OpenClaw 运行中 ✓ Gateway: http://0.0.0.0:18789 ✓ 飞书通道：已连接 

获取用户 OpenID

由于本地部署无法直接实现双向实时交互（除非使用 ngrok 等工具，但存在安全风险），我们主要实现单向消息推送。为此，我们需要获取目标用户在当前应用下的 OpenID。

每个飞书用户在不同的开发者应用中拥有唯一的 OpenID，且无法直接查看，需要通过接口查询。下面提供一个 Shell 脚本来完成查询流程。

查询脚本

新建一个文件（如 lark.sh），填入以下内容：

#!/bin/bash
# =================🔧 配置区域 (请修改这里) =================
APP_ID="cli_xxx"
APP_SECRET="xxx"
PHONE_NUMBER="xxxx" # 替换为你要查询的手机号 (不需要加 +86)
# =======================================================
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..."
STEP2_RESP=$(curl -s -X POST "https://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_type=user_id" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d "{ \"emails\": [], \"include_resigned\": false, \"mobiles\": [ \"$PHONE_NUMBER\"] }")

# 解析 user_id
if command -v python3 &> /dev/null; then
    USER_ID=$(echo "$STEP2_RESP" | python3 -c "import sys, json;d=json.load(sys.stdin); print(d.get('data',{}).get('user_list',[{}])[0].get('user_id',''))" 2>/dev/null)
else
    USER_ID=$(echo "$STEP2_RESP" | grep -o '"user_id":"[^"]*"' | head -1 | cut -d'"' -f4)
fi

if [ -z "$USER_ID" ]; then
    echo "❌ 第二步失败：未找到 user_id。"
    echo "💡 提示：请检查手机号是否正确，或应用是否有【读取用户手机号】权限。"
    exit 1
fi
echo "✅ 找到 user_id: $USER_ID"
echo ""

# --- 第三步：通过 user_id 获取 open_id ---
echo "3️⃣ 正在通过 user_id ($USER_ID) 查询 open_id..."
TARGET_URL="https://open.feishu.cn/open-apis/contact/v3/users/${USER_ID}?department_id_type=open_department_id&user_id_type=user_id"
STEP3_RESP=$(curl -s -X GET "$TARGET_URL" \
-H "Authorization: Bearer $ACCESS_TOKEN")

# 解析 open_id
if command -v python3 &> /dev/null; then
    OPEN_ID=$(echo "$STEP3_RESP" | python3 -c "import sys, json;d=json.load(sys.stdin); print(d.get('data',{}).get('user',{}).get('open_id',''))" 2>/dev/null)
    NAME=$(echo "$STEP3_RESP" | python3 -c "import sys, json;d=json.load(sys.stdin); print(d.get('data',{}).get('user',{}).get('name',''))" 2>/dev/null)
else
    OPEN_ID=$(echo "$STEP3_RESP" | grep -o '"open_id":"[^"]*"' | head -1 | cut -d'"' -f4)
    NAME=$(echo "$STEP3_RESP" | grep -o '"name":"[^"]*"' | head -1 | cut -d'"' -f4)
fi

if [ -z "$OPEN_ID" ]; then
    echo "❌ 第三步失败：未找到 open_id。"
    echo "💡 提示：请检查应用是否有【读取用户信息】权限。"
    exit 1
fi

echo "--------------------------------------------------"
echo "🎉 查询成功！"
echo "👤 姓名：$NAME"
echo "🆔 User ID: $USER_ID"
echo "🔑 Open ID : $OPEN_ID"
echo "--------------------------------------------------"

使用说明

1. 修改脚本中的 APP_ID、APP_SECRET 和 PHONE_NUMBER。
2. 赋予执行权限并运行：chmod +x lark.sh && ./lark.sh。
3. 如果是 Windows 环境，可将脚本逻辑转换为 PowerShell 或使用 WSL 运行。

拿到 OpenID 后，将其告知 OpenClaw 系统，让它记录该用户身份。之后即可尝试让机器人执行任务，例如撰写文章并推送到你的飞书账号。

测试验证

配置完成后，可以通过简单的指令测试消息推送功能。如果一切正常，你应该能在飞书中收到来自机器人的回复或通知。