Bark 推送通知

通过 Bark API 向 iOS 发送推送通知。

设置

1. 环境变量配置

Bark API 端点：https://api.day.app/{device_key}

设备密钥可按以下优先级从环境变量读取：

1. 1. BARKKEY
2. BARKDEVICE_KEY（OpenClaw 默认配置）

配置方式（在 ~/.zshrc 中）：
bash
export BARK_KEY=你的Bark设备Key

2. 验证配置

bash

测试发送通知

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \
-t 测试 -b Bark推送配置成功！

---

使用方式

方式一：使用 Shell 脚本（推荐）

bash

基本用法

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \
-t 标题 -b 内容

指定铃声

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -t 提醒 -b 时间到了 -s alarm

角标 + 跳转URL

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -t 新消息 -b 你有一条未读消息 -B 1 -u https://example.com

使用指定key（不依赖环境变量）

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -k yourdevicekey -t 标题 -b 内容

设置分组

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -t 标题 -b 内容 -g myapp

紧急通知

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -t 警告 -b 请立即处理！ -l critical

方式二：使用 Node.js 脚本

bash

基本用法

node ~/.openclaw/workspace/skills/bark-push/scripts/bark-send.js \
-t 标题 -b 内容

指定铃声

node ~/.openclaw/workspace/skills/bark-push/scripts/bark-send.js \ -t 提醒 -b 时间到了 -s alarm

方式三：直接使用 curl

bash

简单推送

curl https://api.day.app/$BARK_KEY/标题/内容

带参数

curl -X POST https://api.day.app/$BARK_KEY \ -H Content-Type: application/json \ -d { title: 标题, body: 内容, sound: alarm, badge: 1, group: myapp }

---

脚本参数说明

参数	简写	说明	默认值
--title	-t	推送标题（必填）	-
--body

-b | 推送内容（必填） | - | | --key | -k | Bark设备Key | $BARK_KEY | | --sound | -s | 铃声名称 | default | | --badge | -B | 角标数字 | - | | --url | -u | 点击跳转URL | - | | --group | -g | 分组名称 | - | | --level | -l | 通知级别 | - | | --image | -i | 图片URL | - | | --subtitle | -S | 副标题 | - | | --help | -h | 显示帮助 | - |

---

通知级别（level）

值	说明
passive	不显示，不震动，不播放声音
active

显示但不震动 | | timeSensitive | 定时敏感，24小时内可撤 | | critical | 强制响铃（需要权限） |

---

常用铃声（sound）

铃声名称	说明
default	系统默认
alarm

警报 | | alarm | 闹钟 | | bird | 鸟叫 | | bell | 门铃 | | cha_ching | 金币 | | doorbell | 门铃 | | droplet | 水滴 | | horn | 喇叭 | | light | 轻提示 | | mail | 邮件 | | rimba | 节奏 | | siren | 警笛 | | spinebreak | 震撼 | | spring | 弹簧 | | streak | 短信 | | sword | 剑士 | | tip | 提示 | | minut | 铃声 |

---

在 OpenClaw 中使用

在 OpenClaw 中可以直接调用脚本发送通知：

bash

简单通知

~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \
-t 提醒 -b 任务完成！

发送失败通知（在脚本中使用）

if [ $? -ne 0 ]; then ~/.openclaw/workspace/skills/bark-push/scripts/bark-send.sh \ -t 错误 -b 备份失败，请检查！ -l critical fi

---

故障排除

发送失败

1. 1. 检查 BARKKEY 是否正确：echo $BARKKEY
2. 测试网络连接：ping api.day.app
3. 查看详细错误：添加 -v 或检查返回的 JSON

通知不响

1. 1. 检查手机设置 → 通知 → Bark
2. 检查是否开启声音和震动
3. 尝试使用不同的 sound 参数