← 返回 Skills 市场
stefanferreira

Fuelwatch

作者 stefanferreira · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
76
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install fuelwatch
功能描述
Build, deploy, and extend the FuelWatch crowdsourced fuel availability tracker for South Africa. Use when working on FuelWatch features, fixing bugs, deployi...
使用说明 (SKILL.md)

FuelWatch — Crowdsourced SA Fuel Tracker

Overview

FuelWatch is a mobile-first web app for tracking diesel/petrol prices and availability at SA fuel stations. Built during the 2026 Iran war / diesel shortage crisis when diesel prices jumped from ~R21 to R28+ and many stations ran dry.

Live URL: http://161.97.110.234:8080
Files: /root/fuelwatch/ (index.html, style.css, app.js)
Service: systemctl status fuelwatch (auto-restarts, survives reboots)

Architecture

  • Pure HTML + vanilla JS + CSS (no build step, no framework)
  • Data in localStorage (prototype — no backend yet)
  • Served by Python HTTP server via systemd

Key Features

  • Station list/cards: name, suburb, fuel type, price/L, availability status
  • Availability: 🟢 Has Fuel / 🟡 Low Stock / 🔴 Out of Stock
  • Reports older than 2 hours flagged ⚠️ Unverified
  • ➕ Report form (no login required)
  • 📤 Share button (native share or clipboard)
  • Search by suburb/station, filter by fuel type, sort by recent/price
  • 8 seed reports pre-loaded (clears if localStorage has data)
  • XSS-safe (user input escaped before render)

Extending the app

See references/backend-plan.md for the planned Supabase backend.

Add a new feature

Edit /root/fuelwatch/app.js for logic, style.css for styling, index.html for structure. No build step — changes are live immediately.

Deploy updates

# Files are served directly — edit and refresh browser
systemctl status fuelwatch   # check service is running
systemctl restart fuelwatch  # if needed

Add real backend (Phase 2)

  • Supabase (free tier): Postgres + REST API + real-time
  • Replace localStorage read/write in app.js with fetch() calls
  • Add Supabase JS client via CDN script tag
  • See references/backend-plan.md

WhatsApp Reporting Channel (Phase 3)

