paper-reference

By Rafael Vieira 👁 6 views ▲ 0 votes

Paper reference toolkit for OpenClaw. Three deterministic tools: weight conversion (GSM, US basis weight, oz per sq yd); paper size lookup for 44 formats including ISO A/B/C, SRA, RA, US Letter/Legal/Tabloid, ANSI, ARCH, JIS B; and grade summary for 25 common paper grades (kraftliner, testliner, SBS, FBB, LWC, and more). Offline, no API, no config.

openclaw plugins install @worldpaperindex/openclaw-paper-reference

{
  "plugins": {
    "entries": {
      "paper-reference": {
        "enabled": true
      }
    }
  }
}

# Paper Reference Toolkit

An OpenClaw plugin with three small deterministic tools for everyday paper questions:

1. **`paper_weight_convert`** - GSM, US basis weight (bond, offset, cover, index, tag, bristol, newsprint), and ounces per square yard.
2. **`paper_size_lookup`** - Dimensions for 44 paper formats: ISO A / B / C, SRA, RA, US Letter / Legal / Tabloid, ANSI, ARCH, and JIS B.
3. **`paper_grade_summary`** - Typical GSM range, fiber source, key uses, and a one-paragraph description for 25 common paper grades (kraftliner, testliner, fluting, newsprint, UWF, CWF, LWC, MWC, SC, SBS, FBB, SUS, WLC, tissue, sack kraft, MG kraft, thermal, glassine, greaseproof, NCR, release liner, LPB, extensible kraft, bristol, cover stock).

No network. No API key. No config. Everything ships inside the plugin.

## Install

```bash
openclaw plugins install @worldpaperindex/openclaw-paper-reference
```

## Example interactions

"Convert 80 gsm to lb bond" -> `paper_weight_convert({value: 80, from: "gsm", to: "lb", basis: "bond"})` -> `21.276 lb (bond basis)`.

"What size is A4?" -> `paper_size_lookup({name: "A4"})` -> `210 x 297 mm / 8.27 x 11.69 inches`.

"Tell me about SBS" -> `paper_grade_summary({grade: "SBS"})` -> full grade reference with WPI deep link.

## Why

Three things come up constantly when working with paper and get slightly wrong answers from LLMs on their own:

- US basis weight varies by paper class (20 lb bond != 20 lb cover).
- Paper size standards are not memorized perfectly (SRA3 vs A3 trips up even experts).
- Grade nomenclature is regional (testliner, WLC, GD, FBB, SBB, CUK are the same board family with different codes).

This plugin gives the agent a deterministic source of truth for those three.

## Develop

```bash
npm install
npm run typecheck
npm test
npm run build
```

## License

MIT. See [LICENSE](./LICENSE).

Grade data and mill directory at [worldpaperindex.com](https://worldpaperindex.com).