文档首页 · English

📡 通道

LemonClaw 通过可插拔的输入通道接收事件,并把回复广播给所有启用的输出通道。所有通道都发布到同一条消息总线,由 Agent 循环消费。终端始终输出;开启飞书后,终端与飞书会同时收到回复。

通道 方向 说明
终端 输入/输出 始终开启。交互式 stdin + rich 终端输出。
Webhook 输入 HTTP 服务(默认 127.0.0.1:8765)。可选 X-Auth-Token 鉴权与每分钟限频。ENABLE_WEBHOOK=true 开启。
飞书/Lark 输入/输出 机器人消息。需 ENABLE_FEISHU=true 加上 FEISHU_APP_ID / FEISHU_APP_SECRET,并在飞书开发者后台配置事件订阅。个人专用模式下,首个向机器人发消息的飞书用户会被自动绑定(持久化在 lemonclaw.db),其他飞书用户的消息会被忽略;所有飞书输出固定回复给该绑定用户,同时终端始终输出。支持接收文件/图片/音视频并保存到 FEISHU_RECEIVED_DIR;纯文件消息会暂存,等用户补充文本后再与该轮文本一起进入 Agent。
Cron 输入 定时任务。始终开启;任务可在运行时通过 /cron 命令或 cron 工具管理。

飞书回复与状态

主 Agent 最终回复使用支持 Markdown 的飞书卡片,顶部显示事件类型;命令和其他系统消息可能使用各自的消息格式。用户请求处理期间显示 Typing 表情,成功得到非空答复后转换为 DONE;异常或中断时清理 Typing。需要 im:message.reactions:write_only 权限;表情失败不阻止消息处理。后台工作流的 DONE 仅表示前台本轮回复完成。

待补充:飞书接入教程

需要补充创建应用、完整权限清单、订阅事件、启用长连接、发布应用及首次绑定的逐步截图。人工确认还需 card.action.trigger 回调配置,见人工确认。

待补充:Webhook 示例

需要补充经过验证的请求结构、鉴权请求和异步结果消费示例。网络设置见部署说明。