Halo CLI 是一个用于管理 Halo 实例的命令行工具，覆盖文章、单页、评论、通知、附件、插件、主题、备份等操作。

除了命令行本身，它还附带了一套 Skills——这是专门为 AI Agent 设计的上下文文件，告诉 Agent 这个 CLI 有哪些命令、如何使用，Agent 读取 Skills 之后就能直接操作你的 Halo 站点，不需要你手动解释每一步怎么做。

准备工作

安装 CLI

npm install -g @halo-dev/cli  # 要求 Node.js >= 22

登录 Halo 站点

在 Halo 后台「个人中心 - 个人令牌」生成一个 Token，然后在终端执行：

halo auth login \
  --profile myblog \
  --url https://your-halo-site.com \
  --auth-type bearer \
  --token <your-token>

安装 Skills

npx skills add halo-dev/cli -g

操作前先备份

如果你不完全放心让 Agent 修改网站内容，可以在操作之前，完整备份网站：

halo backup create --wait

开始使用

打开任意支持 Skills 的 AI 客户端或 Agent 工具，比如 Claude Code、Codex、OpenClaw、QClaw 等，加载 Skills 后直接用自然语言描述任务即可。

场景一：SEO 检查并修复最近的文章

提示词：

帮我用 Halo CLI 检查最近发布的 10 篇文章的 SEO 情况：
标题是否清晰、摘要是否存在且合适、标签和分类是否合理。
找出有问题的文章，直接帮我修复。

此示例使用 QClaw

场景二：优化某篇文章

提示词：

帮我用 Halo CLI 优化 my-slow-post 这篇文章：
分析标题、内容、摘要、标签是否有改进空间，给出建议后直接执行。

此示例使用 Copilot CLI

场景三：审核并回复评论

提示词：

用 Halo CLI 查看所有待审核的评论，广告或无意义的直接删掉，
有实质性问题的通过并回复。

此示例使用 QClaw

场景四：更新「关于我们」页面

提示词：

用 Halo CLI 把「关于我们」单页里的联系邮箱改为 hi@example.com，
工作地址新增一个重庆，改完发布。

此示例使用 Copilot CLI

场景五：检查并升级插件

提示词：

使用 Halo CLI 帮我看看当前 Halo 站点有哪些插件可以升级，告诉我每个插件当前版本和最新版本内容
确认之后再升级。

Agent 会先列出所有可升级的插件及版本差异，等你确认后再执行升级。

此示例使用 Copilot CLI

总结

上面这几个场景只是起点。Halo CLI 覆盖了主题、附件、备份等更多操作，配合 Skills 之后，Agent 同样能理解和执行这些命令。日常运营中遇到什么重复性的事，都可以试着直接告诉 Agent，让它想办法用 CLI 完成。

如果有想支持但还没有的功能，或者用下来遇到了问题，欢迎到 halo-dev/cli 提 Issue，我们持续在完善。