OpenKM文档管理

技能简介

通过REST API连接OpenKM文档管理系统，支持文件夹管理、文档上传下载、元数据维护、版本控制、全文搜索和工作流操作。采用本地CLI方式调用，无需SOAP或CMIS协议。

业务背景

企业文档分散在各部门，查找困难且版本混乱。该工具通过REST API直连OpenKM系统，让业务人员无需学习复杂协议即可在本地命令行完成文件夹管理、文档流转和全文检索，实现合同、报告等关键资料的集中管控与高效协作，降低文档丢失和误用风险。

落地案例：某制造企业法务部每月处理上百份采购合同。文员通过本地CLI登录OpenKM，按项目自动创建文件夹层级，批量上传扫描件并添加供应商、金额等属性标签。当审计需要调取三年前某类合同时，执行关键词搜索秒级定位，再下载历史版本比对修订记录，全程无需打开浏览器。

能做什么

• 创建和浏览文件夹结构，自动补全父目录
• 上传、下载、移动、重命名和删除文档
• 管理文档属性、关键词和分类标签
• 查看版本历史，下载或恢复指定版本
• 按内容、文件名、关键词等多条件搜索
• 启动工作流，处理任务分配与审批

使用说明

1. 环境准备

配置以下环境变量：

export OPENKM_BASE_URL=https://openkm.example.com
export OPENKM_USERNAME=okm_admin
export OPENKM_PASSWORD=secret

2. 安装依赖

确保系统已安装Python 3，将openkm_cli.py置于可执行路径。

3. 基础操作示例

列出根目录内容：

python3 openkm_cli.py list --folder-path /okm:root

上传文档：

python3 openkm_cli.py upload --okm-path /okm:root/Folder/file.pdf --local-path /path/file.pdf

全文搜索：

python3 openkm_cli.py search-content --content "invoice hosting"

输入与输出

见下方输入与输出表格。

风险提示

• 删除操作不可逆，建议先确认文档ID
• 工作流功能需服务端预先配置，否则返回404
• 密码以明文环境变量存储，注意访问权限控制
• 移动操作时目标路径需使用文件夹UUID而非路径

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/pes0/openkm-rest/SKILL.md
来源类型：GitHub仓库