Plugins & Integrations

Plugins

Plugins extend GitClaw with tools, skills, hooks, memory layers, and prompt additions.

Plugin Manifest

plugins/my-plugin/plugin.yaml:

id: my-plugin
name: My Plugin
version: 1.0.0
description: What this plugin does
author: Your Name
license: MIT
engine: ">=1.0.0"

provides:
  tools: true
  skills: true
  prompt: prompt.md
  hooks:
    pre_tool_use:
      - script: hooks/validate.sh

memory:
  - name: plugin-data
    path: memory/plugin-data.md
    max_lines: 500

Plugin Structure

plugins/my-plugin/
  plugin.yaml          # manifest
  prompt.md            # appended to system prompt
  tools/
    my-tool.yaml       # declarative tools
  skills/
    my-skill/
      SKILL.md
  hooks/
    validate.sh

Plugin Management

gitclaw plugin install https://github.com/user/plugin
gitclaw plugin list
gitclaw plugin remove my-plugin
gitclaw plugin init my-plugin  # scaffold a new plugin

Integrations

Composio (Gmail, Calendar, Slack, GitHub)

Requires: COMPOSIO_API_KEY

Enables 200+ integrations via Composio's toolkit system. Configure in the Integrations tab.

Requires: TELEGRAM_BOT_TOKEN

Create a bot via @BotFather
Enter token in the Communication tab or during setup
Configure allowed users for access control
Files generated by the agent are auto-sent to Telegram

Uses the Baileys library (no phone number API needed):

Connect via QR code in the Communication tab
Session persists across restarts
Auto-responds to messages from your number

Phone / SMS (Twilio)

Configure a Twilio webhook pointing to:

https://your-server:3333/api/phone/webhook