Excel / XLSX: 专业电子表格自动化 - Openclaw Skills

作者:互联网

2026-04-16

Excel

什么是 Excel / XLSX?

Openclaw Skills 的 Excel / XLSX 技能提供了一个处理 Microsoft Excel 文件(包括 .xlsx、.xls 和 .xlsm 格式)的稳健框架。它超越了简单的文件读取,解决了电子表格数据的复杂细微差别,例如 Excel 特定的日期序列化系统和数值的 15 位精度限制。 该技能确保了 Windows、macOS 和 Linux 环境之间的跨平台兼容性。通过实施内存管理和数据完整性的最佳实践,它允许 AI 代理通过流式传输处理大型数据集,同时保持正确的单元格格式和公式计算。

下载入口:https://github.com/openclaw/skills/tree/main/skills/ivangdavila/excel-xlsx

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install excel-xlsx

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 excel-xlsx。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Excel / XLSX 应用场景

  • 以 .xlsx 格式生成复杂的财务报告或数据导出。 - 将旧版 .xls 文件批量处理为现代数据结构。 - 用于业务工作流程的自动化数据录入和公式计算。 - 在保持数值精度和日期格式的同时,清洗和转换大型数据集。 - 从多工作表工作簿中的合并单元格和隐藏行中提取数据。
Excel / XLSX 工作原理
  1. 该技能识别目标文件格式并确定适当的读取策略,对大文件使用流式传输以优化内存。 2. 它检测工作簿的日期系统(1900 与 1904),以确保从序列号进行准确的时间转换。 3. 在解析数据的同时处理类型强制转换,确保长 ID 或电话号码被视为文本以防止精度丢失。 4. 根据用户的特定要求评估公式或检索缓存值,以确保数据的实时性。 5. 该技能管理跨平台特性,如换行符渲染和单元格自动换行,以便在不同的电子表格软件中实现一致的显示。 6. 用户偏好和交互历史记录将本地持久化在专用的内存目录中。

Excel / XLSX 配置指南

要将此功能集成到您的工作流中,请通过 CLI 安装该技能。确保您拥有在本地创建内存存储目录所需的权限。 bash clawhub install excel-xlsx 首次使用时,该技能将初始化其配置。您可以通过编辑内存文件或在涉及 Openclaw Skills 的首次对话中提供偏好设置来自定义行为。

Excel / XLSX 数据架构与分类体系

该技能使用标准化的本地目录结构组织其持久性内存和配置,以确保隐私和本地优先的数据处理: | 文件 | 用途 | |------|---------| | ~/excel-xlsx/memory.md | 存储特定的用户偏好、首选工具和已识别的痛点。 | | memory-template.md | 为初始化新内存文件提供蓝图。 | 处理工作簿时,该技能遵循以下格式限制: - XLSX: 1,048,576 行和 16,384 列(现代标准)。 - XLS: 65,536 行和 256 列(旧版支持)。

name: Excel / XLSX
slug: excel-xlsx
version: 1.0.1
homepage: https://clawic.com/skills/excel-xlsx
description: Read, write, and generate Excel files with correct types, dates, formulas, and cross-platform compatibility.
changelog: Added Core Rules and modern skill structure
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":[]},"os":["linux","darwin","win32"]}}

Setup

On first use, read setup.md for integration guidelines. Ask user preferences naturally during conversation.

When to Use

User needs to read, write, or generate Excel files (.xlsx, .xls, .xlsm). Agent handles type coercion, date serialization, formula evaluation, and cross-platform quirks.

Architecture

Memory lives in ~/excel-xlsx/. See memory-template.md for structure.

~/excel-xlsx/
└── memory.md     # Preferences, tools, pain points

Quick Reference

Topic File
Setup setup.md
Memory template memory-template.md

Core Rules

1. Dates Are Serial Numbers

Excel stores dates as days since 1900-01-01 (Windows) or 1904-01-01 (Mac legacy). Check workbook date system before converting. Time is fractional: 0.5 = noon, 0.25 = 6 AM.

2. The 1900 Leap Year Bug

Excel incorrectly treats 1900 as a leap year. Serial 60 represents Feb 29, 1900 (invalid date). Account for this when calculating dates before March 1, 1900.

3. 15-Digit Precision Limit

Numbers beyond 15 digits silently truncate. Use TEXT format for: phone numbers, IDs, credit cards, any long numeric identifiers. Leading zeros also require TEXT.

4. Formulas vs Cached Values

Cells may contain both formula and cached result. Some readers return formula string, others return cached value. Force recalculation if cached values might be stale.

5. Merged Cells Are Traps

Only the top-left cell of a merged range holds the value. Reading other cells in the merge returns empty. Hidden rows/columns still contain data.

6. Cross-Platform Testing Required

Windows vs Mac Excel can differ in date system. LibreOffice/Google Sheets may not support all features. Always test roundtrip compatibility when generating files for unknown consumers.

7. Use Streaming for Large Files

Loading large files fully into RAM causes memory issues. Use streaming readers (row-by-row) for files with 100K+ rows. Empty rows at end may be padded by some writers.

Common Traps

  • Type inference on read → Numbers stored as text stay text; explicit conversion needed
  • Column index confusion → A=0 or A=1 varies by library; always verify convention
  • Newlines in cells works but cell needs "wrap text" format to display
  • External references[Book.xlsx]Sheet!A1 breaks when source file moves
  • Password protection → Trivial to break; not real security; encrypt file externally if needed
  • XLSM files → Contain macros (security risk); XLSB is binary (faster but less compatible)
  • Shared strings → Large files reuse text indices; libraries handle this, but be aware

Format Limits

Format Rows Columns Notes
XLSX 1,048,576 16,384 (XFD) Modern default
XLS 65,536 256 Legacy, avoid
CSV Unlimited Unlimited No formatting

Security & Privacy

Data that stays local:

  • All file processing happens locally
  • User preferences stored in ~/excel-xlsx/memory.md with consent
  • No external services called

This skill does NOT:

  • Send data to external endpoints
  • Require network access

Install with clawhub install if user confirms:

  • csv — CSV parsing and generation
  • data — Data processing patterns
  • data-analysis — Analysis workflows

Feedback

  • If useful: clawhub star excel-xlsx
  • Stay updated: clawhub sync