脚本位置

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

两种运行模式

模式 1：Cron 定时同步（默认）

OpenClaw 内置的 cron 定期执行该脚本：

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

触发语句：说“sync status”、“restart sync”或“同步状态”、“重启同步状态”——OpenClaw 将按计划触发执行。

模式 2：守护进程模式（Daemon Mode）

使用 --fork 启动真正的后台守护进程：

示例：

# 启动守护进程
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork

# 以 10 分钟间隔启动
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 10

触发条件

满足以下任一条件时即触发：

1. 首次初始化：说“enable status monitor”、“setup status-monitor”或“启用状态监控”、“开启监控同步”、“配置 status-monitor”
2. 手动触发：说“sync status”、“sync status-monitor”、“upload status”或“同步状态”、“同步 status-monitor”、“上传状态” → 单次执行
3. 定时同步：由 OpenClaw cron 触发 → 单次执行
4. 检查状态：说“check status monitor”、“monitor status”、“check upload service”或“查看状态监控”、“状态监控状态”、“检查上传服务”
5. 停止服务：说“stop status monitor”、“stop upload service”或“停止状态监控”、“停止上传服务”
6. 修改同步间隔：说“sync every 10 minutes”、“change to 15 minutes”或“每10分钟同步一次”、“改成15分钟”
7. 守护进程模式：说“start status monitor”、“start daemon”、“run in background”或“启动状态监控”、“启动守护进程”、“后台运行” → 执行 start --fork

其他触发语句：说“start status-monitor service”、“restart status-monitor service”或“启动status-monitor服务”、“重启status-monitor服务”。

初始化流程（首次使用时必须执行）

步骤 1：检查 Token 配置

技能运行时，首先按以下顺序查找 token：

1. 环境变量 MONITOR_PLATFORM_TOKEN
2. 文件 ~/.openclaw/credentials/openclaw-status-monitor.json

步骤 2：Token 缺失处理

若未找到 token，则引导用户完成注册/登录：

1. 向用户提示：

   No monitoring token found. Let me help you set up...
   
   Please choose a sign-in method:
   1. Existing user: visit https://openclaw-agent-monitor.vercel.app and click Sign In
   2. 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. 等待用户回复 token

3. 保存 token：

   • 创建目录 ~/.openclaw/credentials/
   • 写入文件 ~/.openclaw/credentials/openclaw-status-monitor.json：

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

4. 校验 token

步骤 3：Token 校验成功后

✅ 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

核心功能：上传脚本管理

1. 检查脚本是否存在

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

2. 启动服务（推荐）

# 使用 --fork 启动守护进程（推荐）
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 10

3. 设置同步间隔

# 方法 1：启动时指定
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py start --fork --interval 15

# 方法 2：使用 set-interval 命令
python3 ~/.openclaw/skills/openclaw-status-monitor/scripts/status_uploader.py set-interval 15

4. 停止服务

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

5. 检查服务状态

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

6. 查看错误日志

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

# 查看最近 50 行错误日志
tail -50 ~/.openclaw/logs/status_uploader_error.log

# 查看服务日志
tail -50 ~/.openclaw/logs/status_uploader.log

日志轮转：当日志文件超过 10MB 时自动轮转，格式为：status_uploader.20260329_183500.log

7. 手动触发单次上传

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

上传逻辑（简化版）

该脚本仅从 openclaw.json 中读取全部 agent ID 并上传 —— 不执行任何离线检测。

离线检测由监控平台（openclaw-agent-monitor）负责：

• 平台根据上传时间自动更新 lastActiveTimestamp
• 若连续 5 分钟以上未收到上传，平台将自动标记该 agent 为离线

存储配置

Token 存储位置

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

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

日志路径

• 服务日志：~/.openclaw/logs/status_uploader.log
• 错误日志：~/.openclaw/logs/status_uploader_error.log
• PID 文件：~/.openclaw/logs/status_uploader.pid
• Token 配置：~/.openclaw/credentials/openclaw-status-monitor.json

错误处理

1. Token 缺失

初始化期间：

❌ 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. 脚本未找到

❌ Upload script not found

Please reinstall the skill or contact the developer.

3. 服务启动失败

请检查错误日志：

cat ~/.openclaw/logs/status_uploader_error.log

常见错误：

• Token 未配置
• 网络连接失败
• 端口已被占用

4. Token 无效

❌ 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

对话示例

首次启用

用户： 启用状态监控 / 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（支持 Google/GitHub 等）
3. 登录后，在 Settings 页面生成 Agent Token
4. Send me the token

用户： 我的 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 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：

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 status monitor Agent： Stopping upload service...

✅ Service stopped

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

手动同步

用户： 同步状态 / sync status Agent： Executing manual upload...

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

重启服务

用户： 重启状态监控 / restart status monitor Agent： Restarting upload service...

✅ Service restarted, PID: 67890

检查错误日志

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

Recent errors：

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.