360 Secure SkillHub
360 安全技能中心

Timezone

该 Skill 通过 now.py 输出准确本地时间，用 timezone_setup.py 完成一次性时区配置并写入 tz_config.json，可在用户显式确认后以 --patch-agents 向 AGENTS.md 写入时区规则；同时给出 UTC 陷阱判断规则，避免把 UTC 时间戳当作本地时间报告。它不会自动拦截所有时间输出，也不支持多用户/多时区环境。

ferrentinomj-dev
ferrentinomj-dev
热度 53.75
最近更新 2026-09-25 06:17:15
分类：自动化依赖：代码执行 / 读写文件应用场景：自动化脚本 / 工作流 / DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add agent-timezone-lock
Metadata
name
agent-timezone-lock
description
Stops an OpenClaw agent from reporting the wrong time. Prevents the UTC-as-local mistake. Use when (1) the user reports a wrong time, (2) asks what time it is, (3) says 'set my timezone', or (4) agent output shows a time clearly off. Does NOT trigger on generic mentions of UTC, timezone, or heartbeats — only when time accuracy is explicitly at issue.
permissions
{"read":["USER.md","skills/timezone/tz_config.json"],"write":["skills/timezone/tz_config.json"],"write_conditional":[{"path":"AGENTS.md","condition":"Only when user explicitly runs timezone_setup.py --patch-agents and confirms"}],"exec":["timedatectl","/etc/localtime (read-only)"]}

Timezone Enforcement Skill

Enforces correct local-time awareness. Prevents the classic UTC-as-local mistake.

What This Skill Does

  • Reads user timezone from USER.md (Timezone: field)
  • Provides now.py script for accurate local time output
  • Provides timezone_setup.py for one-time configuration
  • Optionally patches AGENTS.md with standing timezone rules — ONLY when user explicitly runs --patch-agents and confirms. This is not default behavior.

⚠️ User Warning: Running timezone_setup.py --patch-agents will write standing instructions into AGENTS.md. This persists across sessions and affects all future agent behavior. Only do this if you want the timezone rule to apply permanently.

What This Skill Does NOT Do

  • Does NOT automatically intercept all time output — agent must call now.py explicitly
  • Does NOT patch AGENTS.md without explicit --patch-agents flag
  • Does NOT handle multi-user or multi-timezone environments
  • Does NOT detect timezone changes after install — re-run timezone_setup.py if timezone changes

Permissions Required

This skill may:

  • Read USER.md (to detect timezone)
  • Read/write skills/timezone/tz_config.json (to save config)
  • Optionally write AGENTS.md (only when user explicitly approves --patch-agents)
  • Execute timedatectl or read /etc/localtime (system timezone detection only)

Prerequisites

USER.md should contain a timezone field:

Timezone: America/New_York

Use a valid IANA timezone string (e.g. America/New_York, Europe/London, Asia/Tokyo). Aliases like ET, PT, CT are also accepted.

Setup — Run Once on Install

python3 skills/timezone/scripts/timezone_setup.py

This detects timezone from USER.md or system, writes tz_config.json. Does NOT touch AGENTS.md unless user runs with --patch-agents.

To also patch AGENTS.md (optional, requires user confirmation):

python3 skills/timezone/scripts/timezone_setup.py --patch-agents

Reporting Time

Always run now.py before reporting any time — never guess from internal knowledge:

python3 skills/timezone/scripts/now.py

Report output verbatim. If it fails: tell the user, ask them to run timezone_setup.py first.

UTC Trap Detection

Before outputting any time, ask: is this UTC or local?

  • Timestamps ending in Z, +00:00, or +0000 → convert before reporting
  • API/cron/system timestamps → treat as UTC, always convert
  • User-provided times → treat as local, use as-is

/timezone Command

When user types /timezone:

  1. Show configured timezone and current local time (run now.py)
  2. Offer to change
  3. If changing: run timezone_setup.py --set "<IANA_NAME>"
  4. Confirm change

Custom implementations and questions: pods@agentmail.to