# feishu-notes-assistant

Self-contained OpenClaw skill package for:

- Feishu online notes workspace operations:
  - `create/read/update/delete/search`
  - image/file insertion
  - document comments
  - section-level updates
- meeting minutes processing as a secondary sub-capability (`Minutes -> Note`)

## Package layout

- `SKILL.md`: OpenClaw skill definition
- `scripts/run_meeting_minutes.py`: cross-platform minutes entrypoint
- `scripts/run_note_crud.py`: cross-platform note CRUD entrypoint
- `scripts/run_meeting_minutes.sh`: compatibility wrapper (delegates to Python)
- `scripts/run_note_crud.sh`: compatibility wrapper (delegates to Python)
- `scripts/openclaw_meeting_minutes.py`: downstream orchestrator
- `scripts/openclaw_notes_crud.py`: note workspace orchestrator
- `bin/<os>-<arch>/lark-cli-openclaw[.exe]`: bundled platform binaries

## Runtime requirements

- `python3`
- user must complete `lark-cli-openclaw auth login`
- recommended scopes:
  - `vc:note:read`
  - `minutes:minutes:readonly`
  - `minutes:minutes.artifacts:read`
  - `minutes:minutes.transcript:export`
  - `docx:document:create`
  - `docx:document:readonly`
- `docx:document:write_only`
- `search:docs:read`
- `docs:document.media:upload`
- `docs:document.media:download`
- `docs:document.comment:create`
- `docs:document.comment:write_only`

## Notes

- This package does not depend on the original repository checkout path.
- This package is cross-platform for:
  - `darwin-amd64`
  - `darwin-arm64`
  - `linux-amd64`
  - `linux-arm64`
  - `windows-amd64`
  - `windows-arm64`
- It starts from an existing Feishu Minutes URL or `minute_token`.
- It does not upload audio into Feishu Minutes.
- Delete note operation is implemented via Drive file delete API with doc token/docx URL input.
- The package is note-first: direct Feishu note operations are the primary workflow, while minutes import is secondary.
- Section-level updates are exposed as a first-class operation instead of requiring users to assemble raw `docs +update` flags manually.
