Skip to main content

​
Overview

Connect profClaw to GitHub to automatically triage issues, review pull requests, sync tasks, and run agentic workflows triggered by repository events.

​
Prerequisites

  • profClaw running in mini or pro mode
  • A GitHub account with repo access
  • GitHub App or Personal Access Token

​
Step 1: Create a GitHub App

1

Create the App

Go to Settings > Developer Settings > GitHub Apps > New GitHub App.Set the following:
  • Name: profClaw Bot
  • Homepage URL: Your profClaw instance URL
  • Webhook URL: https://your-profclaw.com/api/integrations/github/webhook
2

Set Permissions

PermissionAccessPurpose
IssuesRead & WriteCreate/update issues
Pull RequestsRead & WriteReview PRs, post comments
ContentsReadRead repository files
MetadataReadRepository info
WebhooksRead & WriteReceive events
3

Subscribe to Events

  • issues - Issue opened, edited, closed
  • pull_request - PR opened, updated, merged
  • issue_comment - Comments on issues/PRs
  • push - Code pushed to branches
4

Generate Private Key

After creating the app, generate a private key and save the .pem file.

​
Step 2: Configure profClaw

export GITHUB_APP_ID=123456
export GITHUB_PRIVATE_KEY="$(cat path/to/private-key.pem)"
export GITHUB_WEBHOOK_SECRET=your-webhook-secret
Or use OAuth for personal use: 
profclaw auth github

​
Step 3: Enable GitHub Integration

integrations:
  github:
    enabled: true
    features:
      issueSync: true
      prReview: true
      codeSearch: true
      ticketSync: true

​
Automated PR Reviews

profClaw can automatically review pull requests when they’re opened: 
integrations:
  github:
    prReview:
      enabled: true
      autoReview: true
      reviewPrompt: |
        Review this PR for:
        - Code quality and best practices
        - Security vulnerabilities
        - Test coverage
        - Documentation
      labels:
        approved: "profclaw-approved"
        needsWork: "needs-changes"

​
Issue Triage

Automatically label and assign incoming issues: 
integrations:
  github:
    issueTriage:
      enabled: true
      autoLabel: true
      autoAssign: true
      rules:
        - match: "bug"
          labels: ["bug", "triage"]
        - match: "feature request"
          labels: ["enhancement"]
        - match: "security"
          labels: ["security", "priority-high"]

​
Cron-Based Workflows

Run periodic GitHub workflows: 
cron:
  jobs:
    - name: stale-issues
      schedule: "0 9 * * 1"  # Monday at 9 AM
      task: |
        Find issues with no activity for 30 days
        and add a "stale" label

    - name: weekly-summary
      schedule: "0 17 * * 5"  # Friday at 5 PM
      task: |
        Generate a summary of this week's PRs,
        issues opened/closed, and contributors

​
CLI Usage

# Sync GitHub issues to profClaw tasks
profclaw github sync

# Review a specific PR
profclaw github review 42

# Search code across repos
profclaw github search "TODO security"