凌晨两点，我对着空白的周报文档发呆

周五晚上 11 点，老王发来一张截图：

“哥，我这周要交的周报又忘了写。手头有 7 个项目的进度、3 份会议纪要、还有一堆待办事项。你能不能让 AI 帮我直接生成一份金山的 WPS 文档？”

他用的是金山文档——对，就是那个 5 亿人在用的 WPS 云端版。不是 Notion，不是飞书，不是腾讯文档，是金山。

我的第一反应是：去搜啊，肯定有人做过这种 Skill 吧？

结果一搜，搜出来一堆——tencent-docs、notion-skill、office-cli、doc-assistant……但没有一个是专门为金山文档设计的。

直到我遇到了它：kdocs-skill。

一个由金山办公（Kingsoft）官方出品的 Skill，唯一与金山文档 API 完整对接的 OpenClaw 原生插件。

它不是又一个"AI 写文档"工具。

它是那个让你在 OpenClaw 里说一句"帮我把刚才那段会议纪要存到金山文档周报文件夹"就能完成全部动作的东西。

今天这篇文章，我想跟你聊一聊：这只"龙虾"是怎么接管你的金山文档的。

一、先说清楚：金山文档是什么？为什么需要专门的 Skill？

很多人对"金山文档"还有误解。

“哦，就是那个网页版 WPS 嘛。”

不是的。

**金山文档（KDocs / 365.kdocs.cn / www.kdocs.cn）**是金山办公旗下的在线协作文档平台。它和腾讯文档、飞书文档、Notion 是同一级别的产品——但有一个独特的差异点：

它背靠 WPS Office 30 年的本地办公软件积累。

也就是说，你本地 WPS 能做的所有事（Word/Excel/PPT/PDF），金山文档全都能在浏览器里做，并且加入了云端的协作、AI、跨端同步。

截至 2026 年 8 月，金山文档月活用户已经超过 5 亿。

但它有一个致命痛点：

没有 AI Agent 原生接入。

你打开 kdocs.cn，看到的是一个网页编辑器。

你打开手机 App，看到的是协作界面。

你打开 OpenClaw/Claude Code/Cursor……什么都没。

AI 想要操作你的金山文档？抱歉，你得自己复制粘贴。

kdocs-skill就是为解决这个痛点而生的。

二、kdocs-skill 是什么？为什么是它？

2.1 一句话定义

kdocs-skill是金山办公官方出品的 OpenClaw 原生 Skill，通过配套的kdocs-cli命令行工具，让 AI Agent 可以直接调用金山文档的完整 API——创建、读取、编辑、搜索、分享、分类、整理、回收……

它是金山文档的"AI 外挂神经"。

2.2 数据背书

我从 SkillHub 抓到了一组硬数据（2026-08-01 实时榜单）：

它是 SkillHub 在线文档类目中除 tencent-docs 之外，另一个同时进入热榜和推荐榜的选手。

2.3 官方背景，不是野鸡

这是最关键的点。

很多 Skill 是社区开发者自己写 API 包装的，比如office-cli、doc-assistant——它们都很强，但和金山文档没有官方合作关系。

而kdocs-skill：

• README 第一句就写明：“金山文档官方 Skill”
• Token 来源是https://www.kdocs.cn（不是第三方）
• 调用的是api.wps.cn的官方 OpenAPI
• 文档里专门有一个「龙虾专属入口」用于 AI Agent 接入

这是金山办公（Kingsoft）官方下场做的 AI 接入层。

这意味着：

• ✅ API 不会突然废弃
• ✅ 不会出现第三方破解导致的封号
• ✅ 有问题可以走官方反馈通道（kdocs-cli feedback）
• ✅ Token 体系是 WPS 账号本身，企业用户无缝对接

三、它到底能做什么？（九大服务 40+ 工具）

kdocs-skill最大的特点是：它不只是一个"读写文档"工具，而是一个完整的金山文档操作系统。

3.1 文档类型支持——比 office-cli 还全

这意味着你可以在 OpenClaw 里写 Word、做 Excel、做 PPT、管理 Notion 级别的多维表格。

3.2 核心工具矩阵

我把它按"使用频率"重新整理了一遍：

🔵 高频（每天用）

• drive.search_files— 搜文件（按文件名 / 全文 / 类型）
• drive.create_file— 新建文档
• drive.read_file_content— 读取文档 → Markdown
• drive.upload_file— 上传本地文件到云端
• drive.share_file— 一键生成分享链接

🟡 中频（每周用）

