Files

admin 5455eaa125 v1.3.0: Full Rig integration - Multi-agent AI framework

2026-02-26 11:56:08 +04:00

13 KiB

Raw Blame History

QwenClaw 🐾

A persistent personal assistant daemon for Qwen Code that never sleeps.

QwenClaw runs as a background daemon, executing scheduled tasks, responding to Telegram messages, and providing a web dashboard for monitoring and management. It automatically starts with your system and persists across all restarts.

Features

Feature	Description
💓 Heartbeat	Periodic check-ins on configurable intervals with quiet hours support
⏰ Cron Jobs	Schedule any prompt using standard cron syntax (timezone-aware)
📱 Telegram Bot	Chat with your agent via text, images, and voice commands
🌐 Web Dashboard	Monitor runs, edit jobs, and view logs in real-time
🔒 Security Levels	Four granular levels from read-only to full system access
🔄 Auto-Start	Automatically starts when you log in (Windows/Linux/macOS)
💾 Persistent State	All settings, jobs, and sessions saved to disk

Quick Install

One-Command Install

Windows (PowerShell):

git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth
.\install.ps1

Linux/macOS (Bash):

git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth
chmod +x install.sh
./install.sh

This will:

Install dependencies (Bun if missing)
Create all necessary directories
Set up auto-start for your system
Create default configuration
Add example scheduled job

Manual Installation

Prerequisites

Qwen Code installed and configured
Bun package manager
Git

Steps

# Clone the repository
git clone https://github.rommark.dev/admin/QwenClaw-with-Auth.git
cd QwenClaw-with-Auth

# Install dependencies
bun install

# Start the daemon
bun run start --web

Auto-Start Configuration

QwenClaw is configured to start automatically when you log in.

Windows

Uses Startup Folder (shell:startup)
No admin privileges required
To disable: Run .\scripts\uninstall-startup.ps1

Linux

Systemd service (if available, requires sudo)
Desktop autostart (for GUI sessions)
To disable: systemctl disable qwenclaw.service or remove ~/.config/autostart/qwenclaw.desktop

macOS

Uses LaunchAgent
To disable: launchctl unload ~/Library/LaunchAgents/com.qwenclaw.daemon.plist

Usage

Start the Daemon

# Start with web UI
bun run start --web

# Start with custom port
bun run start --web --web-port 8080

# Start with trigger prompt
bun run start --trigger --prompt "Check my pending tasks"

# One-shot prompt (no daemon)
bun run start --prompt "What's the weather?"

Check Status

bun run status

Stop the Daemon

bun run stop

Send a Prompt

# Send to running daemon
bun run send "Check my calendar"

# Send and forward to Telegram
bun run send --telegram "Summarize my tasks"

Clear State

bun run clear

Configuration

Settings File

Location: ~/.qwen/qwenclaw/settings.json

{
  "model": "qwen-plus",
  "api": "",
  "autoStart": true,
  "fallback": {
    "model": "",
    "api": ""
  },
  "timezone": "UTC",
  "timezoneOffsetMinutes": 0,
  "heartbeat": {
    "enabled": true,
    "interval": 15,
    "prompt": "",
    "excludeWindows": [
      {
        "start": "22:00",
        "end": "08:00",
        "days": [0, 1, 2, 3, 4, 5, 6]
      }
    ]
  },
  "telegram": {
    "token": "",
    "allowedUserIds": []
  },
  "security": {
    "level": "moderate",
    "allowedTools": [],
    "disallowedTools": []
  },
  "web": {
    "enabled": true,
    "host": "127.0.0.1",
    "port": 4632
  }
}

Security Levels

Level	Description
`locked`	Read-only access (Read, Grep, Glob tools only)
`strict`	No Bash, WebSearch, or WebFetch
`moderate`	All tools available, scoped to project directory
`unrestricted`	All tools, no directory restrictions

Scheduled Jobs

Create jobs in ~/.qwen/qwenclaw/jobs/ as markdown files with frontmatter.

Example: Daily Standup

File: ~/.qwen/qwenclaw/jobs/daily-standup.md

---
schedule: 0 9 * * *
recurring: true
notify: true
---

Good morning! Here's your daily check-in:
1. What are today's priorities?
2. Any pending tasks from yesterday?
3. Summarize my calendar for today.

Cron Syntax

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6)
│ │ │ │ │
* * * * *

Examples

