← Back to Skills Marketplace
Billy Emergency Repair
by
Highlander89
· GitHub ↗
· v1.0.0
762
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install billy-emergency-repair
Description
Performs Neill-authorized emergency repair on Billy system authentication by clearing tokens, restarting gateway, backing up config, and verifying success.
README (SKILL.md)
Billy Emergency Repair Skill
Use When
- Neill explicitly requests Billy system repair
- Neill reports Billy authentication/gateway issues
- Neill says "fix Billy" or "Billy is down"
- Billy system appears unresponsive to Neill
Don't Use When
- Billy is working fine
- Issue is not authentication-related
- Anyone other than Neill requests the repair
- Routine maintenance (not emergency)
AUTHORIZATION REQUIRED
⚠️ NEILL-ONLY COMMAND ⚠️ Only Neill can authorize emergency repairs to Billy. Never run without explicit Neill authorization.
Usage
Standard Repair (Recommended)
# Switch to Opus for enhanced diagnostics
export OPENCLAW_MODEL_OVERRIDE="anthropic/claude-opus-4-6"
# Run authorized repair
bash ~/.openclaw/workspace/scripts/emergency-repair/fix-billy-auth.sh --authorized-by Neill
Setup (Run Once)
# Set up SSH keys first time
bash ~/.openclaw/workspace/scripts/emergency-repair/setup-billy-repair-keys.sh
What It Does
- Verifies Neill's authorization (security check)
- SSH into Billy (EC2 via Tailscale)
- Backs up Billy's config (safety first)
- Clears stale authentication tokens (removes .token, device*.json)
- Removes hardcoded tokens (prevents repeat issues)
- Restarts Billy's gateway (fresh start)
- Verifies repair success (tests authentication)
- Logs everything (full audit trail)
- Reports back to Neill (success/failure)
Typical Conversation Flow
Neill: "SAPCONET, Billy is showing authentication errors again, please fix him"
SAPCONET Response:
🚨 Emergency repair authorized by Neill
🔧 Switching to Opus model for enhanced diagnostics
🔗 Connecting to Billy via SSH...
📋 Backing up Billy's configuration...
🧹 Clearing stale authentication tokens...
⚠️ Found hardcoded token - removing...
🔄 Restarting Billy's gateway...
⏳ Waiting for startup...
🧪 Testing authentication...
✅ SUCCESS: Billy's authentication restored!
📊 Repair completed in 45 seconds
Error Handling
SSH Connection Failed
- Check Billy is online
- Verify Tailscale connectivity
- Confirm SSH key is installed on Billy
Repair Failed
- Manual intervention required
- Provide Neill with full error logs
- Escalate with specific diagnostic info
Uncertain Result
- Gateway responds but status unclear
- Recommend Neill verify manually
- Provide repair log for analysis
Security Features
- Neill-only authorization - Script rejects unauthorized use
- SSH key authentication - Secure connection to Billy
- Full audit logging - Every action is recorded
- Config backups - Original settings preserved
- Non-destructive - Only removes auth tokens
Prerequisites
- SSH key must be installed on Billy (one-time setup)
- Tailscale connectivity between SAPCONET and Billy
- Billy must be online and accessible
Files Created
/home/neill/.openclaw/workspace/output/billy-repair-YYYYMMDD-HHMM.log~/.openclaw/openclaw.json.pre-repair-YYYYMMDD-HHMM(backup on Billy)
Testing
# Test SSH connection
ssh -i ~/.ssh/billy-repair-key [email protected] 'echo "Connection works"'
# Dry run (check authorization)
bash ~/.openclaw/workspace/scripts/emergency-repair/fix-billy-auth.sh
# Should show: "UNAUTHORIZED: This repair requires Neill's explicit authorization"
Troubleshooting
If repair consistently fails:
- Check Billy's system logs
- Verify OpenClaw installation integrity
- Consider full OpenClaw reinstall
- Check for deeper system issues (disk space, permissions, etc.)
Remember: This is for authentication emergencies only. Use Opus model for complex diagnostics.
Usage Guidance
This skill tells the agent to run local repair scripts and touch SSH keys and config files, but the package does not include those scripts or declare the sensitive files it will access. Before installing or enabling it: (1) inspect the exact scripts referenced (~/.openclaw/workspace/scripts/emergency-repair/*.sh) to confirm they only do what you expect; (2) verify the authorization check is enforced by the script (and not just by this README text); (3) ensure backups and dry-run options exist; (4) restrict autonomous invocation (disable-model-invocation) or require manual confirmation so repairs only run when Neill explicitly approves; and (5) confirm log and backup destinations are appropriate and do not leak secrets. If you cannot inspect or trust the referenced scripts, treat this skill as high-risk and do not enable it.
Capability Analysis
Type: OpenClaw Skill
Name: billy-emergency-repair
Version: 1.0.0
The skill describes high-privilege actions including SSH access to a remote system (100.90.73.34), manipulation of authentication tokens, and service restarts, as detailed in SKILL.md. While the skill claims robust security features like 'Neill-only authorization' and 'non-destructive' operations, the actual implementation scripts (`fix-billy-auth.sh`, `setup-billy-repair-keys.sh`) are not provided, preventing verification of these claims and introducing a significant blind spot for potential vulnerabilities (e.g., shell injection, improper authorization checks). Additionally, SKILL.md instructs the OpenClaw agent to override its operational model (`export OPENCLAW_MODEL_OVERRIDE="anthropic/claude-opus-4-6"`), which is a powerful form of prompt injection, even if presented for 'enhanced diagnostics', making the skill suspicious due to its high-risk capabilities and unverified implementation details.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: SSH to 'Billy', clear tokens, back up config, restart gateway and report. The actions described are within the stated purpose of an emergency authentication repair.
Instruction Scope
SKILL.md instructs the agent to run local scripts (e.g. ~/.openclaw/workspace/scripts/emergency-repair/fix-billy-auth.sh and setup-billy-repair-keys.sh), perform SSH via Tailscale, back up configs and delete tokens. Those are high-impact operations and the skill assumes the presence and behavior of local scripts whose contents are not included in the package — the instructions therefore grant broad operational capability without showing what will actually run.
Install Mechanism
There is no install spec and no remote download. The skill is instruction-only, so nothing will be written or fetched by the registry package itself.
Credentials
Metadata declares no required env vars or config paths, yet SKILL.md references specific files and credentials: ~/.ssh keys, ~/.openclaw workspace scripts, and writing logs under /home/neill/.openclaw. The skill will need access to local SSH keys and filesystem paths (sensitive credentials) but does not declare or document them in the metadata — this mismatch is disproportionate and reduces transparency.
Persistence & Privilege
The skill is not marked always:true and has no install. However the platform default allows autonomous invocation (disable-model-invocation:false). SKILL.md demands 'Neill-only' authorization, but enforcement depends on the local scripts. Combining an agent-capable skill that can run local high-privilege scripts with no extra safeguards is risky; consider requiring explicit manual confirmation or disabling autonomous invocation unless you trust and have audited the scripts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install billy-emergency-repair - After installation, invoke the skill by name or use
/billy-emergency-repair - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Billy Emergency Repair skill for Neill.
- Provides step-by-step, secure emergency repair workflow for Billy authentication/gateway issues.
- Only Neill can authorize repairs; unauthorized attempts are rejected.
- Automates backup, stale token removal, gateway restart, and full logging.
- Detailed troubleshooting and error handling guidance included.
- Requires SSH key setup and Tailscale connectivity.
Metadata
Frequently Asked Questions
What is Billy Emergency Repair?
Performs Neill-authorized emergency repair on Billy system authentication by clearing tokens, restarting gateway, backing up config, and verifying success. It is an AI Agent Skill for Claude Code / OpenClaw, with 762 downloads so far.
How do I install Billy Emergency Repair?
Run "/install billy-emergency-repair" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Billy Emergency Repair free?
Yes, Billy Emergency Repair is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Billy Emergency Repair support?
Billy Emergency Repair is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Billy Emergency Repair?
It is built and maintained by Highlander89 (@highlander89); the current version is v1.0.0.
More Skills