本文へ移動
cccskills
無料GitHub で公開

clawhip

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

Yeachan-Heo/clawhip
インストール方法を見る

含まれるファイル（137）

  • 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.md15.3 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.md40.2 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.rs47.5 KB
  • src/build_info.rs6.5 KB
  • src/cli.rs81.1 KB
  • src/client.rs21.5 KB
  • src/config.rs265.6 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.rs208.5 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.rs3.6 KB
  • src/event/compat.rs33.9 KB
  • src/event/mod.rs2.6 KB
  • src/events.rs82.3 KB
  • src/gajae.rs100.4 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.rs67.3 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.rs59.5 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_status.rs27.0 KB
  • src/source/github.rs263.1 KB
  • src/source/mod.rs1.1 KB
  • src/source/subscription.rs41.0 KB
  • src/source/tmux.rs190.6 KB
  • src/source/workspace.rs37.5 KB
  • src/telemetry.rs10.2 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（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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:

  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:

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:

  1. Go to Discord Developer Portal
  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:
[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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く
このスキルの問題を報告する