FreePublished on GitHub

clawhip

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

The English summary is being prepared. Showing the original description.

Yeachan-Heo/clawhip

Works withDiscord GitHub

See how to install

Files included (139)

SKILL.md4.2 KB
.github/workflows/ci.yml9.4 KB
.github/workflows/release.yml16.7 KB
.gitignore126 B
AGENTS.md1.1 KB
ARCHITECTURE.md5.2 KB
artifacts/issue-360-qa.json2.7 KB
assets/clawhip-mascot.jpg71.5 KB
build.rs5.7 KB
build/gitdir.rs7.0 KB
Cargo.lock57.2 KB
Cargo.toml1.4 KB
CHANGELOG.md18.7 KB
deploy/clawhip.service244 B
dist-workspace.toml683 B
docs/canonical-contract-cleanup.md1.8 KB
docs/event-contract-v1.md3.6 KB
docs/event-ledger.md5.7 KB
docs/examples/MEMORY.example.md1.1 KB
docs/examples/memory/channels/example-channel.md404 B
docs/examples/memory/daily/2026-03-10.md445 B
docs/examples/memory/projects/clawhip.md266 B
docs/examples/memory/README.example.md817 B
docs/examples/memory/topics/lessons.md193 B
docs/examples/memory/topics/rules.md141 B
docs/geobench.md872 B
docs/gjc-sdk-event-bridge.md7.9 KB
docs/gjc-sdk-integration.md7.7 KB
docs/live-verification.md7.5 KB
docs/memory-offload-architecture.md6.3 KB
docs/memory-offload-guide.md6.0 KB
docs/native-event-contract.md4.9 KB
geobench/clawhip.yaml2.4 KB
install.sh8.2 KB
integrations/git/install-hooks.sh476 B
integrations/git/post-checkout.sh648 B
integrations/git/post-commit.sh443 B
integrations/omx/README.md457 B
integrations/tmux/notify-keyword.sh507 B
integrations/tmux/scan-keywords.sh1.4 KB
integrations/tmux/stale-check.sh1.7 KB
LICENSE1.0 KB
plugins/claude-code/bridge.sh76 B
plugins/claude-code/plugin.toml109 B
plugins/codex/bridge.sh70 B
plugins/codex/plugin.toml97 B
README.md59.5 KB
scripts/internal-pr-format-gate.sh1.2 KB
scripts/live-verify-default-presets.sh3.4 KB
skills/memory-offload/SKILL.md1.7 KB
skills/omc/SKILL.md826 B
skills/omx/SKILL.md826 B
src/binding_verify.rs48.1 KB
src/build_info.rs6.5 KB
src/cli.rs81.1 KB
src/client.rs21.5 KB
src/config.rs274.0 KB
src/core/circuit_breaker.rs4.6 KB
src/core/dlq.rs1.7 KB
src/core/mod.rs79 B
src/core/rate_limit.rs2.5 KB
src/core/timer_wheel.rs4.5 KB
src/cron.rs60.9 KB
src/daemon.rs244.2 KB
src/deployment.rs15.3 KB
src/discord_watch.rs36.2 KB
src/discord.rs68.5 KB
src/dispatch.rs100.1 KB
src/dynamic_tokens.rs5.3 KB
src/event/body.rs4.5 KB
src/event/compat.rs38.6 KB
src/event/mod.rs2.8 KB
src/events.rs84.7 KB
src/gajae.rs100.8 KB
src/gateway_allowlist.rs14.1 KB
src/gjc_lane.rs222.8 KB
src/gjc_sdk_events.rs83.9 KB
src/gjc_sdk.rs106.2 KB
src/gjc/api.rs19.5 KB
src/gjc/cli.rs10.4 KB
src/gjc/control.rs72.3 KB
src/gjc/mod.rs562 B
src/gjc/model.rs26.1 KB
src/gjc/transport.rs20.1 KB
src/hooks/mod.rs13.0 KB
src/hooks/prompt_deliver.rs45.0 KB
src/keyword_window.rs90.3 KB
src/lane.rs29.4 KB
src/ledger.rs52.2 KB
src/lib.rs1 B
src/lifecycle.rs16.6 KB
src/main.rs58.4 KB
src/memory.rs45.6 KB
src/monitor.rs68 B
src/native_hooks.rs61.9 KB
src/native_observability.rs20.1 KB
src/plugins.rs7.2 KB
src/provenance.rs8.9 KB
src/release_preflight.rs16.4 KB
src/render/default.rs70.0 KB
src/render/mod.rs247 B
src/router.rs111.2 KB
src/sender_identity.rs12.4 KB
src/sink/discord.rs669 B
src/sink/http.rs60.6 KB
src/sink/local_file.rs4.8 KB
src/sink/mod.rs1.1 KB
src/sink/slack.rs576 B
src/slack.rs4.3 KB
src/source_checkout.rs44.0 KB
src/source/git.rs50.0 KB
src/source/github_notifications.rs93.5 KB
src/source/github_pr_activity_metadata_tests.rs19.8 KB
src/source/github_status.rs27.0 KB
src/source/github.rs406.2 KB
src/source/mod.rs1.2 KB
src/source/subscription.rs41.0 KB
src/source/tmux.rs190.6 KB
src/source/workspace.rs37.5 KB
src/telemetry.rs10.6 KB
src/tmux_wrapper.rs82.4 KB
src/update.rs9.9 KB
tests/build_rs_worktree.rs25.2 KB
tests/common/gjc_fake_server.rs18.9 KB
tests/common/gjc_wire.rs11.8 KB
tests/common/mod.rs283 B
tests/config_backup_cleanup.rs11.8 KB
tests/event_ledger_e2e.rs6.0 KB
tests/gajae_profile_install_stdin.rs26.3 KB
tests/gjc_fake_server_contract.rs15.6 KB
tests/gjc_sdk_event_bridge.rs16.3 KB
tests/gjc_sdk_full_loop_e2e.rs29.8 KB
tests/gjc_sdk_transport.rs29.4 KB
tests/install_star_prompt.rs13.7 KB
tests/lane_thread_verification.rs76.6 KB
tests/provider_native_docs_regression.rs1.8 KB
tests/runtime_config.rs805 B
tests/sender_identity_verification.rs17.3 KB
tests/setup_bind_legacy_route_only.rs2.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

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

Primary install flow

Preferred operator instruction:

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

Expected automation flow:

clone repo
run ./install.sh
read this SKILL.md
attach skill
scaffold ~/.clawhip/config.toml
start daemon
run live verification presets

Runtime surface

Default daemon URL:

http://127.0.0.1:25294

Core commands:

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

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:

Go to Discord Developer Portal
Create a new application (e.g. "clawhip-notifier" or "CCNotifier")
Create a bot, copy the token
Invite the bot to your server with Send Messages permission
Use this token in ~/.clawhip/config.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:

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

Dynamic template opt-in

[[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

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/Yeachan-Heo/clawhip --skill clawhip

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/Yeachan-Heo/clawhip

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/clawhip/ for Claude Code, or ~/.agents/skills/clawhip/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: Yeachan-Heo/clawhip
Stars: 936
Forks: 166
Category: Other
License: MIT
Original language: English
Last updated: Oct 16, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.