Excel Plugin

Native OpenClaw plugin that adds local .xlsx workbook tools with:

• workbook sheet inspection and basic sheet metadata
• row-based reads from a selected sheet with pagination
• sheet replacement from structured JSON rows
• row appends that preserve existing workbook sheets

Install

npm install
npm run build
openclaw plugins install .
openclaw plugins enable excel
openclaw gateway restart

Config

{
  plugins: {
    entries: {
      excel: {
        enabled: true,
        config: {
          defaultDirectory: "~/Documents",
          maxRows: 500,
        },
      },
    },
  },
}

defaultDirectory is optional and only affects relative paths. maxRows defaults to 500.

Tools

• excel_list_sheets
• excel_read_sheet
• excel_replace_sheet
• excel_append_rows

Usage

After enabling excel, ask for things like:

• List the sheets in ~/Documents/report.xlsx.
• Read the first 50 rows from the Pipeline sheet.
• Replace the Summary sheet in report.xlsx with these rows.
• Append these new leads to the Leads sheet.

The plugin works on local .xlsx files and returns structured row data in the tool details.