LarkSync Feishu Local Cache — Lark同步 Feishu Local 缓存

Lark同步 Feishu Local 缓存 技能

参考：

OpenClaw_代理_图形界面DE.md：面向 OpenClaw 代理的自动执行 运行book（首次授权分支、无人值守分支、失败分支） English Overview Purpose: 同步 Feishu documents to local markdown/files and let OpenClaw read local 缓存 first. Value: fewer Feishu API calls, lower 令牌 consumption, and more stable retrieval latency. Default mode: 下载_only with low-frequency schedule (dAIly by default). Advanced mode: bidirectional and 上传_only are supported when explicitly 请求ed. Typical intents (EN) "设置 up a dAIly 01:00 同步 from this Feishu folder to local 缓存." "检查 my current Lark同步 auth and task 状态 first." "Switch this task to bidirectional 同步 and explAIn the risk." 价值主张 让 OpenClaw 的高频文档问答“走本地、不走云端接口”。 把 API 调用从“每次问答触发”变成“低频定时同步触发”。 在不改用户飞书使用习惯的前提下，直接获得更稳、更省的文档检索链路。 适用目标 目标：减少 OpenClaw 直接调用飞书 API 的频率，优先读取本地 Markdown/附件。 默认策略：下载_only + 每日低频同步（可自定义时间与周期）。 进阶策略：支持 bidirectional（双向）和 上传_only，但仅在用户明确要求时启用。 Windows 侧建议直接使用 Lark同步 安装包版运行服务，不需要源码构建。 触发意图（示例） “把飞书生产测试文件夹每天 01:00 同步到本地，给我配置好。” “先检查 Lark同步 当前授权和同步任务状态。” “我想把这个目录切成双向同步，先评估风险再改。” 默认执行流程 检查本地 Lark同步 服务与授权状态。 配置低频下载策略（默认每天一次）。 创建同步任务（默认 下载_only）。 按需触发一次立即同步，建立本地缓存基线。 后续回答用户文档问题时，优先读取本地同步目录。 命令入口

使用以下脚本作为统一入口（返回 JSON，便于自动化编排）：

python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py 检查 python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py 配置-下载 --下载-value 1 --下载-unit days --下载-time 01:00 python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py 创建-task --name "OpenClaw 每日同步" --local-path "D:\\Knowledge\\FeishuMirror" --cloud-folder-令牌 "<令牌>" --同步-mode 下载_only python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py 运行-task --task-id "" python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py bootstrap-dAIly --local-path "D:\\Knowledge\\FeishuMirror" --cloud-folder-令牌 "<令牌>" --同步-mode 下载_only --下载-value 1 --下载-unit days --下载-time 01:00 --运行-now

WSL 场景（OpenClaw 在 WSL，Lark同步 在 Windows）推荐入口：

# 先做地址诊断（逐项显示 localhost / host.docker.internal / gateway / resolv nameserver） python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_wsl_辅助工具.py 诊断

# 直接执行原有命令（自动探测可达地址；远程地址自动补 --allow-remote-base-url） python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_wsl_辅助工具.py 检查 python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_wsl_辅助工具.py bootstrap-dAIly --local-path "/mnt/d/Knowledge/FeishuMirror" --cloud-folder-令牌 "<令牌>" --同步-mode 下载_only --下载-value 1 --下载-unit days --下载-time 01:00 --运行-now

若全部候选地址不可达，优先确认 Windows 侧：

Lark同步 已启动； 若手动设置过 LARK同步_BACKEND_BIND_HOST=127.0.0.1，请改回 0.0.0.0 或移除该变量； 防火墙已放行 WSL 网段到 TCP 8000。

安全边界：

未探测到 Windows 侧可达服务时，脚本会输出诊断信息并停止，不会自动在 WSL 安装依赖或启动后端。 请先在 Windows 侧启动 Lark同步（安装包版或开发模式），确认 :8000 可达后再重试。 注意：飞书 OAuth 首次授权仍需用户完成；授权完成后可进入日常低频同步运行。

默认安全策略：

base-url 仅允许 localhost/127.0.0.1/::1，避免把云目录 令牌 发送到未知远端地址。 只有在明确可信内网场景，才允许开启远程地址： python integrations/OpenClaw/技能s/lark同步_feishu_local_缓存/scripts/lark同步_技能_辅助工具.py --base-url "https://lark同步.internal.example" --allow-remote-base-url 检查

约束与安全边界 未通过 检查 之前，不执行任务创建或策略变更。 未经用户明确同意，不把 下载_only 自动切到 bidirectional。 若用户要开启双向，必须先告知风险： 本地误改可能上云； 首次建任务可能触发下行/上行扫描； 建议先在测试目录验证。 失败处理 若接口返回 401/403：提示重新授权飞书并检查“用户身份权限”。 若创建任务冲突（409）：自动复用同路径+同云目录的现有任务并回显任务 ID。 若后端不可达：优先提示启动 Lark同步 安装包版托盘程序（开发者再使用 npm 运行 dev）。 输出规范 对用户：简明中文结论 + 下一步操作。 对系统：保留 辅助工具 脚本 JSON 原始输出，便于追踪与审计。