• otl.insert_content— 往智能文档里插内容
• sheet.read/write— 读写 Excel
• wpp.execute— 操作 PPT
• pdf.split/extract— 拆分和提取 PDF
• scrape_url— 网页剪藏（直接存为智能文档）

🟢 进阶（场景化）

• dbsheet.*— 多维表格全操作（建表/字段/视图/记录/权限）
• kwiki.*— 知识库管理
• aippt.*— AI 一键生成 PPT
• move_file / rename_file / batch_add_label_objects— 整理和打标签
• list_deleted_files / restore_deleted_file— 回收站还原

3.3 让我眼前一亮的 5 个能力

① 网页剪藏scrape_url

看到一篇好文章 → 一句话让 AI 抓取 → 自动存到金山文档智能文档 → 顺手打个"待读"标签。

这不就是 readwise 之类的付费工具做的事吗？免费给你。

② 接龙转表格

微信群里发了一个接龙 → 把文本丢给 AI → 自动生成结构化在线表格 → 直接发到群里收尾。

③ AI PPT 一键生成aippt

主题生成 PPT 的标准链路：

1. 澄清需求（5W2H）
2. 研究资料（搜索 + 读取）
3. 大纲与生成上传

AI 真的能帮你从"一句话"到"成品 PPT"。

④ 多维表格dbsheet

这个必须单独说——多维表格 = 表格 + 看板 + 甘特 + 日历。

dbsheet.*提供了完整的 Notion Database 级别能力：建表、字段类型、视图、记录、附件、权限、webhook。

你可以一句话让 AI 帮你建一个"客户跟进表"，配置 12 个字段、3 个视图、自动提醒。

⑤ Token 体系设计

这是工程化最让我服气的地方。

kdocs-cli auth set-token <token>一行命令保存到系统密钥链。

Token 包含/、+、=等特殊字符时，用 stdin 模式避免 shell 转义问题。

echo "<token>" | kdocs-cli auth set-token -

禁止明文存储、禁止明文回显、禁止写入环境变量。

这是其他 Skill 都不太会认真做的事情。

四、10 分钟从零开始（实操演示）

4.1 安装

Windows 用户：

# 方式一：一行命令（推荐） powershell scripts/setup.ps1 # 方式二：Node.js 通用 node scripts/setup.cjs # 验证 kdocs-cli version

Linux / macOS：

bash scripts/setup.sh

4.2 登录

# 浏览器 OAuth 登录（自动保存 Token 到密钥链） kdocs-cli auth login # 或手动设置 Token kdocs-cli auth set-token <your-token>

4.3 第一次调用：搜索周报

kdocs-cli drive search-files keyword="周报" type=all page_size=10

返回 JSON，类似：

{ "code": 0, "data": { "files": [ {"file_id": "xxx", "name": "2026-08-01 周报.otl", "drive_id": "..."}, ... ] } }

code: 0 即成功。

4.4 完整工作流：让 AI 帮你写周报

# 1. 找到周报模板 kdocs-cli drive search-files keyword="周报" type=file_name # 2. 复制模板到目标目录 kdocs-cli drive copy-file file_id=<模板ID> parent_id=<目标目录ID> # 3. 读取今天的会议纪要 kdocs-cli drive read-file-content file_id=<纪要ID> # 4. 整理 + 写入周报 kdocs-cli otl insert-content file_id=<新周报ID> content="<AI 生成的 Markdown>" pos=end # 5. 获取分享链接 kdocs-cli drive get-file-link file_id=<新周报ID>

从"想写周报"到"周报链接发到群里"，5 条命令，1 分钟。

4.5 大段内容怎么传？（最容易踩的坑）

kdocs-cli对中文长内容做了专门的工程化处理。

❌ 错误做法：

# PowerShell 进程间参数传递会破坏 UTF-8 → 乱码 kdocs-cli otl insert-content file_id=xxx content="这是一段超长的中文内容..."

✅ 正确做法：用 @file

// Node.js 生成 JSON payload const fs = require('fs'); const payload = JSON.stringify({ file_id: "xxx", content: fs.readFileSync('article.md', 'utf8'), pos: "end" }); fs.writeFileSync('payload.json', payload, 'utf8');

kdocs-cli otl insert-content @payload.json --silent

为什么这很重要？

因为很多人写 Skill 的时候没考虑 Windows + 中文 + PowerShell 的组合，结果每次都乱码。

kdocs-skill把这个坑直接用工程化方式填平了。

五、技术架构深度剖析

