# openclaw-openeuler-quickissue

**Repository Path**: ai_application/openclaw-openeuler-quickissue

## Basic Information

- **Project Name**: openclaw-openeuler-quickissue
- **Description**: OpenClaw extension plugin for openEuler QuickIssue
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @openeuler-openclaw/quickissue

OpenClaw extension plugin for [quickissue.openeuler.org](https://quickissue.openeuler.org) — query issues, pull requests, repos and SIGs across the openEuler community.

## Features

- **Read-only**: All operations are read-only, no API key required
- **Zero runtime dependencies**: Uses native `fetch`, no external packages
- **Full QuickIssue API coverage**: Issues, Pull Requests, Repos, SIGs, and all related filters
- **14 tools** for the AI agent to query the openEuler community data

## Installation

### Method 1: Local Installation (Recommended for Development)

1. **Copy the plugin to OpenClaw extensions directory:**

```bash
cp -r openclaw-openeuler-quickissue ~/.openclaw/extensions/
```

2. **Install dependencies** (optional, for development only):

```bash
cd ~/.openclaw/extensions/openclaw-openeuler-quickissue
npm install
```

3. **Enable the plugin:**

```bash
openclaw config set channels.quickissue.enabled true
```

### Method 2: Install from npm (When Published)

```bash
openclaw plugins install @openeuler-openclaw/quickissue
```

## Configuration

Add to your `openclaw.json`:

```json
{
  "channels": {
    "quickissue": {
      "enabled": true,
      "baseUrl": "https://quickissue.openeuler.org"
    }
  }
}
```

Or use CLI commands:

```bash
openclaw config set channels.quickissue.enabled true
openclaw config set channels.quickissue.baseUrl "https://quickissue.openeuler.org"
```

> `baseUrl` defaults to `https://quickissue.openeuler.org` and can be omitted.

## Verification

```bash
# Check plugin status
openclaw status

# Test directly
openclaw
```

Then try:

```
查询 openEuler 社区最新的 issue
```

## Available Tools

### Issue Tools

| Tool | Description |
|------|-------------|
| `quickissue_list_issues` | List issues with rich filters (org, repo, SIG, state, author, assignee, branch, label, type, priority, keyword) |
| `quickissue_issue_assignees` | List all issue assignees |
| `quickissue_issue_authors` | List all issue authors |
| `quickissue_issue_branches` | List all issue-related branches |
| `quickissue_issue_labels` | List all issue labels |
| `quickissue_issue_types` | List all issue types |

### Pull Request Tools

| Tool | Description |
|------|-------------|
| `quickissue_list_pulls` | List PRs with rich filters (org, repo, SIG, state, ref, author, assignee, label, keyword) |
| `quickissue_pull_assignees` | List all PR assignees |
| `quickissue_pull_authors` | List all PR authors |
| `quickissue_pull_refs` | List all PR target branches |
| `quickissue_pull_labels` | List all PR labels |
| `quickissue_pull_repos` | List all repos that have PRs |

### Repository & SIG Tools

| Tool | Description |
|------|-------------|
| `quickissue_list_repos` | List repositories under openeuler/src-openeuler |
| `quickissue_list_sigs` | List all SIGs (Special Interest Groups) |

## Usage Examples

### Query Issues

```
Show me the open issues in the kernel SIG
```

```
Find issues assigned to georgecao
```

```
Search for issues related to "container"
```

### Query Pull Requests

```
List open pull requests targeting the openEuler-24.03-LTS branch
```

```
Show me the latest PRs in the Infrastructure SIG
```

### Query Repos & SIGs

```
What repos belong to the Infrastructure SIG?
```

```
List all SIGs in the openEuler community
```

## Uninstallation

```bash
# Remove the plugin
rm -rf ~/.openclaw/extensions/openclaw-openeuler-quickissue

# Or disable without removing
openclaw config set channels.quickissue.enabled false
```

## Development

```bash
# Clone the repository
git clone https://gitee.com/ai_application/openclaw-openeuler-quickissue.git
cd openclaw-openeuler-quickissue

# Install dependencies (TypeScript only)
npm install

# Run tests against the live API
npx tsx test.ts
```

### Dependencies

- **Runtime**: No runtime dependencies
- **Development**: Only TypeScript (~23M)
- **Peer**: `openclaw` (provided by host)

## Architecture

```
openclaw-openeuler-quickissue/
├── index.ts                    # Plugin entry point
├── openclaw.plugin.json        # Plugin manifest
├── package.json                # Package config (minimal deps)
├── .npmignore                  # Publish ignore rules
├── README.md                   # Documentation
├── test.ts                     # Test script
└── src/
    ├── channel.ts              # Channel plugin definition
    ├── tools.ts                # 14 tool registrations
    ├── client.ts               # QuickIssue REST API client
    ├── accounts.ts             # Account resolution
    ├── types.ts                # TypeScript types
    ├── config-schema.ts        # Zod schemas
    └── probe.ts                # Connection probe
```

## License

MulanPSL-2.0