glmv-doc-based-writing

GLM-V 文書ベースのライティングスキル

ZhiPu GLM-V マルチモーダルモデルを使用して、与えられた文書を理解し、要件に応じた文章コンテンツ（論文／記事／エッセイ／レポート／レビュー／投稿／ブリーフ／提案書／計画書）を作成します。

使用する場面

• 提供された文書を読んだ後、指定された要件に応じた文章コンテンツを作成する場合
• ユーザーが「文書ベースのライティング」「記事の執筆」「文書の読解」「プレスリリースの執筆」「ブリーフの作成」「映画／書籍レビューの執筆」「コンテンツの要約」「コンテンツの作成」「論評の執筆」「文書の続きの執筆」「文書の翻訳」「提案の立案」「スピーチの執筆」と言及した場合

対応する入力形式

種類	形式	最大数	ソース
文書（URL）	pdf, docx	50	URL
文書（ローカル）	pdf のみ	合計 50 ページ以下	ローカルパス

ローカル PDF： ローカル PDF ファイルは、モデルに送信する前にページごとに画像（base64）に変換されます。PyMuPDF が必要です（pip install PyMuPDF）。URL ファイルは pdf/docx/txt を含むすべての形式に対応しています。 ローカル PDF は自動的にページごとに画像（base64）に変換されてモデルに送信されます。PyMuPDF のインストールが必要です（pip install PyMuPDF）。URL ファイルは pdf/docx/txt など、すべての形式に対応しています。

📋 出力表示ルール（必須）

スクリプトを実行した後、返された完全なコンテンツを（Markdown 形式で）そのまま表示する必要があります。要約、省略、翻訳、コメントをしたり、「Writing Completed!」とだけ伝えたりしないでください。

リソースリンク

リソース	リンク
API Key の取得	https://bigmodel.cn/usercenter/proj-mgmt/apikeys
API ドキュメント	Chat Completions / 対話補完

前提条件

API Key の設定（必須）

このスクリプトは ZHIPU_API_KEY 環境変数からキーを読み取り、他の Zhipu スキルと共有します。 スクリプトは ZHIPU_API_KEY 環境変数からキーを取得し、他の Zhipu スキルと共有します。

キーの取得： Zhipu Open Platform API Keys / 智譜オープンプラットフォーム API Keys にアクセスして、キーを作成またはコピーしてください。

設定方法（いずれかを選択）：

1. OpenClaw の設定（推奨）： openclaw.json の skills.entries.glmv-doc-based-writing.env で設定します。

   "glmv-doc-based-writing": { "enabled": true, "env": { "ZHIPU_API_KEY": "你的密钥" } }
   

2. シェル環境変数： ~/.zshrc に追加します。

   export ZHIPU_API_KEY="你的密钥"
   

💡 すでに別の Zhipu スキル（例：zhipu-tools や glmv-caption）を設定している場合は、同じ ZHIPU_API_KEY を共有するため、追加の設定は不要です。 💡 すでに他の Zhipu スキル（例：zhipu-tools、glmv-caption）にキーを設定している場合、同じ ZHIPU_API_KEY を共有するため、再設定は不要です。

使用方法

基本的なスクリーニング

python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --requirements "基于这篇论文撰写公众号文章，要求偏技术风格"

Markdown として保存

python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --requirements "总结文档主要内容和核心观点" \
  --output result.md

JSON として保存

python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" "https://example.com/doucment2.docx" \
  --criteria "撰写新闻稿" \
  --output result.json --pretty

カスタムシステムプロンプト

python scripts/doc_based_writing.py \
  --files "https://example.com/doucment1.pdf" \
  --criteria "为这本书撰写书评" \
  --system-prompt "你是一位拥有20年跨领域写作经验的资深写作专家，擅长撰写书评"

出力例

モデルは、次のような Markdown コンテンツを出力します。

XXX

CLI リファレンス

python scripts/doc_based_writing.py --files FILE [FILE...] --requirements REQUIREMENTS [OPTIONS]

パラメーター	必須	説明
--files, -f	✅	ドキュメントファイルの URL（pdf/docx、URL のみ、最大 50 件）
--requirements, -c	✅	執筆要件のテキスト
--model, -m	いいえ	モデル名（デフォルト：glm-4.6v）
--system-prompt, -s	いいえ	カスタムシステムプロンプト（デフォルト：プロフェッショナルな人事アシスタント）
--temperature, -t	いいえ	サンプリング温度 0～1（デフォルト：0.6）
--max-tokens	いいえ	最大出力トークン数（デフォルト：10000）
--output, -o	いいえ	結果をファイルに保存（Markdown の場合は .md、JSON の場合は .json）
--pretty	いいえ	JSON 出力を整形する

エラー処理

API キーが設定されていません： → ZHIPU_API_KEY を設定するようユーザーに案内してください

認証に失敗しました（401/403）： → API キーが無効または期限切れです → 再設定してください

レート制限（429）： → クォータを使い切りました → 待ってから再試行してください

ローカルパスが指定されました： → エラー：URL のみサポートされています

コンテンツがフィルタリングされました： → warning フィールドが存在します → 安全性審査によりコンテンツがブロックされました

タイムアウト： → ドキュメントが大きすぎるか、多すぎます → ファイル数を減らしてください