5.1 三层架构

┌─────────────────────────────────────────┐ │ Layer 1: AI Agent（OpenClaw/Claude Code） │ │ - 接收自然语言指令 │ │ - 解析意图并匹配工具 │ │ - 调度多个工具组合完成复杂任务 │ └─────────────────────────────────────────┘ ↓ kdocs-cli (CLI) ┌─────────────────────────────────────────┐ │ Layer 2: kdocs-cli 命令行工具 │ │ - 参数解析（key=value / JSON / @file / stdin）│ │ - Token 安全管理（系统密钥链） │ │ - 错误码转换（400006/400007/...） │ │ - 重试与幂等性控制 │ └─────────────────────────────────────────┘ ↓ HTTP API ┌─────────────────────────────────────────┐ │ Layer 3: 金山文档官方 OpenAPI（api.wps.cn） │ │ - Drive 文件管理 │ │ - Sheet 表格 │ │ - OTL 智能文档 │ │ - Dbsheet 多维表格 │ │ - Kwiki 知识库 │ │ - AIPPT AI 生成 │ └─────────────────────────────────────────┘

5.2 关键的 5 个工程化设计

① 四种参数传递方式

② 幂等性管理

写入类操作（create / insert / execute）都不幂等，必须前置检查。

③ 错误码字典

kdocs-skill内置了完整的错误码字典：

④ 版本自检三步法

Step 1: kdocs-cli upgrade --check # 检查 CLI 新版本 Step 2: 对比 SKILL.md frontmatter 的 version 字段 Step 3: kdocs-cli call check_skill_update version=<当前版本号> # 检查 Skill 包

⑤ 安全约束

• 凭据由系统密钥链管理，禁止明文回显
• 严格区分了只读和写操作（14 个高风险工具都有"用户确认"约束）
• 无状态代理，不缓存任何文档内容

六、5 大真实场景演示

场景 1：群接龙自动转表格

原始：微信群发"接龙：周六爬山 1. 张三 2. 李四 3. 王五..." ↓ kdocs-cli drive create-file name="周六爬山接龙表.ksheet" file_type="file" ↓ kdocs-cli sheet insert-rows file_id=<新表ID> data=<结构化JSON> ↓ kdocs-cli drive get-file-link file_id=<新表ID>

5 秒钟完成，零人工干预。

场景 2：网页剪藏 + AI 整理

"把知乎上这篇关于 AI Agent 的文章存到我的知识库" ↓ kdocs-cli drive scrape_url url="https://zhuanlan.zhihu.com/p/xxx" ↓ kdocs-cli scrape_progress # 查询任务进度 ↓ kdocs-cli drive move_file file_id=<生成文档ID> parent_id=<知识库目录ID> ↓ kdocs-cli kwiki create_knowledge_view name="AI Agent 收藏"

收藏、分类、入库全自动。

场景 3：会议纪要 → 周报 → PPT

3 份会议纪要（多模态：Word + 录音转写 + 截图） ↓ kdocs-cli drive read-file-content # 读取所有 ↓ kdocs-cli kwiki kwiki_list_items # 提取所有待办 ↓ kdocs-cli drive create-file name="周报.otl" # 创建周报 ↓ kdocs-cli otl insert-content # 写入 AI 整理的周报 ↓ kdocs-cli aippt deep_research # 周报自动生成 PPT ↓ kdocs-cli drive get-file-link # 一键分享

这是 5 个工具的组合，1 分钟完成 4 小时的工作。

场景 4：多维表格搭建 CRM

"建一个客户跟进表，字段：姓名/公司/联系方式/跟进状态/下次联系时间" ↓ kdocs-cli dbsheet create_table schema=<12字段JSON> ↓ kdocs-cli dbsheet create_view view_type=kanban # 看板视图 ↓ kdocs-cli dbsheet create_view view_type=calendar # 日历视图 ↓ kdocs-cli dbsheet create_webhook # 跟进状态变更触发提醒

从零搭建 CRM 系统，3 分钟。

场景 5：知识库整理

"我的金山文档知识库里有 200 篇杂文，按主题分类整理" ↓ kdocs-cli kwiki list_items # 列出所有 ↓ （AI 聚类分析主题） ↓ kdocs-cli kwiki create_knowledge_view name="AI 主题" ↓ kdocs-cli kwiki batch_move_items # 批量移动

知识管理从"乱糟糟"到"井井有条"。

七、同类对比：它和 office-cli / tencent-docs 有什么区别？

