用途:读取并理解给定的一份或多份文档,按用户提出的写作要求,生成文章、论文、报告、评论、帖子、简报、方案或计划等文本内容,适合需要“先读文档再写作”的场景,如文档解读、内容总结、文档续写、文档翻译、新闻稿/简报/影评/书评/发言稿撰写与方案策划。
主要能力:支持 URL 文档(pdf、docx)最多 50 个;支持本地 PDF(总页数≤50),本地 PDF 会逐页转为 base64 图片传给模型,需安装 PyMuPDF(pip install PyMuPDF)。URL 文件支持 pdf/docx/txt 等全格式。可自定义系统提示词、模型、温度和最大输出 token,并可将结果保存为 Markdown 或 JSON;运行后须完整展示返回的 Markdown 内容,不可摘要、截断或只回复“写作完成”。
使用方式:先配置智谱 API Key,脚本从环境变量 ZHIPU_API_KEY 读取,与其他智谱技能共用同一 key。可通过 OpenClaw 配置(openclaw.json 的 skills.entries.glmv-doc-based-writing.env)或 Shell 环境变量(在 ~/.zshrc 中 export ZHIPU_API_KEY="你的密钥")设置。基本命令:python scripts/doc_based_writing.py --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" --requirements "基于这篇论文撰写公众号文章,要求偏技术风格"。可用 --output result.md 保存为 Markdown,或 --output result.json --pretty 保存为 JSON;另支持 --system-prompt 自定义系统提示词。
主要参数:--files/-f(必填,仅 URL,最多 50 个);--requirements/-c(必填,写作要求);--model/-m(默认 glm-4.6v);--system-prompt/-s(默认 professional HR assistant);--temperature/-t(0-1,默认 0.6);--max-tokens(默认 10000);--output/-o;--pretty。
限制:本地路径文件仅支持 PDF,其余格式须用 URL;本地 PDF 总页数不超过 50;输出内容受安全审核,被拦截时会出现 warning 字段;文档过大或过多可能超时,需减少文件数。API Key 获取地址为 https://bigmodel.cn/usercenter/proj-mgmt/apikeys,API 文档为对话补全(Chat Completions)。未配置 key、401/403 认证失败、429 限流等错误需按提示处理。