clawline-webroot - SKILL.md Agent Skill

name: clawline-webroot description: Serve static files from the Clawline provider at /www. metadata: { "openclaw": { "skillKey": "clawline-webroot" } }

Clawline Web Root

The Clawline provider serves static files from a local directory.

Configuration

Config key: channels.clawline.webRootPath
To find the webroot path, try reading the config key first:
```
openclaw config get channels.clawline.webRootPath
```
If no value is set, the default is: ~/.openclaw/workspace/www/

Accessing files

URL pattern: http://<hostname>:<clawline-port>/www/<filename>

The port is the Clawline provider port (channels.clawline.port, default 18800)
This is NOT the gateway port or any other internal port
Do not hand out localhost unless the viewer is definitely on the same machine that is serving the file.
If the viewer is on another device (including Tailscale clients, remote browsers, gateway/web clients, phones, tablets, or laptops on the network), use the serving machine's reachable hostname or IP instead.
In Flynn's setup, prefer the host's reachable Tailscale/host address by default unless same-machine viewing is explicitly known.
Example for same-machine viewing only: http://localhost:18800/www/index.html
Example for remote viewing: http://<reachable-hostname>:18800/www/index.html

Usage

# Find the webroot directory
webRootPath="$(openclaw config get channels.clawline.webRootPath 2>/dev/null || echo ~/.openclaw/workspace/www)"
mkdir -p "$webRootPath"

# Add a file
echo '<h1>Hello</h1>' > "$webRootPath/index.html"

# Verify it serves
curl http://localhost:18800/www/index.html

Security

Dotfiles blocked (files starting with . return 404)
Path traversal blocked (.. segments return 404)
Methods: GET and HEAD only

Custom Path

Override in config (JSON):

{
  "channels": {
    "clawline": {
      "webRootPath": "/path/to/custom/www"
    }
  }
}