ghst CLI 技能

该技能封装了 ghst CLI 工具，使智能体能够通过 Ghost Admin API 直接与任意 Ghost 实例交互。

前提条件与安装

要使该技能正常工作，系统 $PATH 中必须可访问 ghst 二进制文件。

本地安装

使用 npm 从官方 npm 仓库全局安装 CLI：

npm install -g @tryghost/ghst

或者，您也可以通过 npx 运行（无需永久安装），但重复执行智能体任务时性能较低：

npx @tryghost/ghst --help

安全性：请始终从官方 npm 仓库（https://www.npmjs.com/package/@tryghost/ghst）安装 @tryghost/ghst。建议锁定至特定、经审核的版本，而非依赖运行时自动解析的版本（例如：npm install -g @tryghost/ghst@1.2.3）。请有意识地保持包更新，并在升级前查阅发布说明。

Docker / 容器化环境

若在 Docker 中运行 OpenClaw，请确保 ghst 二进制文件已包含在容器镜像中，方法是在 Dockerfile 中添加安装指令：

RUN npm install -g @tryghost/ghst

配置与认证

为与 Ghost 实例交互，智能体需提供 Ghost API URL 和 Ghost Staff 访问令牌（Staff Access Token）。在 ghst 技能中可通过以下两种主要方式实现：

1. 显式参数：--url 与 --staff-token
2. 环境变量：GHOST_URL 与 GHOST_STAFF_ACCESS_TOKEN

Staff 账户与令牌安全

为最小化风险，请创建一个专用于智能体访问的 Ghost Staff 账户，并仅授予其完成任务所需的最低权限（例如 Author 或 Editor，而非 Owner）。请安全存储 GHOST_STAFF_ACCESS_TOKEN —— 切勿将其提交至版本控制系统，亦不可在聊天日志中暴露。一旦令牌泄露，请立即通过 Ghost 后台管理面板轮换该令牌；当智能体不再需要访问权限时，请禁用或删除该令牌。

机器人所有者操作指南

1. 进入您的 Ghost 后台管理面板。
2. 依次点击 Settings → Staff（或 Users）→ 编辑您的用户资料。
3. 在页面底部生成或复制一个 Staff Access Token。

选项 1 — ~/.openclaw/.env（推荐用于个人用途）

直接将变量添加至 ~/.openclaw/.env 文件：

GHOST_URL="https://your-blog-url.ghost.io"
GHOST_STAFF_ACCESS_TOKEN="your-staff-access-token-id:secret"

选项 2：在 openclaw.json 中配置技能专属环境变量（按技能注入）

在 ~/.openclaw/openclaw.json 中，于对应技能条目下添加 env 区块：

{
  "skills": {
    "entries": {
      "ghst": {
        "enabled": true,
        "env": {
          "GHOST_URL": "https://your-blog-url.ghost.io",
          "GHOST_STAFF_ACCESS_TOKEN": "your-staff-access-token-id:secret"
        }
      }
    }
  }
}

完成配置后，请重启智能体，或等待配置被自动加载。

高级环境变量

对于复杂部署场景，支持以下环境变量：

智能体操作规范与使用指南

使用 ghst 技能时，智能体必须遵守以下规则，以确保操作稳健且安全。

1. 健壮的脚本编写

• 始终使用 --json 或 --jq：确保命令输出机器可读的 JSON，而非面向人类的文本格式。

  ghst post list --json
  ghst post list --json --jq '.posts[].title'
  

• 使用 --non-interactive：由于运行于自动化环境中，切勿执行意外触发用户输入提示的命令。对任何已获用户批准的破坏性操作，请组合使用 --yes 与 --non-interactive。

  ghst comment delete  --yes --non-interactive
  

• 非交互式认证：如需以编程方式认证新站点：

  ghst auth login --non-interactive --url "https://blog.com" --staff-token "..."
  

2. 编辑文章与页面

有关“读取-编辑-写入”（Read-Edit-Write）工作流的详细说明（包括对文章或页面词汇内容进行微调重写、URL 修改等），请参阅 editing.md 参考文档。

3. 搜索与筛选文章及页面

当需要查找特定文章或页面（例如按标题、状态或标签筛选）时，请参考 post.md 和 page.md 中记录的高级筛选与 NQL 查询示例。

命令参考

各资源类型的详细文档位于 references/ 目录中：

典型工作流示例：

• 批量文章打标：ghst post bulk --filter "status:draft" --update --add-tag "Release"
• 成员清理：ghst member bulk --filter "status:free" --action delete --yes --non-interactive
• 分析数据导出：ghst stats posts --range 30d --csv --output ./report.csv
• 社交互动：ghst socialweb note --content "Hello from the CLI"

4. 安全操作与防护机制

• 审批与通知：在执行以下任一操作前，必须获得用户的明确确认：

  • 发布、定时或取消发布文章/页面
  • 删除文章、页面、成员、评论、标签、主题或任何其他资源
  • 批量更新或批量删除（ghst ... bulk ...）
  • 修改站点设置（ghst setting set）
  • 创建、更新或删除 Webhook（ghst webhook）
  • 导入或导出数据（ghst migrate、ghst member export）
  • 原始 API 调用（ghst api）

  注意：当手动确认流程被中断时，CLI 将在 stderr 输出以 GHST_AGENT_NOTICE: 开头的日志行。若出现此类提示，您必须立即中止操作，并向用户请求明确授权。

• 优先执行列表查询 / 获取操作：在执行任何破坏性或变更性操作前，应优先列出或获取目标资源以核实其身份。务必使用精确 ID 或精确 slug，避免模糊匹配或主观假设。

• 破坏性命令：仅在用户明确批准后，方可对以下命令使用 --yes --non-interactive：

  • ghst member bulk --action delete
  • ghst label bulk --action delete
  • ghst socialweb delete
  • ghst auth logout
  • ghst auth link（替换当前活跃链接时）

• 文件安全：类似 member export 和 migrate export 的 CLI 工具将拒绝覆盖已存在的文件。必要时，请在导出前检查目标文件是否存在。

• 安全检查：切勿未经提示地将敏感令牌（例如来自 ghst auth token 或 config --show-secrets 的输出值）打印或输出至聊天窗口。请将其视为高权限凭证予以对待。