Halo Blog

这是管理Halo博客实例的CLI工具，核心功能含多实例认证切换、Markdown文章导入导出、主题插件升级备份、评论通知管理、公开站点搜索等。典型场景有批量发布文章、跨环境管理博客、一键升级主题插件。依赖Node.js≥22，通过命令行输入指令，支持终端文本或JSON输出，适配交互式与自动化需求。

热度 47.40

最近更新 2026-05-18 11:44:24

分类：效率依赖：纯提示词应用场景：博客写作 / 任务管理 / 工作流 / 文件转换

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add halo-blog

Metadata

name: halo-blog
version: 1.0.0
description: Use when managing a Halo blog instance via CLI, including authentication, posts, pages, themes, plugins, attachments, backups, comments, moments, notifications, or public site search.
metadata: {"openclaw":{"category":"content-management","requires":{"bins":["halo"]},"cliHelp":"halo --help"}}

A command-line tool skill for managing Halo blog instances.

npm install -g @halo-dev/cli

Verify:

halo --version
halo --help

Requirements: Node.js >= 22

Authenticate (see references/auth.md):

halo auth login --profile local --url http://127.0.0.1:8090 --auth-type bearer --token <token>

Create a post from Markdown (see content.md for full format rules):
```
halo post import-markdown --file ./article.md --force
```
Markdown files are automatically converted to HTML by default; if conversion fails, falls back to raw Markdown import.
List posts:
```
halo post list
```

Area	Commands	Reference
Authentication	`halo auth *`	auth.md
Publishing Rules	Markdown → HTML workflow, front matter, visibility checks	publishing.md
Posts & Pages	`halo post `, `halo single-page `	content.md
Themes, Plugins, Attachments, Backups, Moments	`halo theme `, `halo plugin `, `halo attachment `, `halo backup `, `halo moment *`	operations.md
Comments & Notifications	`halo comment `, `halo notification `	moderation.md
Public Search	`halo search *`	search.md

Profile selection: Use --profile <name> when working with multiple Halo instances.
JSON output: Use --json for scripted or automated workflows.
Non-interactive safety: Destructive commands (delete, uninstall, overwrite imports) usually require --force when run non-interactively.
Basic Auth requirement: If using basic auth instead of bearer token, ensure Halo is started with --halo.security.basic-auth.disabled=false.

halo auth profile list
halo auth profile use production

halo post export-json my-post --output ./post.json
halo post import-json --file ./post.json --force

halo post import-markdown --file ./article.md --force

halo theme upgrade --all
halo plugin upgrade --all --yes

halo search --keyword "halo" --url https://www.halo.run

Login fails with anonymous user: Basic auth is likely disabled on the Halo server. Add --halo.security.basic-auth.disabled=false to Halo startup flags.
Credential issues: Run halo auth profile doctor to diagnose keyring/config problems.
Profile not found: Ensure --profile matches an existing profile from halo auth profile list.