Connect a platform

1. Get a webhook URL and a secret or token from the platform.
2. On the Webhooks page, click Add endpoint.
3. Paste the URL into Endpoint URL and the secret or token into Auth header or secret. OpenMail picks the authentication scheme from its shape.
4. Under Events, pick message.received unless you also want the lifecycle events.
5. On the endpoint’s Testing tab, click Send Example to check the platform accepts it.

​

Grok automations

1. In Grok, create or edit an automation and add a Webhook trigger.
2. Save the automation, then copy the endpoint and signing secret shown under the trigger. Grok shows the secret only once.
3. In OpenMail, add an endpoint with the Grok endpoint as the URL and the whsec_ signing secret as the secret.

​

Hermes Agent

1. Generate a secret:
   echo "whsec_$(openssl rand -base64 32)"
   
2. Add a route to ~/.hermes/config.yaml with that secret. The prompt template reads fields from the OpenMail payload:
   platforms:
     webhook:
       enabled: true
       extra:
         port: 8644
         routes:
           openmail:
             secret: "whsec_..."
             prompt: |
               New email to {message.to} from {message.from}
               Subject: {message.subject}
   
               {message.body_text}
   
               Thread: {thread_id}
   
3. Restart the gateway. The route listens at /webhooks/openmail.
4. In OpenMail, add an endpoint with the public URL of that route, for example https://hermes.example.com/webhooks/openmail, and the same whsec_ secret.

​

OpenClaw

{
  hooks: {
    enabled: true,
    token: "<long-random-hook-token>",
    mappings: [
      {
        id: "openmail",
        match: { path: "openmail" },
        action: "agent",
        name: "OpenMail",
        messageTemplate: "New email to {{message.to}} from {{message.from}}\nSubject: {{message.subject}}\n\n{{message.body_text}}\n\nThread: {{thread_id}}",
      },
    ],
  },
}

1. Add the config above, with your own long random value for hooks.token. Use a different value from your gateway auth token.
2. Reload the gateway. The mapping listens at /hooks/openmail.
3. In OpenMail, add an endpoint with the public URL of that path, for example https://openclaw.example.com/hooks/openmail, and paste the hook token as the secret.
4. Under Events, pick only message.received. Lifecycle events have no message, so the template would render an almost empty prompt.

​

Related