intranet

What This Skill Does

The Intranet skill provides a lightweight, local HTTP server designed for the OpenClaw agent ecosystem. It eliminates the need for heavyweight web server software like Apache or Nginx by running entirely in user space without requiring root privileges. The skill serves static files from a designated webroot and offers a flexible plugin architecture that mounts local directories to URL prefixes. Furthermore, it supports dynamic functionality through CGI execution, allowing Python scripts named index.py to handle web requests. With robust configuration options—including bearer token authentication and host-based access control—Intranet turns your local machine into a powerful, secure internal server hub for agent tasks and data presentation.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/odrobnik/intranet

Ensure that your environment meets the prerequisites outlined in the SETUP.md file within the skill repository. Configuration is managed via the {workspace}/intranet/config.json file. Once configured, you can start the server using the command python3 {baseDir}/scripts/intranet.py start and control it using standard status and stop commands provided by the script interface.

Use Cases

• Internal Dashboarding: Create a local dashboard using HTML and CSS for visualizing data collected by other OpenClaw skills.
• Plugin Orchestration: Expose custom Python-based tools or automated scripts through a web interface, allowing the agent to trigger them via browser interactions.
• File Sharing: Quickly host static assets or local documentation directories for easy access within a secure local network.
• Local Web Development: Rapidly prototype web applications or microservices that require server-side execution without setting up a full production environment.

Example Prompts

1. "Start the intranet server on port 9000 with token authentication set to 'SecureAccess123' and enable LAN access."
2. "Check if the intranet server is currently running and display the status output."
3. "Configure a new plugin called 'task-manager' pointing to my local directory /home/user/workspace/tasks in the config.json file."

Tips & Limitations

• Security: Always use the --token flag when enabling LAN access to prevent unauthorized requests. Never store sensitive credentials in plain text within config.json.
• CGI Safety: CGI execution is disabled by default. Only enable it if you explicitly require dynamic script processing, and always use hashes for plugin scripts to ensure code integrity.
• Naming Constraints: Only files explicitly named index.py can be executed. Other Python files are blocked to prevent accidental exposure of backend logic or sensitive scripts.
• Permissions: Ensure your index.py files have the executable bit set (chmod +x) to prevent execution errors.