feishu-group-msg-sync.xiaokui/references/lark-cli-cheatsheet.md

lark-cli 消息和表格操作速查

拉取群消息

lark-cli im +chat-messages-list \
    --chat-id "oc_xxx" \
    --start "2026-04-10T00:00:00+08:00" \
    --end "2026-04-10T23:59:59+08:00" \
    --sort asc \
    --page-size 50 \
    --as bot

注意：

• --start/--end 使用 ISO 8601 格式（含时区）
• --sort 值为 asc 或 desc（不是 create_time_asc）
• --page-size 范围 1-50

下载消息资源

# 图片（--type image）
lark-cli im +messages-resources-download \
    --message-id "om_xxx" \
    --file-key "img_xxx" \
    --type image \
    --output "filename.png" \
    --as bot

# 文件/视频/音频（--type file）
lark-cli im +messages-resources-download \
    --message-id "om_xxx" \
    --file-key "file_xxx" \
    --type file \
    --output "filename.mp4" \
    --as bot

注意：

• --output 不支持绝对路径，必须使用相对路径
• 需要先 cd 到目标目录再执行

电子表格操作

查看表格信息

lark-cli sheets +info --spreadsheet-token "xxx" --as bot

读取数据

lark-cli sheets +read \
    --spreadsheet-token "xxx" \
    --range "{sheet_id}!A1:D10" \
    --as bot

追加行

lark-cli sheets +append \
    --spreadsheet-token "xxx" \
    --sheet-id "{sheet_id}" \
    --range "{sheet_id}!A:D" \
    --values '[["val1","val2","val3","val4"]]' \
    --as bot

覆盖写入

lark-cli sheets +write \
    --spreadsheet-token "xxx" \
    --range "{sheet_id}!A2:D10" \
    --values '[["a","b","c","d"]]' \
    --as bot