| name | feishu-bot-refresh |
| description | Refresh Feishu bot identity information. Activate when user sends /refresh-bot-name or mentions refreshing bot name.
|
Feishu Bot Identity Refresh
Refreshes the bot's identity information from Feishu API when requested by user.
Trigger Conditions
Activate when user message contains:
/refresh-bot-name刷新机器人名称更新机器人信息refresh bot name
Execution Steps
1. Get Current Account Configuration
Read the current account's app_id and app_secret from ~/.openclaw/openclaw.json:
{
"channels": {
"feishu": {
"accounts": {
"dev-1": {
"appId": "cli_a93e6ea211b89cd2",
"appSecret": "xxx"
}
}
}
}
}
2. Get Tenant Access Token
Call Feishu API:
curl -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
-H "Content-Type: application/json" \
-d '{
"app_id": "<appId>",
"app_secret": "<appSecret>"
}'
Response:
{
"code": 0,
"tenant_access_token": "t-xxx",
"expire": 7200
}
3. Query Bot Info
Call Feishu API:
curl -X GET "https://open.feishu.cn/open-apis/bot/v3/info" \
-H "Authorization: Bearer <tenant_access_token>"
Response:
{
"code": 0,
"bot": {
"activate_status": 2,
"app_name": "OCT10-开发 1",
"avatar_url": "https://xxx",
"open_id": "ou_xxx"
}
}
4. Save to Identity File
Write to ~/.openclaw/agents/main/sessions/bot-identity.json:
{
"feishu": {
"appId": "<current_app_id>",
"appName": "<app_name from API>",
"openId": "<open_id from API>",
"activateStatus": 2,
"avatarUrl": "<avatar_url from API>",
"queriedAt": "<ISO 8601 timestamp>"
}
}
5. Reply to User
Confirm the refresh with formatted output:
✅ 机器人信息已刷新：
- **名称：** OCT10-开发 1
- **OpenID：** ou_xxx
- **激活状态：** 已激活
- **查询时间：** 2026-03-19 23:50:00
Error Handling
| Error | Response |
|---|
| API call failed | ❌ 刷新失败：{error message} |
| Invalid token | ❌ 刷新失败：凭证无效，请检查飞书应用配置 |
| File write failed | ❌ 刷新失败：无法保存配置文件 |
Configuration
channels:
feishu:
tools:
bot_refresh: true
Permissions
Required: No special permissions needed (uses app's internal token)
Examples
User sends command
/refresh-bot-name
Bot responds
✅ 机器人信息已刷新：
- **名称：** OCT10-开发 1
- **OpenID：** ou_0900e4a9853a4369b7010352d36d8a6c
- **激活状态：** 已激活
- **查询时间：** 2026-03-19 23:50:00
Notes
- This is a user-triggered action, not automatic
- Cache does not expire automatically
- User should run this after changing bot name in Feishu platform
- Each account has its own identity file
