OpenClaw 是一个强大的 AI 助手运行环境，而 Halo CLI 是 Halo 官方提供的命令行工具。两者结合后，你可以让 AI 助手直接帮你写博客文章并发布到 Halo 站点，实现真正的自动化内容创作。

本文详细介绍如何在 OpenClaw 中安装 Halo CLI，并通过 API 方式实现博客文章的自动化管理。

一、环境说明

本文的操作环境：

• OpenClaw：最新版本

• Halo CMS：2.24.0（最新）

• Halo CLI：1.3.0

• Node.js：v22.22.2

• npm：10.9.7

二、安装 Halo CLI

在 OpenClaw 的终端中执行以下命令全局安装 Halo CLI：

npm install -g @halo-dev/cli

安装完成后验证：

halo --version

三、生成 Personal Access Token

Halo CLI 需要通过 Personal Access Token（PAT）来认证你的身份。生成步骤如下：

1. 登录你的 Halo 站点后台

2. 进入 设置 → 个人资料 → Token

3. 点击「生成 Token」，填写名称

4. 复制生成的 Token（以 pat_ 开头）

注意：Token 一旦生成只显示一次，请妥善保存；不要将 Token 泄露给他人；如果怀疑泄露，请立即在后台删除并重新生成。

四、连接 OpenClaw 与 Halo 站点

Halo CLI 默认将 Token 存储在系统的安全存储中，但在某些服务器环境下可能没有安装 libsecret 库，导致存储失败。解决方案是：不依赖 Halo CLI 的 auth login，直接通过 API 调用来管理文章。

五、API 方式发布文章

通过直接调用 Halo 的 REST API，可以实现完整的文章管理功能。

5.1 创建草稿文章

curl -s -X POST "https://你的域名.com/apis/uc.api.content.halo.run/v1alpha1/posts" -H "Authorization: Bearer your-token" -H "Content-Type: application/json" -d '{"apiVersion": "content.halo.run/v1alpha1", "kind": "Post", "metadata": {"name": "article-name"}, "spec": {"title": "文章标题", "slug": "article-slug", "publish": false}}'

5.2 发布已创建的文章

curl -s -X PUT "https://你的域名.com/apis/uc.api.content.halo.run/v1alpha1/posts/文章name/publish" -H "Authorization: Bearer your-token"

5.3 查询文章

curl -s "https://你的域名.com/apis/uc.api.content.halo.run/v1alpha1/posts?page=0&size=20" -H "Authorization: Bearer your-token"

六、注意事项

Halo UC API 不需要 {post: {...}} 包装，直接发送 Post 对象即可。很多教程写的是错的。

创建文章时 slug（URL 别名）必须唯一，否则会报错。建议使用「日期 + 标题」的方式命名。

七、总结

通过本文，你应该已经掌握了：在 OpenClaw 中安装 Halo CLI、在 Halo 后台生成 Personal Access Token、通过 API 方式创建发布管理文章、了解常见的坑点及解决方案。

Halo CLI 本身功能很强大，文章管理只是其中一小部分。它还支持主题管理、插件管理、附件管理等更多功能。

参考资料

• Halo 官方文档：https://www.halo.run

• Halo CLI 项目：https://github.com/halo-dev/cli