gomail

# gomail Skill (OpenClaw)

Use the **gomail** `sender` CLI to send emails (with optional attachments and templates) from OpenClaw. This skill wraps the prebuilt Linux `sender` binary from the gomail project and exposes its flags as structured parameters.

## Installation

Download the latest prebuilt Linux AMD64 release that contains the `sender` binary:

```bash
# From a directory on your PATH or the skill directory
LATEST_URL=$(curl -sL -o /dev/null -w '%{url_effective}' https://github.com/craftslab/gomail/releases/latest)
VERSION=${LATEST_URL##*/}          # e.g. v2.7.2
VERSION_NO_V=${VERSION#v}         # e.g. 2.7.2

# Note: the release tag includes a leading "v", but the tarball filename does not.
wget "https://github.com/craftslab/gomail/releases/download/${VERSION}/gomail_${VERSION_NO_V}_linux_amd64.tar.gz"
tar -xf "gomail_${VERSION_NO_V}_linux_amd64.tar.gz"

# Ensure the binaries are executable
chmod +x sender parser
```

- **Recommended**: Place `sender` on your `PATH` (e.g. `/usr/local/bin/sender`) or keep it in the gomail skill directory and invoke it with `./sender`.
- This skill assumes a Linux environment compatible with the gomail Linux AMD64 builds.

## Configuration

The `sender` tool reads mail server and sender configuration from a JSON file passed via `--config`. This skill includes a starter config template at `sender.json` (in the gomail skill directory). It includes:

- SMTP server settings (host, port, TLS, auth)
- Authentication credentials
- A `sender` email address (the actual From address)

For OpenClaw, you can:

- Use the bundled config template in the gomail skill directory, `sender.json` (recommended).
- Or point `--config` to any other JSON file you manage.

> **Important**: `skill/sender.json` is a template. Replace the placeholder values with real SMTP credentials and keep secrets out of source control.

> **Important**: The `--header` flag only controls the human‑readable display name. The actual From email address is read from the...