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,我们持续在完善。