clawhip

分类: 数据库与数据存储 | 上传者: Yeachan-Heo | 下载: 0 | 版本: v1.0（最新）

附加/安装/使用clawhip作为OpenClaw / Clawdbot的守护进程优先通知网关运行时

更新日志: Source: GitHub https://github.com/Yeachan-Heo/clawhip

目录结构

当前层级: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 1.4 KB
  - 📄 release.yml 12.7 KB
📁 .omx/
- 📁 context/
  - 📄 clawhip-build-20260308T103330Z.md 952 B
- 📁 logs/
  - 📄 hooks-2026-03-08.jsonl 1.3 KB
  - 📄 notify-fallback-2026-03-08.jsonl 834.5 KB
  - 📄 notify-fallback-2026-03-09.jsonl 26.1 KB
  - 📄 notify-hook-2026-03-08.jsonl 161 B
  - 📄 omx-2026-03-08.jsonl 152 B
  - 📄 tmux-hook-2026-03-08.jsonl 1.3 KB
  - 📄 turns-2026-03-08.jsonl 2.8 KB
- 📁 plans/
  - 📄 autopilot-impl.md 778 B
  - 📄 autopilot-spec.md 1.5 KB
- 📁 state/
  - 📁 sessions/
    
    📁 omx-1772965833622-69uz5f/
    
    📄 AGENTS.md 402 B
    
    📄 autopilot-state.json 346 B
  - 📄 auto-nudge-state.json 66 B
  - 📄 hud-state.json 200 B
  - 📄 notify-fallback-state.json 557 B
  - 📄 notify-fallback.pid 64 B
  - 📄 notify-hook-state.json 537 B
  - 📄 session.json 290 B
  - 📄 skill-active-state.json 238 B
  - 📄 team-leader-nudge.json 65 B
  - 📄 tmux-hook-state.json 203 B
  - 📄 update-check.json 82 B
- 📄 metrics.json 232 B
- 📄 notepad.md 1.4 KB
- 📄 tmux-hook.json 390 B
📁 assets/
- 📄 clawhip-mascot.jpg 71.5 KB
📁 deploy/
- 📄 clawhip.service 244 B
📁 docs/
- 📁 examples/
  - 📁 memory/
    
    📁 channels/
    
    📄 example-channel.md 404 B
    
    📁 daily/
    
    📄 2026-03-10.md 445 B
    
    📁 projects/
    
    📄 clawhip.md 266 B
    
    📁 topics/
    
    📄 lessons.md 193 B
    
    📄 rules.md 141 B
    
    📄 README.example.md 817 B
  - 📄 MEMORY.example.md 1.1 KB
- 📄 live-verification.md 3.8 KB
- 📄 memory-offload-architecture.md 6.3 KB
- 📄 memory-offload-guide.md 6.0 KB
- 📄 native-event-contract.md 4.7 KB
📁 integrations/
- 📁 git/
  - 📄 install-hooks.sh 476 B
  - 📄 post-checkout.sh 648 B
  - 📄 post-commit.sh 443 B
- 📁 tmux/
  - 📄 notify-keyword.sh 507 B
  - 📄 scan-keywords.sh 1.4 KB
  - 📄 stale-check.sh 1.7 KB
📁 plugins/
- 📁 claude-code/
  - 📄 bridge.sh 76 B
  - 📄 plugin.toml 109 B
- 📁 codex/
  - 📄 bridge.sh 70 B
  - 📄 plugin.toml 97 B
📁 scripts/
- 📄 live-verify-default-presets.sh 3.4 KB
📁 skills/
- 📁 memory-offload/
  - 📄 SKILL.md 1.7 KB
- 📁 omc/
  - 📄 create.sh 2.7 KB
  - 📄 prompt.sh 570 B
  - 📄 SKILL.md 2.8 KB
  - 📄 tail.sh 333 B
- 📁 omx/
  - 📄 create.sh 2.6 KB
  - 📄 prompt.sh 570 B
  - 📄 SKILL.md 2.8 KB
  - 📄 tail.sh 333 B
📁 src/
- 📁 core/
  - 📄 circuit_breaker.rs 3.1 KB
  - 📄 dlq.rs 1.2 KB
  - 📄 mod.rs 79 B
  - 📄 rate_limit.rs 2.5 KB
  - 📄 timer_wheel.rs 4.5 KB
- 📁 event/
  - 📄 body.rs 2.3 KB
  - 📄 compat.rs 15.3 KB
  - 📄 mod.rs 1.6 KB
- 📁 render/
  - 📄 default.rs 25.6 KB
  - 📄 mod.rs 247 B
- 📁 sink/
  - 📄 discord.rs 669 B
  - 📄 mod.rs 656 B
  - 📄 slack.rs 576 B
- 📁 source/
  - 📄 git.rs 7.5 KB
  - 📄 github.rs 34.7 KB
  - 📄 mod.rs 411 B
  - 📄 tmux.rs 29.3 KB
