gh-aw-firewall
Sandboxed network firewall with domain whitelisting for workflows
All Skills in This Repository (4)
Pure Emerald Level Indicatorsawf-skill
Enforce domain allowlists and host-level protections for AI agent network access.
debug-firewall
Inspect awf-squid and awf-agent containers, Squid logs, and iptables rules to diagnose AWF firewall issues.
recompile-workflows
Regenerate and post-process agentic workflow lock files after gh-aw updates.
awf-debug-tools
Parse AWF logs and container health to diagnose firewall problems.
Frequently Asked Questions
FAQPage SchemaHow to install gh-aw-firewall?โผ
Run `npx skills add github/gh-aw-firewall --all -g -y` in your terminal to install all skills in this suite globally.
What does gh-aw-firewall do?โผ
It runs any command inside a Docker sandbox where all outbound HTTP/HTTPS traffic passes through a Squid proxy that only allows whitelisted domains. This lets you run automated workflows and agents with strict network isolation.
How do I allow specific domains through the firewall?โผ
Pass a comma-separated list with the --allow-domains flag, for example `sudo awf --allow-domains github.com,api.github.com -- curl https://api.github.com`. Subdomains of allowed domains are matched automatically.
How are API keys protected in gh-aw-firewall?โผ
An optional API proxy sidecar holds the real credentials for OpenAI, Anthropic, Copilot, and Gemini, so keys never appear in the agent's environment. The agent calls the sidecar without auth and the sidecar injects the real key before forwarding.
How do I debug blocked domains in gh-aw-firewall?โผ
Use the included debug skills and Python scripts to parse Squid logs, list blocked domains, and test domain reachability. Commands like `awf logs --format json` or the parse-squid-logs.py script show exactly which requests were denied.
Related Repositories in Software Engineering
View All in Software Engineeringโopenclaw
Run a personal AI assistant across your devices and chat apps
superpowers
Gives coding agents a disciplined workflow from idea to merged code
react
AI agent skills for building, testing, and porting React core