| name | local-approvals |
| description | Local approval system for managing agent permissions. Use CLI to approve/deny requests, view history, and manage auto-approved categories. |
Local Approvals Skill
A local approval system that manages agent permissions with auto-approve lists and approval history tracking.
Quick Start
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py list
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py approve abc123
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py deny abc123
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py history
python C:\Users\Shai\.openclaw\skills\local-approvals\cli.py reset assistant
Commands
approve(id)
Approve a pending request by ID.
python cli.py approve <request_id> [--learn] [--reviewer <name>]
Options:
--learn: Add the category to the agent's auto-approve list
--reviewer: Who is approving (default: "user")
Example:
python cli.py approve abc123 --learn
deny(id)
Deny a pending request by ID.
python cli.py deny <request_id> [--reviewer <name>]
Options:
--reviewer: Who is denying (default: "user")
Example:
python cli.py deny abc123
list_pending()
List all pending requests, optionally filtered by agent.
python cli.py list [--agent <agent_id>]
Options:
--agent: Filter requests by agent ID
Example:
python cli.py list --agent assistant
show_history()
Show approval history from state.json.
python cli.py history [--limit <number>]
Options:
--limit: Maximum number of entries to show (default: 20)
Example:
python cli.py history --limit 50
reset_categories(agent)
Reset an agent's auto-approved categories list.
python cli.py reset <agent_id>
Example:
python cli.py reset assistant
Additional Commands
categories
Show auto-approved categories for one or all agents.
python cli.py categories [--agent <agent_id>]
Options:
--agent: Show categories for specific agent
Example:
python cli.py categories --agent planner
State Files
The skill maintains two JSON files in the state directory:
- state.json: Auto-approve lists and approval history
- pending.json: Pending approval requests
Location: ~/.openclaw/skills/local-approvals/
Core Functions
The core.py module provides the underlying functionality:
check_auto_approve(agent, category) - Check if a category is auto-approved
submit_request(agent, category, operation, reasoning) - Submit a pending request
learn_category(agent, category) - Add category to auto-approve list
get_request(request_id) - Retrieve a request by ID
update_request(request_id, decision, reviewer) - Update request with decision
list_pending(agent) - List pending requests
get_agent_approvals(agent) - Get agent's auto-approved categories
Best Practices
- Review before approving: Always check the operation and reasoning before approving
- Use auto-learn carefully: Only use
--learn for trusted categories that you want to auto-approve
- Check history regularly: Review
history to understand approval patterns
- Reset when needed: Use
reset to clear an agent's auto-approve list if you suspect issues
Examples
Complete Workflow
python cli.py list
python cli.py approve abc123 --learn
python cli.py list
python cli.py history
python cli.py categories
Managing Categories
python cli.py categories
python cli.py categories --agent assistant
python cli.py reset assistant
Integration
The CLI is designed to be used both interactively and programmatically. Exit codes:
0: Success
1: Error (request not found, agent not found, etc.)
Files
cli.py - Command-line interface (this file)
core.py - Core approval functions
schemas/ - JSON schema definitions
schemas/state.json - State schema template
schemas/pending.json - Pending requests schema template