Number: +27822209212 (Stef's spare WhatsApp)

Concept: People send WhatsApp text or voice notes to report fuel availability. OpenClaw receives, parses/transcribes, and submits to FuelWatch DB automatically.

Flow:

  1. User sends: "Shell Edenvale diesel R27.50 has fuel" (or voice note)
  2. OpenClaw parses structured data: station / suburb / fuel type / price / availability
  3. Auto-inserts into Supabase reports table
  4. Web UI updates in real time

Why: Truckers + road users → voice note while driving. Zero friction. No app needed.

Requirements:

  • WhatsApp channel connected to OpenClaw (wacli or WAHA)
  • Supabase backend live (Phase 2 first)
  • NLP parser for free-text reports (can use LLM extraction)
  • Voice transcription: OpenAI Whisper or Groq Whisper

See: references/whatsapp-reporting.md (to be written when building Phase 3)

Marketing plan (when ready to go public)

  • Register domain (fuelwatch.co.za or similar)
  • Deploy to Vercel (free, vercel --prod from /root/fuelwatch)
  • Post to: SA Facebook groups (Arrive Alive, Joburg/CT/DBN community groups, trucker groups)
  • Tweet: #DieselShortage #FuelCrisis #SouthAfrica — tag @ArrivAlive @MyBroadband
  • Comment on IOL/MyBroadband articles about diesel crisis
  • Email MyBroadband/CarMag for coverage ("local tool built in response to crisis")

Competitive context

myTank.co.za — existing competitor. Has price comparison, rewards calc. Missing: availability status, no crowdsourcing, requires account to see prices, no crisis mode.

Our edge: availability (Has Fuel / Low Stock / Out of Stock) is the killer feature — what people actually need during a shortage.

安全使用建议
This skill reads like developer documentation for a local web app, but it raises several red flags you should clarify before installing or giving it permissions: (1) It assumes direct access to /root/fuelwatch and the ability to run systemctl — only grant that to trusted code or run in an isolated VM/container. (2) Phase 2/3 plans require Supabase keys, an OpenAI/Whisper API key, and a WhatsApp channel; these credentials are not declared in the registry—ask the author which env vars will actually be needed and why. (3) The SKILL.md references an external IP (161.97.110.234) and a personal WhatsApp number; confirm you trust those endpoints and the operator. (4) If you plan to enable the WhatsApp auto-ingest, verify how incoming messages are validated/ratelimited to avoid spam or malicious reports. To improve confidence: request the skill source (homepage or repo), the exact env vars it will use, the systemd service unit content, and whether it will perform any network calls automatically. If you proceed, run it in a sandboxed environment and inspect/backup /root/fuelwatch and the systemd unit before making changes.
功能分析
Type: OpenClaw Skill Name: fuelwatch Version: 1.0.0 The fuelwatch skill is a project bundle for a crowdsourced fuel availability tracker in South Africa. It contains documentation and plans for a web application, including a systemd service configuration and a migration path to a Supabase backend. While the skill involves high-privilege operations such as managing a systemd service and editing files in /root/fuelwatch/, these actions are consistent with the stated purpose of deploying and maintaining a web service. No evidence of data exfiltration, malicious persistence, or harmful prompt injection was found.
能力评估
ℹ Purpose & Capability
The name/description (build, deploy, extend FuelWatch) aligns with the instructions to edit files, restart the service, and add a backend. However the SKILL.md also references external services (Supabase, Whisper/OpenAI, WhatsApp integration) and a live host at 161.97.110.234:8080 and a personal phone number; those external integrations meaningfully expand the skill's capabilities compared with a simple local-editing helper and are not declared in the registry metadata.
⚠ Instruction Scope
Instructions assume access to /root/fuelwatch and the ability to run systemctl (view and restart a systemd service). They also describe replacing localStorage with networked DB calls and auto-inserting reports from WhatsApp into a remote Supabase DB. The SKILL.md does not contain explicit steps that read unrelated host files or exfiltrate secrets, but it does instruct actions that require elevated host privileges and network access to external services.
✓ Install Mechanism
This is an instruction-only skill with no install spec or bundled code, which minimizes direct install risk. No downloads or install scripts are present in the manifest.
⚠ Credentials
The files reference SUPABASE_URL and SUPABASE_ANON_KEY and recommend using Whisper/OpenAI and WhatsApp integrations, but the registry lists no required environment variables or primary credential. That mismatch means the skill will need external credentials at runtime (Supabase keys, OpenAI API key, WhatsApp channel credentials) but does not declare them—this is disproportionate and should be explicit.
ℹ Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills' configs, but it assumes the ability to edit files under /root and control a systemd service. Those are significant system privileges; users should only use this skill in environments where the agent is authorized to perform system administration.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install fuelwatch
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /fuelwatch 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
FuelWatch 1.0.0 - Initial release of FuelWatch, a mobile-first web app for tracking fuel prices and availability at South African stations. - Features include station list with search, filter, sort; crowdsourced fuel status reporting; and a share button. - Data stored in localStorage; prototype runs without backend. - XSS-safe input handling, with data flagged as unverified after 2 hours. - Documentation includes roadmap for Supabase backend and WhatsApp/voice reporting channel in later phases.
元数据
Slug fuelwatch
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Fuelwatch 是什么？

Build, deploy, and extend the FuelWatch crowdsourced fuel availability tracker for South Africa. Use when working on FuelWatch features, fixing bugs, deployi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 76 次。

如何安装 Fuelwatch？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install fuelwatch」即可一键安装，无需额外配置。

Fuelwatch 是免费的吗？

是的，Fuelwatch 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Fuelwatch 支持哪些平台？

Fuelwatch 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Fuelwatch？

由 stefanferreira（@stefanferreira）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论