openpr-webhook

Webhook receiver for OpenPR. Receives webhook events from OpenPR and dispatches notifications to AI agents, chat platforms, or external services.

Built with Rust (Axum).

How It Works

OpenPR ──webhook POST──▶ openpr-webhook ──dispatch──▶ OpenClaw (Signal/Telegram)
                                         ──dispatch──▶ HTTP endpoint
                                         ──dispatch──▶ Custom command

1. OpenPR fires a webhook on events (issue created, proposal submitted, comment added, etc.)
2. openpr-webhook verifies the HMAC-SHA256 signature
3. Dispatches formatted notifications to configured agents

Features

• HMAC-SHA256 signature verification — Validates webhook authenticity
• Multi-agent dispatch — Route events to multiple agents simultaneously
• Agent types:
  • openclaw — Send via OpenClaw CLI (openclaw message send)
  • webhook — Forward to HTTP endpoints
  • custom — Execute arbitrary commands
• Message templates — Customizable notification format with placeholders
• Configurable — TOML-based configuration

Quick Start

# Build
cargo build --release

# Configure
cp config.example.toml config.toml
# Edit config.toml with your settings

# Run
./target/release/openpr-webhook
# Listening on 0.0.0.0:9090

Configure OpenPR Webhook

In OpenPR, create a webhook pointing to this receiver:

• URL: http://your-server:9090/webhook
• Secret: Must match webhook_secrets in config.toml
• Events: Select which events to receive

Configuration

[server]
listen = "0.0.0.0:9090"

[security]
webhook_secrets = ["your-secret-here"]
allow_unsigned = false  # Set true only for development

# Agent: OpenClaw (AI assistant via Signal/Telegram)
[[agents]]
id = "david"
name = "David"
agent_type = "openclaw"
message_template = "🔔 [{project}] {event}: {key} {title}\n👤 {actor} | Trigger: {reason}"

[agents.openclaw]
command = "openclaw message send"
channel = "signal"
target = "uuid:your-user-uuid"

# Agent: Forward to HTTP endpoint
[[agents]]
id = "slack-bot"
name = "Slack"
agent_type = "webhook"
message_template = "{event}: {title}"

[agents.webhook]
url = "https://hooks.slack.com/services/xxx"
method = "POST"

# Agent: Custom command
[[agents]]
id = "logger"
name = "Logger"
agent_type = "custom"
message_template = "{event} {key}"

[agents.custom]
command = "echo"
args = ["{message}"]

Template Placeholders

Placeholder	Description
{project}	Project name
{event}	Event type (e.g. issue.created)
{key}	Item identifier
{title}	Item title
{actor}	User who triggered the event
{reason}	Trigger reason

API

Endpoint	Method	Description
/webhook	POST	Receive webhook events
/health	GET	Health check

Webhook Headers

Header	Description
X-OpenPR-Signature	HMAC-SHA256 signature (sha256=...)
X-OpenPR-Event	Event type

Deployment

Systemd

[Unit]
Description=OpenPR Webhook Receiver
After=network.target

[Service]
ExecStart=/usr/local/bin/openpr-webhook
WorkingDirectory=/etc/openpr-webhook
Restart=always

[Install]
WantedBy=multi-user.target

Docker

FROM rust:1.75 AS builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM debian:bookworm-slim
COPY --from=builder /app/target/release/openpr-webhook /usr/local/bin/
COPY config.toml /etc/openpr-webhook/
CMD ["openpr-webhook"]

Related

• OpenPR — Project management platform
• PRX — AI assistant framework

License

Apache-2.0