# Send barkpush to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "barkpush",
    "name": "barkpush",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/liberalchang/barkpush",
    "canonicalUrl": "https://clawhub.ai/liberalchang/barkpush",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/barkpush",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=barkpush",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "tests/python_m_test_commands.md",
      "tests/test_bark_api.py",
      "tests/test_config_manager.py",
      "tests/test_content_parser.py",
      "tests/test_history_manager.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "barkpush",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T17:39:13.930Z",
      "expiresAt": "2026-05-11T17:39:13.930Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=barkpush",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=barkpush",
        "contentDisposition": "attachment; filename=\"barkpush-1.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "barkpush"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/barkpush"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/barkpush",
    "downloadUrl": "https://openagent3.xyz/downloads/barkpush",
    "agentUrl": "https://openagent3.xyz/skills/barkpush/agent",
    "manifestUrl": "https://openagent3.xyz/skills/barkpush/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/barkpush/agent.md"
  }
}
```
## Documentation

### Bark Push Skill

🔔 智能 Bark 推送助手，为您提供便捷、灵活的消息推送服务。

### 🎯 智能内容识别

自动识别您发送的内容类型，以最优方式推送：

纯图片：直接推送图片 URL（使用 image 参数）
纯链接：直接推送链接（使用 url 参数）
纯文本：推送文本内容（使用 body 参数）
混合内容：自动整理为 Markdown 格式

### 👥 多用户管理

支持单用户推送：--user alice
支持多用户推送：--user alice,bob,charlie
支持全员推送：--user all
使用别名简化操作，无需记忆复杂的 device_key
未指定用户时智能提示可用用户列表

### 📝 智能标题生成

用户未输入标题时，自动根据内容生成 title 和 subtitle
用户指定标题时，优先使用用户提供的标题

### 📂 分组管理

支持查询和使用 Bark 分组功能
可指定消息分组或使用默认分组
分组不存在时自动使用默认分组

### 🔄 历史记录与更新

保存推送历史记录（推送 ID、用户、参数等）
支持查询历史并更新已推送的消息内容
支持删除已推送的消息
历史记录自动管理，超过限制自动删除最旧记录

### ⚙️ 灵活参数配置

通过 JSON 配置文件管理默认推送参数：

level：消息级别（passive/active/time-sensitive/critical）
volume：警告通知音量（0-10）
badge：应用角标数字
sound：通知声音
icon：自定义图标 URL
call：是否呼叫
autoCopy：是否自动复制
copy：复制到剪贴板的内容
isArchive：是否自动归档
action：自定义动作

用户指定的参数优先于默认配置。

### 📊 智能结果反馈

根据操作结果返回清晰的信息：

推送成功：显示推送 ID、成功用户列表、参数摘要、内容简要
推送失败：显示失败原因、失败用户列表、参数摘要、内容简要
指令错误：显示错误原因、解析的参数列表、内容简要

### 配置文件

首次使用前，创建配置文件 config.json：

{
  "default_push_url": "https://api.day.app",
  "ciphertext": "",
  "users": {
    "alice": "your_device_key_1",
    "bob": "your_device_key_2"
  },
  "defaults": {
    "level": "active",
    "volume": 10,
    "badge": 1,
    "sound": "bell",
    "icon": "",
    "group": "default",
    "call": false,
    "autoCopy": false,
    "copy": "",
    "isArchive": true,
    "action": ""
  },
  "groups": ["work", "personal", "urgent"],
  "history_limit": 100,
  "enable_update": true
}

### 基本使用

# 推送简单文本消息
bark-push --user alice --content "Hello, World!"

# 推送带标题的消息
bark-push --user alice --title "重要通知" --content "会议将在10分钟后开始"

# 推送图片
bark-push --user bob --content "https://example.com/photo.jpg"

# 推送给多个用户
bark-push --user alice,bob --title "团队通知" --content "项目已上线"

# 推送给所有用户
bark-push --user all --title "系统公告" --content "服务器维护通知"

# 指定消息级别
bark-push --user alice --content "紧急事件" --level critical

# 指定分组
bark-push --user alice --content "工作提醒" --group work

# 更新已推送的消息
bark-push --update abc123 --user alice --content "会议时间改为15分钟后"

# 删除已推送的消息
bark-push --delete abc123 --user alice

# 查看历史记录
bark-push --list-history --history-limit 20

# 查看用户列表
bark-push --list-users

# 查看帮助信息
bark-push --help-skill

### 基本参数

参数说明示例--config配置文件路径--config ./config.json--user, -u指定推送用户（别名或 device_key）--user alice--title, -t消息标题--title "重要通知"--subtitle消息副标题--subtitle "10分钟后"--content, -c消息内容--content "消息内容"--group指定分组--group work--help-skill显示帮助信息--help-skill

### 推送参数

参数说明取值范围--level消息级别passive, active, time-sensitive, critical--volume音量0-10--badge角标数字整数--sound通知声音bell, chime, glass 等--icon图标 URL完整的 HTTPS URL--call是否呼叫1/0/true/false--autoCopy自动复制1/0/true/false--copy复制内容字符串--isArchive自动归档1/0/true/false--action自定义动作JSON 字符串--ciphertext加密密文字符串

### 操作参数

参数说明示例--update更新已推送的消息--update abc123--delete删除已推送的消息--delete abc123--list-users列出所有用户--list-users--list-groups列出所有分组--list-groups--list-history列出历史记录--list-history --history-limit 20--history-limit历史列表条数--history-limit 20

### 用户别名配置

在 config.json 的 users 字段中配置用户别名：

{
  "users": {
    "alice": "device_key_alice_123",
    "bob": "device_key_bob_456",
    "charlie": "device_key_charlie_789"
  }
}

### 默认参数配置

在 config.json 的 defaults 字段中配置默认推送参数：

{
  "defaults": {
    "level": "active",
    "volume": 10,
    "badge": 1,
    "sound": "bell",
    "group": "default"
  }
}

### 分组配置

在 config.json 的 groups 字段中定义可用分组：

{
  "groups": ["work", "personal", "urgent", "family"]
}

### 历史记录限制

在 config.json 的 history_limit 字段中设置历史记录保存数量：

{
  "history_limit": 100
}

### 加密密文配置

{
  "ciphertext": "your_encryption_key"
}

### 场景 1：日常提醒

bark-push --user alice --content "别忘了下午3点的会议"

### 场景 2：系统监控告警

bark-push --user all --title "服务器告警" --content "CPU使用率超过90%" --level critical --sound alarm

### 场景 3：团队协作通知

bark-push --user alice,bob,charlie --title "项目进度" --content "前端开发已完成，请开始测试" --group work

### 场景 4：图片分享

bark-push --user bob --content "https://example.com/screenshot.png"

### 场景 5：消息更新

# 首次推送
bark-push --user alice --content "会议将在10分钟后开始"
# 返回推送 ID：abc123

# 更新消息
bark-push --update abc123 --user alice --content "会议时间改为15分钟后"

### 配置文件找不到

如果提示配置文件不存在，请在当前目录或 ~/.bark-push/ 目录下创建 config.json 文件。

### 推送失败

检查网络连接是否正常
验证 device_key 是否正确
确认 Bark 服务地址是否可访问
查看错误日志获取详细信息

### 用户不存在

如果提示用户不存在，使用 --list-users 命令查看可用用户列表，并在 config.json 中添加用户配置。

### 历史记录不可用

确保 ~/.bark-push/ 目录具有写入权限，历史记录文件会自动创建。

### 加密推送

如果配置了 ciphertext，所有推送将使用加密方式发送：

{
  "ciphertext": "your_encryption_key"
}

### 自定义动作

支持 Bark 的自定义动作功能，可以在通知中添加交互按钮：

bark-push --user alice --content "是否同意?" --action '{"action":"confirm","text":"同意"}'

### 批量推送

使用脚本批量推送消息：

#!/bin/bash
for user in alice bob charlie; do
  bark-push --user $user --content "批量通知消息"
done

### 贡献指南

欢迎提交问题和改进建议！

### 许可证

MIT License

### 相关链接

Bark 官方网站
Bark API 文档
ClawHub 项目
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: liberalchang
- Version: 1.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T17:39:13.930Z
- Expires at: 2026-05-11T17:39:13.930Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/barkpush)
- [Send to Agent page](https://openagent3.xyz/skills/barkpush/agent)
- [JSON manifest](https://openagent3.xyz/skills/barkpush/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/barkpush/agent.md)
- [Download page](https://openagent3.xyz/downloads/barkpush)