apero-kit-cli 2.2.5 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apero-kit-cli",
-  "version": "2.2.5",
+  "version": "2.4.0",
   "description": "CLI tool to scaffold AI agent projects with pre-configured kits (Claude, OpenCode, Codex)",
   "type": "module",
   "bin": {
@@ -35,6 +35,9 @@
     "agent",
     "claude",
     "claude-code",
+    "gemini",
+    "discord",
+    "clawbot",
     "opencode",
     "codex",
     "cli",

package/templates/discord/README.md

@@ -0,0 +1,227 @@
+# Discord + OpenClaw Setup Guide
+
+This directory contains configuration for running your AI agent on Discord via [OpenClaw](https://docs.openclaw.ai).
+
+## Features
+
+- **Auto Intent Detection** - No need to type `/plan` or `/brainstorm`, bot understands natural language
+- **Skills System** - Commands converted to skills format for better context
+- **Train Prompt** - Add new knowledge via URLs, files, or inline content
+- **Progressive Disclosure** - Skills load on-demand to save tokens
+
+## Quick Start
+
+### 1. Install OpenClaw CLI
+
+```bash
+npm install -g openclaw
+# or
+npx openclaw
+```
+
+### 2. Create Discord Bot
+
+1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
+2. Click "New Application" and name your bot
+3. Go to "Bot" section and click "Add Bot"
+4. Enable these Intents:
+   - **Message Content Intent** (required)
+   - **Server Members Intent** (recommended)
+5. Click "Reset Token" to get your bot token
+
+### 3. Configure Bot Token
+
+**Option A: Environment Variable (Recommended)**
+```bash
+export DISCORD_BOT_TOKEN="your-bot-token-here"
+```
+
+**Option B: Direct Configuration**
+```bash
+openclaw config set channels.discord.token '"your-bot-token-here"' --json
+```
+
+### 4. Enable Discord Channel
+
+```bash
+openclaw config set channels.discord.enabled true --json
+```
+
+### 5. Start Gateway
+
+```bash
+openclaw gateway
+```
+
+### 6. Invite Bot to Server
+
+1. Go to OAuth2 > URL Generator in Discord Developer Portal
+2. Select scopes: `bot`, `applications.commands`
+3. Select permissions:
+   - View Channels
+   - Send Messages
+   - Read Message History
+   - Embed Links
+   - Attach Files
+   - Add Reactions
+4. Copy the generated URL and open it to invite the bot
+
+### 7. Pairing (First-time Setup)
+
+1. Send a DM to your bot in Discord
+2. Bot responds with a pairing code
+3. Approve the pairing:
+   ```bash
+   openclaw pairing approve discord <CODE>
+   ```
+
+## Using Commands
+
+Your commands are available in two ways:
+
+### As Slash Commands
+Discord will automatically register your commands as slash commands.
+Type `/` in Discord to see available commands.
+
+Example:
+- `/plan create a login feature`
+- `/brainstorm how to optimize database queries`
+
+### As Message Commands
+Mention the bot with a command:
+```
+@YourBot /plan create a login feature
+```
+
+## Configuration
+
+Edit `config.json5` to customize:
+
+- **dmPolicy**: Control who can DM the bot
+- **groupPolicy**: Control which servers can use the bot
+- **guilds**: Configure per-server settings
+- **streaming**: Enable live typing preview
+- **bindings**: Route different users to different agents
+
+## Commands Available
+
+Your commands are defined in the `commands/` directory:
+
+| Command | Description |
+|---------|-------------|
+| `/plan` | Create implementation plans |
+| `/brainstorm` | Brainstorm solutions |
+| `/fix` | Fix code issues |
+| `/code` | Write code |
+| `/review` | Review code changes |
+| ... | See `commands/` for full list |
+
+## Useful OpenClaw Commands
+
+```bash
+# Check status
+openclaw channels status --probe
+
+# View logs
+openclaw logs --follow
+
+# List pairings
+openclaw pairing list discord
+
+# Restart gateway
+openclaw gateway restart
+
+# Health check
+openclaw doctor
+```
+
+## Skills System
+
+Your commands are converted to **OpenClaw Skills** format for better AI understanding.
+
+### Structure
+```
+.discord/
+├── skills/
+│   ├── auto-intent-router/    # Auto-detects user intent
+│   │   └── SKILL.md
+│   ├── train-prompt/          # Add new knowledge
+│   │   └── SKILL.md
+│   ├── planning/              # Converted from /plan
+│   │   └── SKILL.md
+│   ├── brainstorm/            # Converted from /brainstorm
+│   │   └── SKILL.md
+│   └── ...
+├── commands/                  # Original commands (backup)
+├── commands.json5             # Slash commands config
+└── config.json5               # Main config
+```
+
+### How It Works
+
+1. **Auto Intent Router** detects what user wants from natural language
+2. **Appropriate skill** is activated automatically
+3. User gets response without typing commands
+
+Example:
+```
+User: "I need to add payment processing"
+Bot: [Detects PLANNING intent, activates planning skill]
+     "I'll help you plan the payment processing feature..."
+```
+
+## Training New Knowledge
+
+Use the **train-prompt** skill to teach the bot new things:
+
+### Train from URL
+```
+/train https://docs.stripe.com/api
+```
+
+### Train from File
+```
+/train:file ./docs/coding-standards.md
+```
+
+### Train Inline
+```
+/train:inline
+Our deployment process:
+1. Run tests
+2. Build
+3. Deploy staging
+4. Deploy production
+```
+
+### List Trained Knowledge
+```
+/train:list
+```
+
+## Troubleshooting
+
+**Bot not responding?**
+- Check Message Content Intent is enabled
+- Verify bot token is correct
+- Run `openclaw doctor` for diagnostics
+
+**Commands not showing?**
+- Wait a few minutes for Discord to sync
+- Check `commands.native` is set to `"auto"`
+
+**Permission errors?**
+- Verify bot has required permissions
+- Check guild configuration in `config.json5`
+
+**Skills not loading?**
+- Check `skills/` directory exists
+- Verify SKILL.md files have correct frontmatter
+- Run `openclaw skills list` to see active skills
+
+## Resources
+
+- [OpenClaw Documentation](https://docs.openclaw.ai)
+- [Discord Channel Guide](https://docs.openclaw.ai/channels/discord)
+- [Skills Guide](https://docs.openclaw.ai/tools/skills)
+- [Slash Commands](https://docs.openclaw.ai/tools/slash-commands)

package/templates/discord/config.json5

@@ -0,0 +1,87 @@
+// Clawbot Discord Configuration
+// Generated by Apero Kit CLI
+// Documentation: https://docs.openclaw.ai/channels/discord
+{
+  // Discord Channel Settings
+  "channels": {
+    "discord": {
+      // Bot token - set via environment variable or here
+      // Recommended: Use DISCORD_BOT_TOKEN environment variable
+      "token": "${DISCORD_BOT_TOKEN}",
+
+      // Enable Discord channel
+      "enabled": true,
+
+      // Direct Message Policy
+      // "pairing" - Require pairing approval (recommended)
+      // "allowlist" - Only allow specific users
+      // "open" - Allow all DMs
+      // "disabled" - Disable DMs
+      "dmPolicy": "pairing",
+
+      // Guild (Server) Policy
+      // "open" - Allow all guilds
+      // "allowlist" - Only allow specific guilds
+      // "disabled" - Disable guild messages
+      "groupPolicy": "allowlist",
+
+      // Message History Limit (for context)
+      "historyLimit": 20,
+      "dmHistoryLimit": 50,
+
+      // Reply Mode
+      // "off" - No reply threading
+      // "first" - Reply to first message only
+      // "all" - Reply to all messages
+      "replyToMode": "first",
+
+      // Streaming Mode (live typing preview)
+      // "off" - No streaming
+      // "partial" - Partial updates
+      // "block" - Block updates
+      // "progress" - Progress indicator
+      "streaming": "partial",
+
+      // Guild Configurations
+      // Add your server(s) here
+      "guilds": {
+        // Example guild configuration
+        // Replace YOUR_SERVER_ID with actual Discord server ID
+        // "YOUR_SERVER_ID": {
+        //   "requireMention": true,
+        //   "users": ["YOUR_USER_ID"],
+        //   "roles": ["ALLOWED_ROLE_ID"],
+        //   "channels": {
+        //     "general": { "allow": true },
+        //     "bot-commands": { "allow": true }
+        //   }
+        // }
+      },
+
+      // Bot Presence
+      "status": "online",
+      "activity": "Ready to assist",
+      "activityType": 4  // 0=Playing, 1=Streaming, 2=Listening, 3=Watching, 4=Custom
+    }
+  },
+
+  // Commands Configuration
+  "commands": {
+    // Enable native Discord slash commands
+    "native": "auto"
+  },
+
+  // Agent Bindings (optional)
+  // Route different users/roles to different agents
+  "bindings": [
+    // Example: Route users with specific role to opus agent
+    // {
+    //   "agentId": "opus",
+    //   "match": {
+    //     "channel": "discord",
+    //     "guildId": "YOUR_SERVER_ID",
+    //     "roles": ["PREMIUM_ROLE_ID"]
+    //   }
+    // }
+  ]
+}

package/templates/discord/skills/auto-intent-router/SKILL.md

@@ -0,0 +1,195 @@
+---
+name: auto-intent-router
+description: Automatically detects user intent and routes to appropriate skill without manual commands
+user-invocable: false
+disable-model-invocation: false
+metadata: {"openclaw": {"always": true, "priority": 1}}
+---
+
+# Auto Intent Router
+
+## Purpose
+
+This skill runs on EVERY message to detect user intent and automatically activate the appropriate skill. Users don't need to type commands like `/plan` or `/brainstorm` - the bot understands natural language.
+
+## Priority
+
+This skill has highest priority (runs first) to route messages before other processing.
+
+## Intent Detection Matrix
+
+| Intent | Keywords/Patterns | Activated Skill |
+|--------|-------------------|-----------------|
+| **PLANNING** | plan, design, architect, implement, create, build feature | `planning`, `plan-fast`, `plan-hard` |
+| **BRAINSTORMING** | brainstorm, ideas, options, alternatives, think about, explore | `brainstorm` |
+| **DEBUGGING** | fix, debug, error, broken, bug, issue, not working, crash | `debugging`, `fix-fast`, `fix-hard` |
+| **CODE REVIEW** | review, check my code, look at this, audit, examine | `code-review` |
+| **CODING** | code, implement, write, develop, create function | `code`, `cook` |
+| **TESTING** | test, unit test, spec, coverage, jest, vitest | `testing` |
+| **DATABASE** | database, schema, migration, query, sql, table | `database` |
+| **API DESIGN** | api, endpoint, rest, graphql, route | `api-design` |
+| **DOCUMENTATION** | document, docs, readme, explain, describe | `documentation` |
+| **DEPLOYMENT** | deploy, release, staging, production, ci/cd | `deployment` |
+| **TRAINING** | train, learn, teach, add knowledge, remember | `train-prompt` |
+| **SCOUTING** | find, search, where is, locate, explore codebase | `scout` |
+
+## Detection Algorithm
+
+```
+1. EXTRACT keywords from user message
+2. MATCH against intent patterns
+3. CALCULATE confidence score for each intent
+4. IF confidence > 0.7:
+     ACTIVATE corresponding skill
+   ELSE IF multiple intents detected:
+     ASK user for clarification
+   ELSE:
+     PROCEED with general response
+```
+
+## Confidence Scoring
+
+```
+score = (keyword_matches * 0.4) + (pattern_matches * 0.3) + (context_relevance * 0.3)
+
+- keyword_matches: Number of intent keywords found
+- pattern_matches: Regex patterns matched
+- context_relevance: Based on conversation history
+```
+
+## Workflow
+
+### Step 1: Parse Message
+
+Extract:
+- Primary keywords
+- Question type (how, what, why, can you)
+- Code references (file paths, function names)
+- URLs or links
+
+### Step 2: Intent Classification
+
+For each potential intent:
+1. Count keyword matches
+2. Check pattern matches
+3. Consider conversation context
+4. Calculate confidence score
+
+### Step 3: Route or Clarify
+
+**High Confidence (>0.7):**
+```
+Silently activate the matched skill.
+User sees natural response, not "Activating planning skill..."
+```
+
+**Medium Confidence (0.4-0.7):**
+```
+"I think you want to [intent]. Should I:
+A) Create a plan for this
+B) Brainstorm alternatives first
+C) Just help directly"
+```
+
+**Low Confidence (<0.4):**
+```
+Respond naturally without special skill activation.
+```
+
+## Examples
+
+### Example 1: Planning Intent
+```
+User: "I need to add user authentication to the app"
+
+[Intent Detection]
+Keywords: "add", "authentication", "app"
+Pattern: "I need to" + feature description
+Confidence: PLANNING = 0.85
+
+[Action]
+Activate: planning skill
+Response: "I'll help you plan the authentication system..."
+```
+
+### Example 2: Debugging Intent
+```
+User: "The login button isn't working anymore"
+
+[Intent Detection]
+Keywords: "isn't working"
+Pattern: [component] + "not working"
+Confidence: DEBUGGING = 0.9
+
+[Action]
+Activate: debugging skill
+Response: "Let me investigate the login button issue..."
+```
+
+### Example 3: Ambiguous Intent
+```
+User: "Can you help with the API?"
+
+[Intent Detection]
+Keywords: "API"
+Confidence: API_DESIGN = 0.5, DEBUGGING = 0.4
+
+[Action]
+Clarify: "I can help with the API. Do you want to:
+A) Design new endpoints
+B) Fix an existing issue
+C) Review the current implementation"
+```
+
+### Example 4: Training Intent
+```
+User: "Learn this documentation: https://docs.stripe.com/api"
+
+[Intent Detection]
+Keywords: "learn", URL present
+Confidence: TRAINING = 0.95
+
+[Action]
+Activate: train-prompt skill
+Response: "I'll learn from the Stripe API documentation..."
+```
+
+## Context Awareness
+
+The router considers conversation history:
+
+- If previous message was about planning → lower threshold for planning-related follow-ups
+- If user just shared code → debugging/review more likely
+- If discussing architecture → planning/design more likely
+
+## Override Behavior
+
+Users can still use explicit commands to override:
+- `/plan` - Force planning mode
+- `/brainstorm` - Force brainstorming mode
+- `/fix` - Force debugging mode
+
+Explicit commands bypass intent detection.
+
+## Configuration
+
+Skills can declare their trigger conditions in their SKILL.md frontmatter:
+
+```yaml
+metadata: {
+  "openclaw": {
+    "triggers": {
+      "keywords": ["plan", "design", "architect"],
+      "patterns": ["how should I", "best way to"],
+      "confidence_boost": 0.1
+    }
+  }
+}
+```
+
+## Performance Notes
+
+- Intent detection runs in <50ms
+- Only loads full skill content after routing
+- Caches recent intent classifications
+- Batches multiple skill reads when needed