用途：通过 OpenClaw 工具在飞书/Lark 中可靠写入排版良好的 Docx 文档，覆盖工具选择、分块写入、原生表格、$ 符号转义与已知坑位。
主要能力与用法：新建文档用 feishu_doc(action="create") 并获取 doc_token；首段内容用 feishu_doc(action="write")（会覆盖整个文档）；后续内容用 feishu_doc(action="append") 追加，每次不超过 1500 字，超长会返回 400，长报告按章节自然分 4-5 次追加，不要在段落中间断开。表格需用 feishu_table.py 创建原生表格，Markdown 表格经 append 会散落成碎片文本；调用示例：from feishu_table import create_table，create_table(doc_token, [["列1","列2","列3"],["数据1","数据2","数据3"]], header_bold=True)。飞书会把 $...$ 当 LaTeX 公式渲染，含美元符号时改用“82.78美元”或“USD 82.78”。
格式建议：支持 # ## ### 标题、无序列表（2 空格缩进嵌套）、有序列表、代码块、加粗斜体、分割线、短段落；避免 Markdown 表格、超长段落、$ 符号、超过 3 层的深层嵌套列表。
长文档模式：由 sub-agent 搜索收集数据、主 session 综合写作，因 sub-agent maxTokens 限制（16k）会截断 content；若必须用 sub-agent，需明确分块写入每块不超过 3000 字，或用 exec heredoc 分块写本地文件再上传。注意 context 膨胀，可用 sub-agent 隔离大量文本操作、用 tail/head 限制输出行数，写完长文档后可能需重启 gateway。
权限：新建文档默认设为“互联网获得链接即可访问”，可用 feishu_perm(action="add", token=doc_token, type="docx", member_type="openchat", member_id="oc_xxx", perm="view")。
限制与常见错误：不要用 create_feishu_doc（存在 JSON parse bug）；append 400 多为单次内容过长；表格碎片需改用 feishu_table.py；$ 变公式需替换写法；sub-agent 写入空白多为 maxTokens 截断；上游 400 bad request 多为 context 过大，需重启 gateway。