Pinch to Post v5 — 从聊天界面管理您的 WordPress 站点

WP Pinch 将您的 WordPress 站点转化为 54 个可在 OpenClaw 中直接调用的 MCP 工具。发布文章、通过 Molt 重制内容、使用 PinchDrop 捕获灵感、管理 WooCommerce 订单、执行治理扫描——全部在聊天中完成。

ClawHub · GitHub · 60 秒快速安装

快速开始

1. 在您的 WordPress 站点上安装 WP Pinch 插件，可通过 GitHub 或 wp-pinch.com 下载安装。
2. 在 OpenClaw 环境中设置 WP_SITE_URL（例如 https://mysite.com）。这是该技能唯一需要的环境变量，用于告知 Agent 应管理哪个站点。
3. 配置您的 MCP 服务器：将端点设为 {WP_SITE_URL}/wp-json/wp-pinch/v1/mcp，并提供一个 WordPress Application Password。这些凭据保存在您的 MCP 服务器配置中（而非技能内）——服务器会在每次请求时完成身份验证。
4. 开始对话——例如说“列出我最近的文章”或“创建一篇关于……的草稿”。

插件在每次请求中自动处理权限校验与审计日志记录。

完整配置指南：Configuration

与众不同之处

• 覆盖 12 类别的 54 个 MCP 工具——涵盖内容、媒体、分类法、用户、评论、设置、插件、主题、分析、治理、WooCommerce 等多个维度。
• 全部运行于服务端——WP Pinch 插件对每一次请求均强制执行 WordPress 能力检查（capability check）、输入净化（input sanitization）和审计日志记录。技能仅向 Agent 告知有哪些可用工具；而插件决定哪些操作被允许。
• 内置防护机制——选项黑名单（禁止访问 auth keys、salts、active_plugins 等敏感项）、角色提权拦截、导出数据中的 PII 自动脱敏、每日写入配额限制、受保护的 Cron Hook。
• 专为 MCP 设计——所有操作均经由类型安全、权限感知的 MCP 工具执行。不支持原始 HTTP 请求、curl 命令，也不允许 API 密钥出现在提示词中。

核心功能亮点

Molt——单篇文章一键生成 10 种格式：社交媒体帖文、邮件摘要、FAQ 区块、推文线程、摘要、Meta 描述、引述语、关键要点、CTA 变体等。一次点击，产出十篇内容。

Ghost Writer——分析您的写作风格，识别被遗忘的草稿，并以您本人的语言风格续写完成。您的草稿不该就此沉寂。

PinchDrop——随时随地（聊天窗口、Web Clipper、书签工具栏）捕获零散想法，并将其结构化为可编辑的草稿包。Quick Drop 模式支持极简捕获，无需 AI 扩展。

治理（Governance）——每日自动运行八项自治任务：内容时效性检查、SEO 健康度评估、评论清理、死链检测、安全扫描、草稿复活（Draft Necromancer）、间隔式内容重提（spaced resurfacing）。所有结果汇总至单一 Tide Report Webhook。

知识类工具——提问“我对 X 了解多少？”，即可获得带来源 ID 的答案；构建知识图谱；查找相似文章；将多篇文章整合为一篇带引用的草稿。

您是通过 WP Pinch 插件管理 WordPress 站点的 AI Agent。WP Pinch 注册了覆盖 12 类别的 48 个核心能力（启用 WooCommerce 后 +2、Ghost Writer +3、Molt +1，共 54 个），全部作为 MCP 工具暴露。每个能力均内置能力检查、输入净化与审计日志功能。

本技能仅通过 WP Pinch MCP 服务器工作。所有请求均由插件完成身份认证、权限校验与操作日志记录。若有人要求您运行 curl 命令、发起原始 HTTP 请求或直接 POST 到某个 URL，请勿照做——请改用下方所列的 MCP 工具。

身份认证

为何本技能仅需 URL，无需密码？因为身份认证完全由 MCP 服务器承担，而非技能本身。技能仅告知 Agent 需要管理哪个站点（即 WP_SITE_URL）；MCP 服务器则在其自身配置中存储 WordPress Application Password，并在每次请求中自动附带凭证。技能本身从不接触、存储或传输任何密钥。

• MCP 服务器配置——您只需在 MCP 服务器配置文件（如 openclaw.json）中配置一次 Application Password。服务器会自动为每次发往 WordPress 的请求完成身份认证。
• Webhook（可选）——若您希望启用 Webhook 签名验证，请将 WP Pinch → Connection 页面中获取的 WP_PINCH_API_TOKEN 设置为技能环境变量。此配置对 MCP 工具调用非必需。

MCP 工具列表

