work-helper

自托管、对话式个人工作助手，专为顾问/自由职业系统运维人员设计。

功能特性

活动日志 (log)

记录已完成事项及上下文，并附带时间戳。

bash
python3 work_helper.py log add 与客户X会议——网络架构评审
python3 work_helper.py log add 部署staging环境 --project acme --duration 2h --tags deploy,infra
python3 work_helper.py log today
python3 work_helper.py log week
python3 work_helper.py log month
python3 work_helper.py log search 架构

笔记 (note)

与项目或上下文关联的自由笔记。

bash
python3 work_helper.py note add 记得在周五前迁移DNS
python3 work_helper.py note add 客户Y网络拓扑图 --project clientY
python3 work_helper.py note list
python3 work_helper.py note list --project clientY
python3 work_helper.py note search DNS

提醒 (remind)

通过OpenClaw的cron（系统事件）创建提醒。

bash
python3 work_helper.py remind add 客户演示 --date 2026-03-15 --time 14:30
python3 work_helper.py remind add CRA --every friday --time 17:00
python3 work_helper.py remind list
python3 work_helper.py remind cancel

注意 crondelete：remind cancel 会发送一个包含cron名称的 crondelete 事件
（名称为 work-helper-remind-）。OpenClaw的cron工具通过 jobId 而非 name 进行操作。
因此，代理必须先执行 cron list 查找与 name 对应的 jobId，然后才能删除该cron。

LLM摘要 (recap)

按时间段智能汇总日志。

bash
python3 work_helper.py recap today
python3 work_helper.py recap week
python3 work_helper.py recap month

顾问活动报告 (cra)

生成格式化的活动报告。

bash
python3 work_helper.py cra week
python3 work_helper.py cra month
python3 work_helper.py cra week --format table
python3 work_helper.py cra week --format markdown

reMarkable导入 (ingest)

处理手写PDF。通过Vision API进行转录，然后由LLM进行结构化处理。

bash
python3 work_helper.py ingest --pdf scan.pdf --mode meeting
python3 work_helper.py ingest --mode log
python3 work_helper.py ingest --mode notes --project clientX
python3 work_helper.py ingest --mode cra

综合视图 (status)

bash
python3 work_helper.py status

导出 (export)

bash
python3 work_helper.py export nextcloud --period week
python3 work_helper.py export email --to romain@example.com --period week
python3 work_helper.py export file --period month

存储与凭证

路径	类型	内容
~/.openclaw/config/work-helper/config.json	配置	行为、LLM、输出（不含密钥）
~/.openclaw/secrets/openaiapikey

密钥 | LLM API密钥（权限600，与veille共享） | | ~/.openclaw/data/work-helper/journal.json | 数据 | 带时间戳的活动记录 | | ~/.openclaw/data/work-helper/notes.json | 数据 | 自由笔记 | | ~/.openclaw/data/work-helper/reminders.json | 数据 | 活跃提醒 | | ~/.openclaw/data/work-helper/projects.json | 数据 | 活跃项目及元数据 | | ~/.openclaw/data/work-helper/ingest/ | 数据 | 已下载的PDF（导入） | | ~/.openclaw/data/work-helper/exports/ | 数据 | 本地导出（markdown格式） |

配置

~/.openclaw/config/work-helper/config.json —— 参见 config.example.json。

OpenClaw依赖

• - mail-client —— 读取邮件及附件（reMarkable导入、邮件导出）
• nextcloud-files —— 可选云导出