Tools

Larkflow Openclaw

Name: Larkflow Openclaw
Rating: 3.5 (1 reviews)
Author: sunecom

By sunecom 👁 45 views ▲ 0 votes

🤖 LarkFlow - Feishu approval workflow automation plugin for OpenClaw. Rule engine + AI sub-agent for auto-approve/reject/notify. 基于 OpenClaw 的飞书审批流自动化插件。

Homepage GitHub

Install

npm install

#

README

# LarkFlow 🤖

> **Feishu Approval Workflow Automation — powered by OpenClaw**  
> 基于 OpenClaw 的飞书审批流自动化插件

---

## What is LarkFlow?

LarkFlow is an **OpenClaw plugin** that automates Feishu (飞书) approval workflows. It listens for approval events, matches them against configurable rules, optionally uses AI to analyze complex cases, and takes automatic actions — all through OpenClaw's plugin and hook system.

### Use Cases

- **💰 Expense Reports** — Auto-approve ≤¥5000, AI-review ¥5000-20000, escalate >¥20000
- **🏖️ Leave Requests** — Auto-approve ≤3 days, forward >3 days to manager
- **📋 Purchase Orders** — Match budget codes, auto-reject overspend
- **🚀 DevOps Approvals** — Auto-approve staging deploys, escalate production

---

## Features

| Feature | Description |
|---------|-------------|
| **Rule Engine** | Define rules with priority, keyword match, amount ranges, applicant filters |
| **AI Decider** | Sub-agents analyze complex approvals using local/cloud models |
| **Feishu Integration** | Native webhook handling + notification via Feishu channel |
| **OpenClaw Hooks** | `message:received` hook for real-time approval detection |
| **Plugin Config** | JSON5 schema with full OpenClaw config validation |

---

## Quick Start

### 1. Install Plugin

```bash
# From local path
openclaw plugins install -l ./larkflow

# Or via npm (once published)
openclaw plugins install larkflow
```

### 2. Configure

Add to `~/.openclaw/openclaw.json`:

```json5
{
  plugins: {
    slots: {
      // No slot needed — LarkFlow registers hooks automatically
    },
    entries: {
      larkflow: {
        enabled: true,
        config: {
          feishuChatId: "oc_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
          notifyOnAction: true,
          rules: [
            {
              name: "小额报销自动通过",
              priority: 1,
              match: {
                approvalType: "expense_report",
                titleContains: ["报销", "expense"],
                amountMax: 5000,
              },
              action: "auto_approve",
              reason: "小额报销规则：金额 ≤ ¥5000 自动通过",
            },
            {
              name: "大额采购需AI审核",
              priority: 2,
              match: {
                approvalType: "purchase_order",
                amountMin: 20000,
              },
              action: "ai_decide",
            },
            {
              name: "超长请假转人工",
              priority: 3,
              match: {
                approvalType: "leave",
                titleContains: ["请假", "leave", "休假", "vacation"],
                amountMin: 7,  // days
              },
              action: "forward",
              forwardTo: "ou_xxxxxxxxxx",
            },
          ],
        },
      },
    },
  },
}
```

### 3. Restart Gateway

```bash
openclaw gateway restart
```

### 4. Verify

```bash
openclaw plugins list | grep larkflow
```

---

## Architecture

```
┌─────────────┐     ┌──────────────────┐     ┌────────────────┐
│  Feishu     │────▶│  LarkFlow        │────▶│  OpenClaw      │
│  Approval   │     │  Webhook Handler │     │  Agent Loop    │
│  Webhook    │     └────────┬─────────┘     └────────────────┘
└─────────────┘              │
                             ▼
                    ┌──────────────────┐
                    │  Rule Engine     │
                    │  (first match)   │
                    └────────┬─────────┘
                             │
              ┌──────────────┼──────────────┐
              ▼              ▼              ▼
     ┌────────────┐ ┌──────────────┐ ┌────────────┐
     │ Auto Action │ │  AI Decider  │ │ Forward    │
     │ (approve/   │ │  (sub-agent) │ │ (to human) │
     │  reject)    │ │              │ │            │
     └────────────┘ └──────────────┘ └────────────┘
              │              │              │
              └──────────────┴──────────────┘
                             │
                             ▼
                    ┌──────────────────┐
                    │  Feishu Channel  │
                    │  (notification)  │
                    └──────────────────┘
```

---

## Development

```bash
# Clone & setup
git clone https://github.com/sunecom/larkflow.git
cd larkflow
npm install

# Build
npm run build

# Test
npm test

# Run with dev Gateway
openclaw gateway --plugins ./dist
```

---

## Configuration Reference

### `openclaw.json` Plugin Config

| Field | Type | Required | Default | Description |
|-------|------|----------|---------|-------------|
| `feishuChatId` | string | ✅ | — | Feishu chat ID for notifications |
| `approvalWebhook` | string | ❌ | — | Feishu approval webhook URL |
| `rules[]` | array | ❌ | [] | Approval rule list |
| `aiDecidePrompt` | string | ❌ | (default) | Custom prompt for AI decision |
| `notifyOnAction` | boolean | ❌ | true | Send notification on auto-action |

### Rule Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | ✅ | Rule display name |
| `priority` | number | ❌ | Lower = higher priority (default 999) |
| `match.approvalType` | string | ❌ | Feishu approval code |
| `match.titleContains` | string[] | ❌ | Keyword match (any) |
| `match.amountMax` | number | ❌ | Amount ≤ this value |
| `match.amountMin` | number | ❌ | Amount ≥ this value |
| `match.applicantIds` | string[] | ❌ | Specific applicant IDs |
| `action` | enum | ✅ | auto_approve / auto_reject / ai_decide / notify_only / forward |
| `forwardTo` | string | ❌ | User open_id for forward action |
| `reason` | string | ❌ | Reason logged with action |

---

> 🚀 Powered by [AiToMoney Team](https://github.com/sunecom) | Check out our **GEO ToolKit** → [geo.aitomoney.online](https://geo.aitomoney.online)

---

## License

MIT — Free as a lobster in the ocean. 🦞

tools