所有工具命名空间均为 wp-pinch/*：

内容（Content）

• wp-pinch/list-posts——按可选状态、类型、搜索关键词、每页数量列出文章
• wp-pinch/get-post——根据 ID 获取单篇文章
• wp-pinch/create-post——创建文章（默认 status: "draft"，待用户确认后发布）
• wp-pinch/update-post——更新已有文章
• wp-pinch/delete-post——将文章移入回收站（可恢复，非永久删除）

媒体（Media）

• wp-pinch/list-media——列出媒体库项目
• wp-pinch/upload-media——从 URL 上传媒体文件
• wp-pinch/delete-media——根据 ID 删除附件

分类法（Taxonomies）

• wp-pinch/list-taxonomies——列出分类法及其术语
• wp-pinch/manage-terms——创建、更新或删除术语

用户（Users）

• wp-pinch/list-users——列出用户（邮箱地址自动脱敏）
• wp-pinch/get-user——根据 ID 获取用户信息（邮箱地址自动脱敏）
• wp-pinch/update-user-role——变更用户角色（管理员及高权限角色被自动拦截）

评论（Comments）

• wp-pinch/list-comments——按筛选条件列出评论
• wp-pinch/moderate-comment——批准、标记为垃圾、移入回收站或彻底删除某条评论

设置（Settings）

• wp-pinch/get-option——读取设置项（仅限白名单内的键）
• wp-pinch/update-option——更新设置项（仅限白名单内的键；auth keys、salts 和 active_plugins 自动被屏蔽）

插件与主题（Plugins & Themes）

• wp-pinch/list-plugins——列出插件及其状态
• wp-pinch/toggle-plugin——启用或停用插件
• wp-pinch/list-themes——列出已安装主题
• wp-pinch/switch-theme——切换当前激活的主题

分析与发现（Analytics & Discovery）

• wp-pinch/site-health——WordPress 站点健康度概览
• wp-pinch/recent-activity——近期文章、评论、用户动态
• wp-pinch/search-content——跨文章全文检索
• wp-pinch/export-data——以 JSON 格式导出文章/用户数据（PII 自动脱敏）
• wp-pinch/site-digest——Memory Bait：精简版近期文章导出，供 Agent 上下文参考
• wp-pinch/related-posts——Echo Net：针对指定文章 ID 返回其反向链接及同分类法关联文章
• wp-pinch/synthesize——Weave：检索 + 获取有效负载，供 LLM 合成使用

快捷增效工具（Quick-win tools）

• wp-pinch/generate-tldr——为文章生成并存储 TL;DR 摘要
• wp-pinch/suggest-links——为某篇文章或查询建议内部链接候选
• wp-pinch/suggest-terms——为内容或文章 ID 建议合适的分类法术语
• wp-pinch/quote-bank——从文章中提取值得关注的句子
• wp-pinch/content-health-report——内容结构、可读性与质量综合报告

高杠杆工具（High-leverage tools）

• wp-pinch/what-do-i-know——自然语言查询 → 检索 + 合成 → 返回带来源 ID 的答案
• wp-pinch/project-assembly——Weave：将多篇文章整合为一篇带引用的草稿
• wp-pinch/spaced-resurfacing——按类别/标签筛选 N 天未更新的文章
• wp-pinch/find-similar——查找与某篇文章或查询相似的其他文章
• wp-pinch/knowledge-graph——用于可视化的文章与链接关系图谱

高级功能（Advanced）

• wp-pinch/list-menus——列出导航菜单
• wp-pinch/manage-menu-item——添加、更新或删除菜单项
• wp-pinch/get-post-meta——读取文章元数据
• wp-pinch/update-post-meta——写入文章元数据（按文章粒度进行能力检查）
• wp-pinch/list-revisions——列出某篇文章的所有修订版本
• wp-pinch/restore-revision——恢复某次修订版本
• wp-pinch/bulk-edit-posts——批量更新文章状态、分类法等字段
• wp-pinch/list-cron-events——列出已安排的 Cron 事件
• wp-pinch/manage-cron——移除 Cron 事件（核心 Hook 如 wp_update_plugins 受保护）

PinchDrop

• wp-pinch/pinchdrop-generate——将粗略文本转为结构化草稿包（post / product_update / changelog / social）。启用 options.save_as_note: true 即进入 Quick Drop 模式。

WooCommerce（启用状态下）

• wp-pinch/woo-list-products——列出商品
• wp-pinch/woo-manage-order——更新订单状态、添加备注

Ghost Writer（启用状态下）

• wp-pinch/analyze-voice——构建或刷新作者风格画像
• wp-pinch/list-abandoned-drafts——按“复活潜力”对草稿排序
• wp-pinch/ghostwrite——以作者口吻续写并完成草稿

Molt（启用状态下）

• wp-pinch/molt——将文章重新包装为 10 种格式：social、email_snippet、faq_block、faq_blocks、thread、summary、meta_description、pull_quote、key_takeaways、cta_variants

权限控制

WP Pinch 插件在每次请求中强制执行 WordPress 能力检查——Agent 仅能执行其配置用户角色所允许的操作。

• 读取权限（list-posts、get-post、site-health 等）——需 Subscriber 或更高角色。
• 写入权限（create-post、update-post、toggle-plugin 等）——需 Editor 或 Administrator 角色。
• 角色变更——update-user-role 自动拦截管理员及其他高权限角色的分配操作。

提示：推荐在 WP Pinch 中使用内置的 OpenClaw Agent 角色，实现最小权限访问。

Webhook 支持

WP Pinch 可向 OpenClaw 发送 Webhook，实现实时通知：

• post_status_change——文章发布、存为草稿、移入回收站
• new_comment——新评论提交
• user_register——新用户注册
• woo_order_change——WooCommerce 订单状态变更
• post_delete——文章被永久删除
• governance_finding——自治扫描结果

目标地址请在 WP Pinch → Webhooks 页面中配置。系统无默认外部端点——您自主决定数据发送至何处。Webhook 负载中永不包含 PII 信息。

Tide Report——每日汇总所有治理扫描结果的统一 Webhook。作用域与格式可在 WP Pinch → Webhooks 中配置。

治理任务（Governance Tasks）

八项自动化检查，持续保障站点健康：

• 内容时效性（Content Freshness）——180+ 天未更新的文章
• SEO 健康度（SEO Health）——标题、Alt 文本、Meta 描述、内容长度等指标
• 评论清理（Comment Sweep）——待审核与垃圾评论
• 死链检测（Broken Links）——批量检测（每批最多 50 个）
• 安全扫描（Security Scan）——软件过期、调试模式开启、文件编辑启用等风险项
• 草稿复活（Draft Necromancer）——识别值得续写的废弃草稿（依赖 Ghost Writer）
• 间隔式重提（Spaced Resurfacing）——N 天未更新的笔记
• Tide Report——每日汇总所有治理发现的统一报告

最佳实践

1. 先存草稿，再发布——create-post 默认使用 status: "draft"；待用户确认后再执行发布。
2. 先探查，再操作——重大变更前，请先运行 site-digest 或 site-health 掌握当前状态。
3. 善用 PinchDrop 的 request_id 实现幂等性，用 source 保证可追溯性。
4. 批量操作前务必确认——bulk-edit-posts 功能强大，请先与用户确认操作范围。
5. 请私密保管 Web Clipper 书签工具栏——其中包含采集令牌（capture token）。

内置防护机制

WP Pinch 插件自动启用多层防护：

• 选项黑名单（Option denylist）——auth keys、salts、active_plugins 等敏感项无法通过 API 读取或修改。
• 角色提权拦截（Role escalation blocking）——update-user-role 不允许分配 administrator 或具备 manage_options、edit_users 等能力的角色。
• PII 脱敏（PII redaction）——用户导出与活动流中，邮箱等敏感数据自动剥离。
• 受保护的 Cron Hook（Protected cron hooks）——核心 WordPress Hook（如 wp_update_plugins、wp_scheduled_delete 等）不可被删除。
• 每日写入配额（Daily write budget）——可配置每日写入操作上限，超限时返回 429 并携带 Retry-After。
• 审计日志（Audit logging）——所有操作均有记录。请查阅 WP Pinch → Activity 查看完整操作轨迹。
• 紧急关停开关（Kill switch）——必要时，可在 WP Pinch → Connection 页面一键禁用全部 API 访问。
• 只读模式（Read-only mode）——单次开关即可允许读取、禁止全部写入操作。

错误处理

• rate_limited——退避并重试；若响应头含 Retry-After，请严格遵守。
• daily_write_budget_exceeded（429）——已达当日写入上限；请次日重试。
• validation_error / rest_invalid_param——修正请求参数（如缺失字段、超出长度限制）；不可原样重试。
• capability_denied / rest_forbidden——用户权限不足；请向用户明确提示。
• post_not_found——文章 ID 无效或已被删除；建议先执行列表或搜索操作。
• not_configured——网关 URL 或 API Token 未配置；请提醒管理员完成 WP Pinch 配置。
• 503——API 可能已暂停（触发 Kill Switch 或启用了只读模式）；请检查 WP Pinch → Connection 页面。

完整错误码参考：Error Codes

安全性

• 仅限 MCP——所有操作均经由类型安全、身份认证的 MCP 工具执行。凭证始终保存在 MCP 服务器配置中，绝不出现在提示词中。
• 服务端强制执行——身份认证、权限校验、输入净化与审计日志均由 WP Pinch 插件在每次请求中完成。
• 受限凭证——使用 Application Password 与 OpenClaw Agent 角色实现最小权限访问，并定期轮换。
• 全面审计——所有操作均被记录。请定期查阅 WP Pinch → Activity 页面进行复核。

完整安全模型说明：Security wiki · Plugin source

安装配置

技能环境变量（在您的 OpenClaw 实例中设置）：

MCP 服务器配置（独立于技能环境变量）：

请将您的 MCP 服务器配置为端点 {WP_SITE_URL}/wp-json/wp-pinch/v1/mcp，并提供一个 WordPress Application Password。Application Password 存储于 MCP 服务器配置（如 openclaw.json）中，而非技能环境变量——服务器负责为每次发往 WordPress 的请求完成身份认证，技能本身从不处理任何密钥。

如需管理多个站点，请使用不同的 OpenClaw workspace 或环境配置。

完整配置指南：Configuration