← Back to Skills Marketplace
lidegejinghk

Openclaw Iterm2 Statusbar

by Ryan · GitHub ↗ · v0.1.1 · MIT-0
cross-platform ⚠ suspicious
299
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-iterm2-statusbar
Description
Install the OpenClaw iTerm2 status bar that shows session cost and context usage in real time.
Usage Guidance
What to consider before installing: - The code appears to do what it claims: poll a local OpenClaw Gateway and display cost/context in iTerm2. However the package metadata omitted that it needs an OPENCLAW_GATEWAY_TOKEN and reads ~/.openclaw/openclaw.json and ~/Library/LaunchAgents/ai.openclaw.gateway.plist. Treat that omission as a red flag: verify and understand where your token is stored before installing. - Avoid running the curl | bash one-liner without inspection. Instead download the repo or openclaw_status.py and inspect it locally before copying it into ~/Library/Application Support/iTerm2/Scripts/AutoLaunch. - Inspect ~/Library/LaunchAgents/ai.openclaw.gateway.plist (if present) to confirm it does not contain unrelated secrets you don't want scripts to read. Consider setting OPENCLAW_GATEWAY_TOKEN in your shell profile if you prefer explicitness. - Review ~/.openclaw/openclaw.json contents to ensure you are comfortable with the script reading it (it only reads compaction.reserveTokensFloor but user files can contain other data). - Confirm the OpenClaw Gateway is actually running on localhost:18789 and you trust its origin; the script only talks to that local endpoint (no external exfiltration observed), but a compromised local gateway could leak data. - If you decide to proceed, prefer manual installation (download, inspect, then copy) and keep backups of any tokens; if unsure, do not run the remote installer. If you discover unexpected behavior, remove the script from the AutoLaunch folder and revoke or rotate the gateway token.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-iterm2-statusbar Version: 0.1.1 The skill bundle utilizes a high-risk installation pattern in SKILL.md and install.sh, instructing the AI agent to execute a 'curl | bash' command that downloads and runs remote code. The installer establishes persistence by placing a script in the iTerm2 AutoLaunch directory, and the resulting openclaw_status.py script accesses sensitive local files (~/Library/LaunchAgents/ai.openclaw.gateway.plist and ~/.openclaw/openclaw.json) to retrieve authentication tokens. While these actions appear necessary for the stated purpose of monitoring a local OpenClaw gateway, the combination of remote execution, persistence, and credential access is highly risky for an automated agent.
Capability Assessment
Purpose & Capability
The script's behavior (poll a local OpenClaw Gateway, read a gateway token, and read ~/.openclaw/openclaw.json) matches the stated purpose of showing session cost and context. However the skill metadata declares no required env vars or config paths while the code explicitly depends on an OPENCLAW_GATEWAY_TOKEN and a local config file, which is an incoherence that should have been declared.
Instruction Scope
SKILL.md instructs installing a Python iTerm2 script into the user's AutoLaunch directory and restarting iTerm2 — that is expected. The runtime instructions and code access local resources (127.0.0.1:18789), the environment variable OPENCLAW_GATEWAY_TOKEN, and ~/.openclaw/openclaw.json (to compute reserve tokens). Those file/env accesses are in-scope for the stated functionality but they are not declared in metadata.
Install Mechanism
The installer uses curl -fsSL to fetch scripts from raw.githubusercontent.com (a well-known host) and offers a curl|bash one-liner. Downloading from a GitHub raw URL is common, but piping remote scripts to bash is inherently risky — users should review the script before running it. The included install.sh writes only to the user's iTerm2 AutoLaunch folder (no system-wide changes).
Credentials
Metadata reports no required environment variables or config paths, but the code reads OPENCLAW_GATEWAY_TOKEN (env or from ~/Library/LaunchAgents/ai.openclaw.gateway.plist) and ~/.openclaw/openclaw.json. Requesting a gateway token is reasonable for its function, but omitting this from the declared requirements is a mismatch and the plist-file lookup means the script will try to read a LaunchAgents plist (which may contain other environment data) — this should be documented and disclosed.
Persistence & Privilege
The skill installs a user-level iTerm2 script into the user's AutoLaunch folder and does not request always:true or attempt to change other skills or system-wide settings. It does read user-local config files and a LaunchAgents plist but does not create system services or grant elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-iterm2-statusbar
  3. After installation, invoke the skill by name or use /openclaw-iterm2-statusbar
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Version 0.1.1 of openclaw-iterm2-statusbar - No file changes detected in this release. - No updates to functionality, documentation, or installation process.
v0.1.0
- Initial release of openclaw-iterm2-statusbar. - Adds real-time display of OpenClaw session cost and context usage in the iTerm2 status bar. - Includes easy one-line and manual installation instructions. - Provides visual indicators for model, cost, context usage, and compaction threshold. - Requires macOS, iTerm2, and a local OpenClaw Gateway.
Metadata
Slug openclaw-iterm2-statusbar
Version 0.1.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Openclaw Iterm2 Statusbar?

Install the OpenClaw iTerm2 status bar that shows session cost and context usage in real time. It is an AI Agent Skill for Claude Code / OpenClaw, with 299 downloads so far.

How do I install Openclaw Iterm2 Statusbar?

Run "/install openclaw-iterm2-statusbar" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Openclaw Iterm2 Statusbar free?

Yes, Openclaw Iterm2 Statusbar is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Openclaw Iterm2 Statusbar support?

Openclaw Iterm2 Statusbar is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Openclaw Iterm2 Statusbar?

It is built and maintained by Ryan (@lidegejinghk); the current version is v0.1.1.

💬 Comments