Expression	Description
`/5 * * *`	Every 5 minutes
`0 /2 * *`	Every 2 hours
`0 9 * * 1-5`	9 AM on weekdays
`0 0 1 * *`	First day of every month
`0 0 * * 0`	Every Sunday at midnight

Telegram Integration

Setup

Create a bot via @BotFather on Telegram
Get your bot token
Find your Telegram user ID (use @userinfobot)
Add to settings:

{
  "telegram": {
    "token": "YOUR_BOT_TOKEN",
    "allowedUserIds": [YOUR_USER_ID]
  }
}

Bot Commands

/start - Get started with the bot
/reset - Reset the conversation session

Features

Text messages
Image attachments (bot downloads and sends to Qwen)
Voice messages (transcription requires whisper setup)
Group chat support (mention bot or reply to its messages)
Reactions support using [react:emoji] syntax in responses

Web Dashboard

Access at: http://127.0.0.1:4632 (or your configured port)

Features

Real-time daemon status
Heartbeat configuration
Job management (view, add, delete)
Logs viewer
Technical information

Project Structure

QwenClaw-with-Auth/
├── src/
│   ├── commands/         # CLI commands
│   │   ├── start.ts      # Daemon start
│   │   ├── stop.ts       # Daemon stop
│   │   ├── status.ts     # Status check
│   │   ├── send.ts       # Send prompt
│   │   ├── clear.ts      # Clear state
│   │   └── telegram.ts   # Telegram bot
│   ├── ui/               # Web dashboard
│   │   ├── page/         # HTML/CSS/JS
│   │   └── services/     # API handlers
│   ├── config.ts         # Configuration management
│   ├── cron.ts           # Cron parsing
│   ├── jobs.ts           # Job scheduling
│   ├── runner.ts         # Qwen execution
│   ├── sessions.ts       # Session management
│   ├── timezone.ts       # Timezone utilities
│   ├── pid.ts            # PID file management
│   ├── statusline.ts     # Status line widget
│   ├── preflight.ts      # Plugin setup
│   └── index.ts          # Main entry point
├── prompts/              # Prompt templates
│   ├── IDENTITY.md
│   ├── USER.md
│   ├── SOUL.md
│   └── heartbeat/
│       └── HEARTBEAT.md
├── scripts/              # Installation scripts
│   ├── install.sh        # Linux/macOS install
│   ├── install.ps1       # Windows install
│   ├── autostart.ps1     # Auto-start script
│   ├── install-startup.ps1   # Install auto-start
│   └── uninstall-startup.ps1 # Remove auto-start
├── package.json
├── tsconfig.json
├── README.md
└── QUICKSTART.md

Data Locations

Data	Location
Settings	`~/.qwen/qwenclaw/settings.json`
Jobs	`~/.qwen/qwenclaw/jobs/*.md`
Logs	`~/.qwen/qwenclaw/logs/*.log`
Session	`~/.qwen/qwenclaw/session.json`
State	`~/.qwen/qwenclaw/state.json`
PID File	`~/.qwen/qwenclaw/daemon.pid`

Troubleshooting

Check auto-start is configured:
- Windows: Check shell:startup folder for shortcut
- Linux: Check systemctl status qwenclaw.service
- macOS: Check launchctl list | grep qwenclaw

Check logs:

# Auto-start logs
cat ~/.qwen/qwenclaw/autostart.log

# Daemon logs
ls -la ~/.qwen/qwenclaw/logs/

Start manually:
```
bun run start --web
```

Port already in use

Edit ~/.qwen/qwenclaw/settings.json:

{
  "web": {
    "port": 4633
  }
}

Telegram bot not responding

Verify token is correct in settings
Check your user ID is in allowedUserIds
Enable debug mode: add --debug flag when starting

Jobs not running

Verify cron syntax (use crontab.guru)
Check timezone settings
Review job file format (frontmatter + prompt)

Updating

# Navigate to repository
cd QwenClaw-with-Auth

# Pull latest changes
git pull

# Reinstall dependencies
bun install

# Restart daemon
bun run stop
bun run start --web

Uninstall

Remove Auto-Start

Windows:

.\scripts\uninstall-startup.ps1

Linux:

sudo systemctl disable qwenclaw.service
sudo systemctl stop qwenclaw.service
rm ~/.config/autostart/qwenclaw.desktop

macOS:

