status-monitor

Script Location#

text

~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py

Two Running Modes#

Mode 1: Cron Scheduled Sync (Default)#

OpenClaw's built-in cron executes the script periodically:

bash

python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py

Trigger phrases: say "sync status", "restart sync" or "同步状态", "重启同步状态" — OpenClaw will trigger execution on schedule.

Mode 2: Daemon Mode#

Use --fork to start a real background daemon:

CommandDescriptionpython3 scripts/status_uploader.py start --forkStart daemonpython3 scripts/status_uploader.py start --fork --interval 10Start with custom interval (minutes)python3 scripts/status_uploader.py stopStop servicepython3 scripts/status_uploader.py statusCheck service statuspython3 scripts/status_uploader.py set-interval <minutes>Set sync intervalpython3 scripts/status_uploader.py testSingle test upload

Examples:

bash

# Start daemon
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork

# Start with 10-minute interval
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 10

Trigger Conditions#

Triggers when any of the following conditions are met:

1. First-time initialization: say "enable status monitor", "setup status-monitor" or "启用状态监控", "开启监控同步", "配置 status-monitor"
2. Manual trigger: say "sync status", "sync status-monitor", "upload status" or "同步状态", "同步 status-monitor", "上传状态" → single execution
3. Scheduled sync: OpenClaw cron triggers → single execution
4. Check status: say "check status monitor", "monitor status", "check upload service" or "查看状态监控", "状态监控状态", "检查上传服务"
5. Stop service: say "stop status monitor", "stop upload service" or "停止状态监控", "停止上传服务"
6. Change interval: say "sync every 10 minutes", "change to 15 minutes" or "每10分钟同步一次", "改成15分钟"
7. Daemon mode: say "start status monitor", "start daemon", "run in background" or "启动状态监控", "启动守护进程", "后台运行" → execute start --fork

Additional triggers: say "start status-monitor service", "restart status-monitor service" or "启动status-monitor服务", "重启status-monitor服务".

Initialization Flow (Must Execute on First Use)#

Step 1: Check Token Configuration#

When the skill runs, first check for the token in these locations:

1. Environment variable MONITOR_PLATFORM_TOKEN
2. File ~/.openclaw/credentials/openclaw-status-monitor.json

Step 2: Handling Missing Token#

If no token is found, guide the user to register/login:

1. Prompt the user: text

   No monitoring token found. Let me help you set up...
   
   Please choose a sign-in method:
   

2. Existing user: visit https://openclaw-agent-monitor.vercel.app and click Sign In

3. New user: visit https://openclaw-agent-monitor.vercel.app and click Sign Up

After signing in:

• Go to the Settings page
• Generate and copy your Agent Token
• Send me the generated token

2. **Wait for user to reply with token**

3. **Save the token**:
   - Create directory `~/.openclaw/credentials/`
   - Save to `~/.openclaw/credentials/openclaw-status-monitor.json`:
     json

     ```json
     {
       "agentToken": "user-provided-token",
       "createdAt": "2026-03-29T10:00:00.000Z",
       "monitorUrl": "https://openclaw-agent-monitor.vercel.app"
     }

     ```
4. **Validate the token**


### Step 3: After Successful Token Validation

text

✅ Token configured successfully!

Starting upload service...

• Running initial sync test...
• ✅ Service started successfully!

Monitor platform: https://openclaw-agent-monitor.vercel.app Upload interval: 5 minutes

Start command: python3 scripts/status_uploader.py start --fork

Management commands:

• Say "sync status" to manually trigger an upload
• Say "check status monitor" to check service status
• Say "stop status monitor" to stop the service
• Say "restart status monitor" to restart the service

## Core Functions: Managing the Upload Script

### 1\. Check if Script Exists

bash