这是最常被问到的问题，我直接做一张表：

一句话总结：

• office-cli：本地 Office 自动化之王，强在离线、跨平台
• tencent-docs：腾讯生态的 Notion 替代，团队协作强
• notion-skill：Notion 原生 AI 集成，块级编辑最优雅
• kdocs-skill：金山文档原生 AI 接入，国内访问友好，5 亿用户基础

如果你/你的团队是 WPS 重度用户，kdocs-skill是唯一选择。

八、优缺点诚实评价

✅ 优点

1. 官方背景，可靠性极高

金山办公官方出品，不会突然废弃，Token 体系安全。

2. 工具覆盖最全

40+ 工具，9 大服务，从智能文档到多维表格到知识库到 AI PPT，没有死角。

3. 工程化做得好

• Token 用系统密钥链管理
• 中文长内容用 @file 传参
• 幂等性、重试、错误码字典都是教科书级别
• 版本自检三步法实用

4. 国内访问友好

不需要梯子，Token 就是你的 WPS 账号。

5. CLI 形态对 AI 友好

kdocs-cli drive search-files keyword=xxx这种命令，AI 调用起来最自然。

❌ 缺点

1. 必须有金山文档账号

门槛存在，但 5 亿人都有，门槛其实很低。

2. Token 体系——目前只支持国内版（kdocs.cn / wps.cn），不支持国际版（wps.com）

GitHub Issue #73062 已经在跟踪了，但还没有合并。这是国际化团队的最大痛点。

3. 部分操作有高风险约束

14 个高风险工具（如delete_records、close_knowledge_view）必须用户确认。

这是好事，但在自动化场景下可能需要先auth set-token --skip-confirm才能跑批处理。

4. 写入类操作不幂等

create_file、otl.insert_content、wpp.execute重试需要先检查状态，对长流程工作流要做断点续传。

5. 学习曲线

40+ 工具对新手来说需要花 1-2 小时才能掌握核心用法。

九、5 个黄金组合

kdocs-skill不是孤岛，搭配其他 Skill 威力更大。

组合 1：周报生成器

kdocs-skill + agent-browser + summarize

1. agent-browser 抓取飞书/钉钉的周报源数据 2. summarize 生成 500 字摘要 3. kdocs-skill 写入金山文档周报模板

组合 2：知识库流水线

kdocs-skill + tavily-search + another-them

1. tavily-search 搜索行业最新动态 2. another-them 用芒格思维模式整理 3. kdocs-skill 入库到 kwiki 知识库

组合 3：客户管理自动化

kdocs-skill + email-management + messaging-integration

1. email-management 读取客户邮件 2. messaging-integration 读取微信沟通 3. kdocs-skill dbsheet 自动更新客户跟进表

组合 4：内容创作全流程

kdocs-skill + xiaohongshu-mcp + summarize

1. summarize 提炼爆款内容规律 2. xiaohongshu-mcp 一键发布 3. kdocs-skill 归档到内容运营知识库

组合 5：AI PPT 一键生成

kdocs-skill + wechat-clawbot + ai-web-automation

1. wechat-clawbot 接收微信群发来的"做PPT"指令 2. kdocs-skill aippt 生成 PPT 3. ai-web-automation 上传到 WPS 演示 4. 把分享链接回发到群里

十、写在最后：它教会了我什么

写完这篇深度报告，我最大的感受是：

AI Agent 的真正革命，不是更聪明的模型，而是更深的生态连接。

kdocs-skill让我重新理解了"在线文档"。

它不只是一个 Skill，它是金山办公在 AI 时代给 5 亿用户的一份"使用说明书"。

很多团队花了 30 年建立自己的文档体系，AI 想要接入，需要 1 个 Token、1 个 CLI、1 套工程化设计。

kdocs-skill把这"3 个 1"做到了极致。

它不是那只最强壮的龙虾，但它是最懂金山文档的那只。

📥 快速安装清单

# 1. 安装 CLI powershell scripts/setup.ps1 # 2. 登录 kdocs-cli auth login # 3. 第一次搜索 kdocs-cli drive search-files keyword="周报" type=all # 4. 创建第一个文档 kdocs-cli drive create-file name="我的第一个 AI 文档.otl" file_type="file" # 5. 写点东西 kdocs-cli otl insert-content file_id=<id> content="Hello from AI Agent" pos=end

5 步，10 分钟，让你的 OpenClaw 真正接管金山文档。

🦞 让 AI 干活，从一只会写文档的龙虾开始。

字数：约 4,500 字