launchctl unload ~/Library/LaunchAgents/com.qwenclaw.daemon.plist
rm ~/Library/LaunchAgents/com.qwenclaw.daemon.plist

Remove Data

# Remove all QwenClaw data
rm -rf ~/.qwen/qwenclaw

# Remove repository
rm -rf QwenClaw-with-Auth

Versioning & Changelog

QwenClaw follows Semantic Versioning (MAJOR.MINOR.PATCH).

[1.3.0] - 2026-02-26

Added

Full Rig Integration - Rust-based AI agent framework
rig-service/ - Standalone Rust microservice with:
- Multi-agent orchestration (Agent Councils)
- Dynamic tool calling with ToolSet registry
- RAG workflows with SQLite vector store
- HTTP/REST API for TypeScript integration
TypeScript Client - src/rig/client.ts for seamless integration
API Endpoints:
- /api/agents - Agent management
- /api/councils - Multi-agent orchestration
- /api/tools - Tool registry and search
- /api/documents - Vector store for RAG
Documentation: docs/RIG-INTEGRATION.md with full usage guide

Changed

Updated Rig analysis doc with implementation details

[1.2.0] - 2026-02-26

Added

10 OpenClaw Skills from awesome-openclaw-skills:
- achurch (community sanctuary)
- agent-council (multi-agent orchestration)
- agent-identity-kit (AI agent identity)
- mcp-builder (Model Context Protocol)
- coder-workspaces (dev environment management)
- backend-patterns (architecture patterns)
- code-mentor (programming tutor with references)
- coding-agent (run multiple coding agents)
- ec-task-orchestrator (autonomous task management)
- essence-distiller (content analysis)
Total Skills: 35 (25 Claude + 10 OpenClaw)

[1.1.0] - 2026-02-26

Added

Skills Integration: Imported 25+ skills from awesome-claude-skills
- Content Research Writer
- File Organizer
- Developer Growth Analysis
- Changelog Generator
- Document Skills
- Image Enhancer
- Video Downloader
- And 19 more...
Cross-platform support: Full compatibility for Windows, Linux, and macOS
Skills index: skills/skills-index.json for skill discovery
Installation scripts: install.sh (Linux/macOS) and install.ps1 (Windows)

Fixed

Daemon startup issue on Windows (qwen.cmd path resolution)
Settings file path (.qwen/qwenclaw/settings.json)
Statusline command path (.qwen/statusline.cjs)
Async/await handling in main entry point
Shell execution for cross-platform command spawning

Changed

Removed debug logging from production code
Improved error handling and reporting
Updated README with comprehensive documentation
Added versioning and changelog section

[1.0.0] - 2026-02-26

Added

Initial release
Daemon with auto-start capability
Heartbeat system with quiet hours
Cron job scheduling
Telegram bot integration
Web dashboard (http://127.0.0.1:4632)
Four security levels (locked, strict, moderate, unrestricted)
Session persistence
Hot-reload configuration
Windows Task Scheduler integration
Linux systemd service support
macOS LaunchAgent support

License

MIT License - See LICENSE file for details.

Acknowledgments

QwenClaw is inspired by ClaudeClaw by @moazbuilds.

Support

For issues, questions, or contributions:

Repository: https://github.rommark.dev/admin/QwenClaw-with-Auth
Issues: https://github.rommark.dev/admin/QwenClaw-with-Auth/issues

13 KiB Raw Blame History

QwenClaw 🐾

Features

Quick Install

One-Command Install

Manual Installation

Prerequisites

Steps

Auto-Start Configuration

Windows

Linux

macOS

Usage

Start the Daemon

Check Status

Stop the Daemon

Send a Prompt

Clear State

Configuration

Settings File

Security Levels

Scheduled Jobs

Example: Daily Standup

Cron Syntax

Examples

Telegram Integration

Setup

Bot Commands

Features

Web Dashboard

Features

Project Structure

Data Locations

Troubleshooting

Daemon not starting on login

Port already in use

Telegram bot not responding

Jobs not running

Updating

Uninstall

Remove Auto-Start

Remove Data

Versioning & Changelog

[1.3.0] - 2026-02-26

Added

Changed

[1.2.0] - 2026-02-26

Added

[1.1.0] - 2026-02-26

Added

Fixed

Changed

[1.0.0] - 2026-02-26

Added

License

Acknowledgments

Support

13 KiB

Raw Blame History