名称： workflowy
描述： Workflowy 大纲命令行工具，用于读取、搜索和编辑节点。当用户需要与其 Workflowy 大纲进行交互时使用——包括搜索、添加条目、查看树状结构、标记完成、批量操作或使用情况报告。
主页： https://github.com/mholzen/workflowy
元数据：
{
"openclaw":
{
"emoji": "📝",
"requires": { "bins": ["workflowy"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "mholzen/workflowy/workflowy-cli",
"bins": ["workflowy"],
"label": "安装 workflowy-cli (brew)",
},
],
},
}

workflowy

使用非官方的 workflowy CLI 工具 mholzen/workflowy 来管理你的 Workflowy 大纲。需要先设置 API 密钥。

初始设置（仅需一次）

从 https://workflowy.com/api-key/ 获取你的 API 密钥，并将其保存到 ~/.workflowy/api.key 文件中：

mkdir -p ~/.workflowy
echo "你的-api-key-在这里" > ~/.workflowy/api.key

常用命令

读取操作

# 获取根节点（默认深度为 2）
workflowy get

# 通过 UUID 或短 ID 获取特定节点
workflowy get <条目-id>
workflowy get https://workflowy.com/#/59fc7acbc68c

# 以扁平列表形式显示某个节点的子节点
workflowy list <条目-id>

# 搜索（全文，不区分大小写）
workflowy search -i "会议记录"

# 使用扩展正则表达式搜索
workflowy search -E "<time.*>"

# 在子树内搜索
workflowy search "bug" --item-id <父节点-id>

写入操作

# 向“收件箱”添加新节点
workflowy create "购买杂货" --parent-id=inbox

# 向特定父节点添加节点
workflowy create "任务" --parent-id=<uuid>

# 更新节点名称
workflowy update <条目-id> --name "新名称"

# 标记为完成/取消完成
workflowy complete <条目-id>
workflowy uncomplete <条目-id>

# 移动节点
workflowy move <条目-id> <新父节点-id>

# 删除节点（包含其所有子节点！）
workflowy delete <条目-id>

批量操作

# 搜索并替换（建议先进行试运行！）
workflowy replace --dry-run "foo" "bar"
workflowy replace --interactive "foo" "bar"

# 使用捕获组的正则表达式查找/替换
workflowy replace "TASK-([0-9]+)" 'ISSUE-$1'

# 转换：按换行符分割为子节点
workflowy transform <条目-id> split -s "\n"

# 转换：去除空白字符
workflowy transform <条目-id> trim

统计报告

# 查看内容最多的区域
workflowy report count --threshold 0.01

# 拥有最多子节点的节点
workflowy report children --top-n 20

# 陈旧内容（最近修改时间最早）
workflowy report modified --top-n 50

# 被镜像最多的节点（需要备份数据）
workflowy report mirrors --top-n 20

数据访问方法

要使用离线模式，请先在 Workflowy 中启用 Dropbox 备份功能：

workflowy get --method=backup

短 ID

Workflowy 支持短 ID，可以从“复制内部链接”菜单获取：
- Web URL 格式：https://workflowy.com/#/59fc7acbc68c
- 可以直接使用，例如：workflowy get https://workflowy.com/#/59fc7acbc68c

特殊命名目标

• inbox — 用户的收件箱
• home — 大纲的根节点

workflowy create "快速笔记" --parent-id=inbox
workflowy id inbox  # 解析为对应的 UUID

注意事项

• 删除节点会同时删除其所有子节点。
• 结果默认按优先级（显示顺序）排序。
• 处理大型树状结构时，建议使用 --method=export（缓存机制，速度更快）。
• 镜像分析需要使用备份方法 (--method=backup)。
• 执行批量替换操作前，请务必进行确认。