Initial commit: QwenClaw persistent daemon for Qwen Code
This commit is contained in:
134
QUICKSTART.md
Normal file
134
QUICKSTART.md
Normal file
@@ -0,0 +1,134 @@
|
||||
# QwenClaw - Quick Start Guide
|
||||
|
||||
## What's Been Configured
|
||||
|
||||
✅ **Windows Auto-Start**: QwenClaw daemon starts automatically when you log in
|
||||
✅ **Web Dashboard**: Available at http://127.0.0.1:4632
|
||||
✅ **Default Settings**: Created in `.qwen/qwenclaw/settings.json`
|
||||
|
||||
---
|
||||
|
||||
## Verify Installation
|
||||
|
||||
### Check if daemon is running
|
||||
```powershell
|
||||
cd C:\Users\admin\qwenclaw
|
||||
bun run status
|
||||
```
|
||||
|
||||
### Check Windows Startup
|
||||
```powershell
|
||||
# Open Startup folder to see the shortcut
|
||||
shell:startup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Daily Usage
|
||||
|
||||
### Start daemon manually
|
||||
```bash
|
||||
bun run start --web
|
||||
```
|
||||
|
||||
### Check status
|
||||
```bash
|
||||
bun run status
|
||||
```
|
||||
|
||||
### Stop daemon
|
||||
```bash
|
||||
bun run stop
|
||||
```
|
||||
|
||||
### Send a prompt
|
||||
```bash
|
||||
bun run send "check my tasks"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configure
|
||||
|
||||
### Edit settings
|
||||
File: `C:\Users\admin\.qwen\qwenclaw\settings.json`
|
||||
|
||||
Key options:
|
||||
- `heartbeat.enabled` - Enable periodic check-ins
|
||||
- `heartbeat.interval` - Minutes between heartbeats
|
||||
- `telegram.token` - Telegram bot token
|
||||
- `security.level` - "locked", "strict", "moderate", "unrestricted"
|
||||
|
||||
### Add scheduled jobs
|
||||
Create files in: `C:\Users\admin\.qwen\qwenclaw\jobs\`
|
||||
|
||||
Example: `daily-standup.md`
|
||||
```markdown
|
||||
---
|
||||
schedule: 0 9 * * *
|
||||
recurring: true
|
||||
notify: true
|
||||
---
|
||||
|
||||
Summarize my calendar for today and list pending tasks.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Disable Auto-Start
|
||||
|
||||
If you want manual control:
|
||||
|
||||
```powershell
|
||||
cd C:\Users\admin\qwenclaw
|
||||
& scripts\uninstall-startup.ps1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Web Dashboard
|
||||
|
||||
Access at: **http://127.0.0.1:4632**
|
||||
|
||||
Features:
|
||||
- View daemon status
|
||||
- Configure heartbeat
|
||||
- Manage scheduled jobs
|
||||
- View logs
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Daemon not starting on login
|
||||
1. Check Startup folder has `QwenClaw Daemon.lnk`
|
||||
2. Check logs: `C:\Users\admin\.qwen\qwenclaw\autostart.log`
|
||||
3. Run manually: `bun run start --web`
|
||||
|
||||
### Port already in use
|
||||
Edit settings.json and change:
|
||||
```json
|
||||
{
|
||||
"web": {
|
||||
"port": 4633
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Check logs
|
||||
```bash
|
||||
# Daemon logs
|
||||
dir C:\Users\admin\.qwen\qwenclaw\logs
|
||||
|
||||
# Auto-start logs
|
||||
cat C:\Users\admin\.qwen\qwenclaw\autostart.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Location
|
||||
|
||||
- **Installation**: `C:\Users\admin\qwenclaw`
|
||||
- **Settings**: `C:\Users\admin\.qwen\qwenclaw\settings.json`
|
||||
- **Jobs**: `C:\Users\admin\.qwen\qwenclaw\jobs\`
|
||||
- **Logs**: `C:\Users\admin\.qwen\qwenclaw\logs\`
|
||||
Reference in New Issue
Block a user