- 📄 cli.rs 23.1 KB
- 📄 client.rs 2.0 KB
- 📄 config.rs 29.1 KB
- 📄 daemon.rs 11.7 KB
- 📄 discord.rs 13.8 KB
- 📄 dispatch.rs 25.1 KB
- 📄 dynamic_tokens.rs 5.3 KB
- 📄 events.rs 54.3 KB
- 📄 keyword_window.rs 5.3 KB
- 📄 lifecycle.rs 11.6 KB
- 📄 main.rs 8.8 KB
- 📄 memory.rs 22.4 KB
- 📄 monitor.rs 68 B
- 📄 plugins.rs 6.7 KB
- 📄 router.rs 43.7 KB
- 📄 slack.rs 3.9 KB
- 📄 tmux_wrapper.rs 12.0 KB
📁 tests/
- 📄 install_star_prompt.rs 4.8 KB
📄 .gitignore 16 B
📄 AGENTS.md 1.1 KB
📄 ARCHITECTURE.md 4.1 KB
📄 Cargo.lock 50.7 KB
📄 Cargo.toml 956 B
📄 CHANGELOG.md 1.8 KB
📄 dist-workspace.toml 723 B
📄 install.sh 6.1 KB
📄 LICENSE 1.0 KB
📄 README.md 21.5 KB
📄 SKILL.md 4.2 KB

SKILL.md

---
name: clawhip
description: Attach/install/use clawhip as a daemon-first notification gateway runtime for OpenClaw / Clawdbot
---

# clawhip skill attachment surface

## Intent

Use this repo as:
- executable/runtime repo
- daemon process for Discord notification routing
- attachable skill surface for OpenClaw / Clawdbot

## Prerequisites

⭐ If you want to support clawhip, star this repository. The interactive repo-local installer and `clawhip install` can offer an optional post-install GitHub star prompt via authenticated `gh api` access when `gh` is installed and authenticated. Skip it with `--skip-star-prompt` or `CLAWHIP_SKIP_STAR_PROMPT=1`.

```bash
gh api --method PUT /user/starred/Yeachan-Heo/clawhip --silent
```

## Primary install flow

Preferred operator instruction:

```text
@openclaw install https://github.com/Yeachan-Heo/clawhip
```

Expected automation flow:

1. clone repo
2. run `./install.sh`
3. read this `SKILL.md`
4. attach skill
5. scaffold `~/.clawhip/config.toml`
6. start daemon
7. run live verification presets

## Runtime surface

Default daemon URL:

```text
http://127.0.0.1:25294
```

Core commands:

```bash
clawhip
clawhip start
clawhip status
clawhip config
clawhip send --channel <id> --message "..."
clawhip github issue-opened ...
clawhip github pr-status-changed ...
clawhip git commit ...
clawhip tmux keyword ...
clawhip tmux stale ...
clawhip tmux new -s <session> --channel <id> --keywords error,complete --shell /bin/zsh -- command
clawhip tmux watch -s <existing-session> --channel <id> --mention '<@id>' --keywords error,complete
```

## Lifecycle surface

```bash
clawhip install
clawhip install --systemd
clawhip install --skip-star-prompt
clawhip update --restart
clawhip uninstall --remove-systemd --remove-config
./install.sh
./install.sh --systemd
./install.sh --skip-star-prompt
```

## Discord bot token (recommended setup)

⚠️ **Create a dedicated Discord bot for clawhip notifications.** Do not reuse your Clawdbot / OpenClaw bot token.

Why:
- clawhip sends high-volume notifications (commits, PRs, tmux events)
- Using the same bot token as your gateway pollutes the bot's identity
- A separate bot (e.g. "CCNotifier") keeps notifications cleanly separated from AI chat
- If clawhip restarts or crashes, it won't affect your main bot

Setup:
1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Create a new application (e.g. "clawhip-notifier" or "CCNotifier")
3. Create a bot, copy the token
4. Invite the bot to your server with Send Messages permission
5. Use this token in `~/.clawhip/config.toml`:

```toml
[discord]
token = "your-dedicated-clawhip-bot-token"
```

## Config scaffold expectations

Key sections:
- `[discord]`
- `[daemon]`
- `[defaults]`
- `[[routes]]`
- `[monitors]`
- `[[monitors.git.repos]]`
- `[[monitors.tmux.sessions]]`

Typical preset route:

```toml
[[routes]]
event = "github.*"
filter = { repo = "clawhip" }
channel = "1480171113253175356"
mention = "<@1465264645320474637>"
format = "compact"
```

## Dynamic template opt-in

```toml
[[routes]]
event = "tmux.*"
allow_dynamic_tokens = true
template = "{session}\n{tmux_tail:issue-1456:20}\n{iso_time}"
```

Allowed dynamic tokens:
- `{sh:...}`
- `{tmux_tail:session:lines}`
- `{file_tail:/path:lines}`
- `{env:NAME}`
- `{now}`
- `{iso_time}`

## Filesystem-offloaded memory pattern

When using clawhip as part of a broader Claw OS workflow, treat memory as an offloaded filesystem tree:

- `MEMORY.md` = small pointer/index/current-beliefs layer
- `memory/` = detailed project/channel/daily/handoff memory
- update root memory only when the map or current summary changes

Read before adopting this pattern:

- `docs/memory-offload-architecture.md`
- `docs/memory-offload-guide.md`
- `docs/examples/MEMORY.example.md`
- `skills/memory-offload/SKILL.md`

## Verification surface

Use the live operational runbook:
- `docs/live-verification.md`
- `scripts/live-verify-default-presets.sh`

Preset verification targets:
- GitHub issue opened / commented / closed
- GitHub PR opened / status changed / merged
- git commit monitor
- tmux keyword / stale / wrapper / watch
- install / update / uninstall

## Attachment summary

```text
repo = runtime
SKILL.md = attach/install/usage contract
README.md = operational spec for agents
```

登录后下载/点赞/收藏 ❤ 156 | ★ 0

clawhip

目录结构

SKILL.md

举报内容

提示