```bash
if [ -f ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py ]; then
  echo "Script exists"
else
  echo "Script not found"
fi

2. Start Service (Recommended)#

bash

# Start daemon with --fork (recommended)
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 10

3. Set Sync Interval#

bash

# Method 1: specify at startup
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 15

# Method 2: use set-interval command
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py set-interval 15

4. Stop Service#

bash

python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py stop

5. Check Service Status#

bash

python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py status

6. View Error Logs#

text

~/.openclaw/logs/status_uploader_error.log
~/.openclaw/logs/status_uploader.log

bash

# View recent errors
tail -50 ~/.openclaw/logs/status_uploader_error.log

# View service logs
tail -50 ~/.openclaw/logs/status_uploader.log

Log rotation: log files auto-rotate when exceeding 10MB, format: status_uploader.20260329_183500.log

7. Manually Trigger One Upload#

bash

python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py test

Upload Logic (Simplified)#

The script only reads all agent IDs from openclaw.json and uploads them — it does not perform any offline detection.

Offline detection is handled by the monitoring platform (openclaw-agent-monitor):

• The platform automatically updates lastActiveTimestamp based on upload time
• If no upload is received for 5+ minutes, the platform automatically marks the agent as offline

Storage Configuration#

Token Storage Location#

~/.openclaw/credentials/openclaw-status-monitor.json:

json

{
  "agentToken": "e2d3262f-b626-4850-af11-5f2cb1c0dcad",
  "createdAt": "2026-01-26T10:00:00.000Z",
  "monitorUrl": "https://openclaw-agent-monitor.vercel.app",
  "syncIntervalMinutes": 5
}

Log Locations#

• Service log: ~/.openclaw/logs/status_uploader.log
• Error log: ~/.openclaw/logs/status_uploader_error.log
• PID file: ~/.openclaw/logs/status_uploader.pid
• Token config: ~/.openclaw/credentials/openclaw-status-monitor.json

Error Handling#

1. Missing Token#

During initialization:

text

❌ No monitoring token detected

Please complete these steps first:

1. Visit https://openclaw-agent-monitor.vercel.app
2. Click Sign In / Sign Up to log in or register
3. After logging in, generate an Agent Token on the Settings page
4. Send me the token

Example: My token is abc123-def456...

2. Script Not Found#

text

❌ Upload script not found

Please reinstall the skill or contact the developer.

3. Service Start Failed#

Check the error log:

text

cat ~/.openclaw/logs/status_uploader_error.log

Common errors:

• Token not configured
• Network connection failed
• Port already in use

4. Invalid Token#

text

❌ Token validation failed

Your token may have expired or is invalid.

Please obtain a new token:
1. Log in to https://openclaw-agent-monitor.vercel.app
2. Go to the Settings page
3. Click Generate to create a new Token
4. Send me the new token

Example Conversations#

First-time Enable#

User: 启用状态监控 / enable status monitor Agent: Checking monitoring configuration...

❌ No Agent Token detected

Please complete these steps first:

1. Visit https://openclaw-agent-monitor.vercel.app
2. Click Sign In (supports Google/GitHub, etc.)
3. After logging in, generate an Agent Token on the Settings page
4. Send me the token

---

User: 我的 Token 是 e2d3262f-b626-4850-af11-5f2cb1c0dcad / My token is e2d3262f-b626-4850-af11-5f2cb1c0dcad Agent: Validating token...

✅ Token validated successfully!

Starting upload service...

• Running initial sync test...
• ✅ Service started successfully!

---

✅ Status monitor enabled!

• Monitor platform: https://openclaw-agent-monitor.vercel.app
• Upload interval: 5 minutes
• Service status: running

Management commands:

• Say "sync status" / "同步状态" to manually trigger an upload
• Say "check status monitor" / "查看状态监控" to check service status
• Say "stop status monitor" / "停止状态监控" to stop the service

Check Service Status#

User: 查看状态监控 / check status monitor Agent: Checking upload service status...

✅ Service is running PID: 12345 Sync interval: 5 minutes Log file: ~/.openclaw/logs/status_uploader.log

Recent logs:

text

2026-03-29 10:30:01 - INFO - Upload success: ['main', 'coding']
2026-03-29 10:35:02 - INFO - Upload success: ['main', 'coding']

Error log: none

Stop Service#

User: 停止状态监控 / stop status monitor Agent: Stopping upload service...

✅ Service stopped

To restart, say "start status monitor" / "启动状态监控".

Manual Sync#

User: 同步状态 / sync status Agent: Executing manual upload...

Online agents: ['main', 'coding'] Upload result: ✅ Success

Restart Service#

User: 重启状态监控 / restart status monitor Agent: Restarting upload service...

✅ Service restarted, PID: 67890

Check Errors#

User: 查看状态监控错误日志 / check status monitor error log Agent: Checking error logs...

Recent errors:

text

2026-03-29 09:15:03 - HTTP 401: Unauthorized
2026-03-29 09:20:01 - Network: [Errno 8] nodename nor servname provided

Suggestion: Check if the token is correct, or check your network connection.