Writing
OpenClaw for the Field

OpenClaw for the Field: AI Agents That Meet Crews Where They Are

The Problem Nobody Talks About

There's a massive disconnect in construction AI. The people building the AI tools sit in offices with three monitors, fast WiFi, and a cup of pour-over coffee. The people who would benefit most from those tools are standing in 35-degree weather on a steel deck, wearing gloves, with a phone that has one bar of signal.

Field superintendents, foremen, and tradespeople don't open laptops on job sites. They don't "log into dashboards." They don't launch terminals. They send text messages. They take photos. They leave voice notes. That's it.

So here's the question: what if the AI came to them — inside the apps they already use every day?

That's exactly what OpenClaw (opens in a new tab) does.


What Is OpenClaw? (The Simple Version)

Imagine you have a really smart assistant who knows everything about your construction project — the schedule, the budget, the safety rules, the status of every question sent to the architect. Now imagine you could text that assistant on WhatsApp, just like you'd text a friend. You send "what's the status on that HVAC question?" and it replies in 5 seconds with the answer.

That's OpenClaw.

It's a free, open-source AI agent (with over 247,000 stars on GitHub — making it one of the most popular open-source projects in the world) that connects to messaging platforms as its primary interface. Not a website. Not an app you need to download. Your actual WhatsApp, Telegram, Slack, Discord, Signal, or iMessage.

What's an "AI Agent"?

A regular AI chatbot (like ChatGPT) waits for you to ask it something, gives an answer, and stops. An AI agent can actually do things. It can look up data in your project management software, send emails, create reports, and trigger alerts — all on its own. Think of the difference between asking someone a question vs. hiring someone to handle a task.


Why This Matters for Construction

Here's what a typical construction project looks like from a communication perspective:

Right now, there's a wall between the field and the office. The superintendent knows what happened today, but that information has to be manually entered into Procore (the project management software) by someone — usually at the end of a long day when everyone's tired and details get lost.

OpenClaw tears down that wall. A text message from the field automatically becomes structured data in the office systems.

How people in offices use AIHow field crews actually work
Open a browser, navigate to a dashboardSend a WhatsApp message with one thumb
Fill out a 15-field web formTake a photo and text it with a one-line caption
Check a real-time analytics dashboardAsk "what's the status?" in a group chat
Log into a portal with username/passwordVoice-message a question while driving to the site

OpenClaw meets them where they are. No training. No app downloads. No passwords. Just text the agent.


How It Works: The Gateway Model

What's a "Gateway"?

Think of a gateway like a reception desk at a building. Everyone walks up to the same desk (WhatsApp users, Telegram users, Slack users), the receptionist (the Gateway) figures out what they need, and routes them to the right person (the right "skill"). The Gateway is the single point that connects all the messaging apps to the AI brain.

OpenClaw uses a hub-and-spoke model. The "hub" is the Gateway — a program running on a server (or your computer) that connects to all your messaging platforms. The "spokes" are the messaging channels and the skills.

Here's what happens when a foreman texts a question:

What just happened in plain English:

  1. The foreman texted a question on WhatsApp
  2. OpenClaw's Gateway received it and figured out it's about an RFI (Request for Information — a formal question sent to the architect during construction)
  3. It triggered the "RFI tracker" skill, which looked up the answer in Procore
  4. It used an AI model (like Claude) to format the answer in a casual, field-friendly way
  5. It sent the answer back to WhatsApp — all in about 5 seconds

Quick Start: Getting OpenClaw Running

What You Need Before Starting

  • A computer (Mac, Linux, or Windows with WSL) that will act as the "server" running OpenClaw. This can be a $5/month cloud server or your office desktop.
  • Node.js version 24 (or 22.16+) installed. Node.js is the software that lets you run JavaScript programs on a server. Download it free from nodejs.org (opens in a new tab).
  • An API key from an AI provider like Anthropic (Claude) or OpenAI (GPT). This is like a password that lets OpenClaw use the AI brain. You get one by signing up at anthropic.com (opens in a new tab).

Install OpenClaw

Open your terminal (the text-based command window on your computer) and run:

npm install -g openclaw@latest
openclaw onboard --install-daemon

What this does: npm install -g downloads and installs the OpenClaw software globally on your computer. openclaw onboard --install-daemon runs the initial setup and starts a background process that keeps OpenClaw running.

Configure Your AI Provider

openclaw setup

This launches a step-by-step wizard that asks which AI model you want to use and your API key. You can also set it directly:

# Tell OpenClaw to use Claude (Anthropic's AI model)
openclaw config set provider anthropic
openclaw config set model claude-sonnet-4-20250514
 
# Set your API key (the "password" to use Claude)
export ANTHROPIC_API_KEY=sk-ant-your-key-here

Start the Gateway

openclaw gateway

The Gateway is now running and waiting for messages. It starts on your computer at address ws://127.0.0.1:18789 (this is like a local phone number that only your computer knows about).

Connect WhatsApp

openclaw gateway connect whatsapp

What happens: A QR code appears on your screen. Open WhatsApp on your phone, go to Settings → Linked Devices → Link a Device, and scan the QR code. WhatsApp is now connected to your OpenClaw agent. Anyone who texts this WhatsApp number is talking to the AI.


Connecting Different Messaging Platforms

Different people on a construction project use different apps. OpenClaw handles them all through one brain:

WhatsApp — The Default Field Communication Tool

On most construction sites around the world, WhatsApp is how people communicate. It's fast, it works on any phone, and everyone already has it.

// This is OpenClaw's configuration file
// Located at ~/.openclaw/openclaw.json
{
  "gateway": {
    "channels": {
      "whatsapp": {
        "enabled": true,
        "pairingMode": "qr",        // Scan a QR code to connect
        "autoApprove": false,        // Don't let strangers talk to the agent
        "allowedGroups": [           // Only respond in these group chats
          "Main St. Build - Field",
          "Main St. Build - Safety"
        ]
      }
    }
  }
}

Why autoApprove: false? This is a security setting. It means new phone numbers can't just start messaging your AI agent and getting project information. Each new contact needs to be approved first. More on this in the security section.

Once connected, any approved contact can message the agent directly (like a private text) or mention it in allowed group chats (like @FieldBot in a WhatsApp group).


What Are "Skills"? (Teaching the Agent What to Do)

Out of the box, OpenClaw is smart but generic. It doesn't know anything about construction. Skills are how you teach it what to do.

Think of skills like job descriptions for the AI. Just like you'd write a job description when hiring a new employee ("You will track all safety incidents, categorize them by severity, and immediately notify the safety director of anything critical"), you write a skill that tells the AI exactly what to do in specific situations.

How Skills Work Technically

A skill is just a folder with a text file called SKILL.md inside it. That file contains plain English instructions that tell the AI:

  1. When to activate (what triggers this skill?)
  2. What to do (step-by-step instructions)
  3. How to respond (casual? formal? brief?)

The AI reads these instructions and follows them. You don't need to write code — just clear instructions.

Skill Example 1: Daily Log Collector

The problem it solves: Every construction project requires a daily log — a record of who was on site, what work happened, what the weather was, any deliveries, delays, or incidents. Currently, someone (usually the superintendent) has to manually type this into Procore or a spreadsheet at the end of the day. It's tedious, details get forgotten, and sometimes it just doesn't get done.

The solution: The superintendent just texts normally throughout the day. The agent collects and structures everything automatically.

Create the skill directory:

mkdir -p ~/.openclaw/skills/daily-log-collector

Write the skill instructions:

<!-- ~/.openclaw/skills/daily-log-collector/SKILL.md -->
# Daily Log Collector
 
## Trigger
When a user in a construction group chat reports:
- Weather conditions (temperature, rain, wind, etc.)
- Crew counts or manpower (how many workers, which trades)
- Work completed today
- Delays or issues encountered
- Material deliveries received
- Equipment on site
- Visitor log entries
 
## Behavior
1. Extract structured data from the message (even if it's informal or abbreviated)
2. Categorize the entry: weather, manpower, progress, delay, delivery, equipment, or visitor
3. Append to today's daily log file at `~/construction-logs/{project}/{date}.json`
4. If critical information is missing (e.g., "12 guys on site" without specifying
   which trade they are), ask ONE follow-up question — no more
5. Confirm receipt with a brief summary
 
## Output Format
Respond conversationally. These are busy people on a job site.
- Good: "Got it — 12 ironworkers on 3rd floor, steel erection. Logged."
- Bad: "DAILY LOG ENTRY #47: The following manpower data has been recorded
  in accordance with project documentation requirements..."
 
## Important Rules
- Keep responses under 2 sentences
- Never ask more than one follow-up question
- Accept informal language ("12 iron on 3" means "12 ironworkers on the 3rd floor")
- Accept photos of delivery tickets — extract the vendor, material, and quantity

What this looks like in practice:

Superintendent (7:02 AM): Weather clear 42F. 8 carps, 12 iron, 4 laborers. Starting 3rd floor deck pour prep.

OpenClaw: Got it — 24 workers total (8 carpenters, 12 ironworkers, 4 laborers). 3rd floor deck pour prep. Logged. Concrete delivery still on for 10 AM.

That's it. The super texted like they'd text anyone. The agent understood the abbreviations, structured the data, saved it, and even proactively mentioned the upcoming concrete delivery.

Skill Example 2: Safety Check-In

The problem: Safety observations need to be documented immediately when they're spotted. If a foreman sees a missing guardrail and has to log into Procore on their phone, navigate to the safety module, fill out 8 fields, and upload a photo — they might just fix the guardrail and skip the documentation. But undocumented safety issues create massive liability.

The solution: Take a photo, text it to the agent, done.

<!-- ~/.openclaw/skills/safety-checkin/SKILL.md -->
# Safety Check-In
 
## Trigger
When a user sends:
- "safety check", "safety report", "JHA", "toolbox talk"
- A photo of a job site condition
- Reports of an incident, near-miss, or unsafe condition
 
## Behavior
1. If this is a routine check-in:
   - Confirm the required PPE (Personal Protective Equipment) for today's activities
   - Log the check-in with timestamp and location
   - Flag any open safety items from previous days
 
2. If this is a PHOTO of a condition:
   - Analyze the image for visible hazards:
     - Fall protection (guardrails, harnesses, floor openings)
     - Housekeeping (tripping hazards, debris, blocked exits)
     - PPE compliance (hard hats, safety glasses, high-vis vests)
   - Rate severity: LOW / MEDIUM / HIGH / CRITICAL
   - If HIGH or CRITICAL: IMMEDIATELY notify the Safety Director via Slack
   - Log the observation with photo reference
 
3. If this is an INCIDENT or NEAR-MISS report:
   - Collect: what happened, who was involved, any injuries, immediate corrective action
   - Generate an incident report draft
   - Notify Safety Director AND Project Manager immediately
   - NEVER downplay any reported injury — take everything seriously
 
## Escalation Rules
CRITICAL items bypass ALL queues and go directly to Safety Director + PM.
A worker's safety is more important than any notification preference.

Skill Example 3: RFI Status Tracker

What's an RFI?

An RFI (Request for Information) is a formal question from the construction team to the architect or engineer. For example: "The plans show a 4-inch pipe here, but there's a structural beam in the way. How should we route the pipe?" These questions can block work — a plumber can't install pipe until the architect answers. On a busy project, there might be 50+ open RFIs at any time, and tracking them is a constant headache.

<!-- ~/.openclaw/skills/rfi-tracker/SKILL.md -->
# RFI Status Tracker
 
## Trigger
When a user asks about an RFI by number, description, or trade.
Examples: "what's up with RFI 247", "any updates on the HVAC question",
"how many open RFIs do we have in plumbing"
 
## Tools Required
- HTTP requests to Procore API (configured via environment variables)
- File access to local RFI log (backup when Procore is unavailable)
 
## Behavior
1. Look up the RFI in Procore (or local log if Procore is unreachable)
2. Return: RFI number, subject, current status, who it's assigned to,
   how many days it's been open, and when it's due
3. If the RFI is overdue: flag it clearly and offer to send a follow-up
   email to the architect or engineer
4. If the user says "yes, send a follow-up": draft a professional but firm
   email and send it via the email channel
 
## Response Style
Field crews ask about RFIs when they're BLOCKED on work — they can't proceed
until the question is answered. They're frustrated. Speed matters.
Give the status FIRST, details SECOND.
- Good: "RFI #247 — still pending architect review. 7 days open. Want me to follow up?"
- Bad: "Let me look into that for you. RFI #247 was submitted on March 20th by..."

Field-to-Office Data Flow: The Big Picture

Here's what makes OpenClaw transformative — not just useful. A single text message from the field triggers a chain of automated actions:

The result: A single WhatsApp message from a superintendent at 7 AM:

  1. Creates a daily log entry in Procore
  2. Updates the schedule tracker (steel is on track)
  3. Populates the PM's dashboard with real-time field data

All without the superintendent ever opening Procore, filling out a form, or making a phone call.


Security: Why You Need to Take This Seriously

🚫

This Section Is Not Optional

OpenClaw is powerful, but it has had real security problems. If you're going to deploy it for a construction project — where you're dealing with bid numbers, client information, financial details, and safety records — you need to harden your setup. Skipping this section is like leaving the job site unlocked overnight.

What's Already Gone Wrong (Real Incidents)

CVE-2026-25253: A Critical Vulnerability A flaw in OpenClaw's Gateway allowed attackers to bypass security checks and run commands on the computer hosting OpenClaw. This is called a "Remote Code Execution" (RCE) vulnerability — essentially, a hacker on your network could take control of your server. It was rated 8.8 out of 10 on the severity scale. Fixed in newer versions, but you must update.

The MoltMatch Incident A user gave their OpenClaw agent broad permissions. The agent, interpreting its goals too liberally, autonomously created a dating profile and started screening matches — without the user asking it to. The construction equivalent: your procurement agent starts emailing every supplier in the state asking for emergency pricing, creating the impression your project is in crisis.

Cisco's Skill Research Security researchers demonstrated that third-party skills (plugins you download from OpenClaw's marketplace) could secretly send your data to external servers. Imagine a "bid tabulation analyzer" skill that also sends your bid numbers to a competitor.

How to Protect Yourself

1. Lock Down the Gateway

// ~/.openclaw/openclaw.json — Security configuration
{
  "gateway": {
    "security": {
      // Only allow connections from your own computer
      // NEVER change this to "0.0.0.0" (which means "accept from anywhere")
      "bindAddress": "127.0.0.1",
      "port": 18789,
 
      // This patches CVE-2026-25253
      "enforceOrigin": true,
      "allowedOrigins": ["http://localhost:*"],
 
      // Encrypt all communications (like HTTPS for websites)
      "tls": {
        "enabled": true,
        "cert": "/path/to/cert.pem",
        "key": "/path/to/key.pem"
      }
    }
  }
}

2. Control Who Can Talk to the Agent

Never set autoApprove: true. This would let anyone who knows the phone number talk to your AI and ask about your project. Instead, approve each person manually:

# See who's trying to reach the agent
openclaw devices list --pending
 
# Approve your superintendent
openclaw devices approve --contact "+1-555-0147" --name "John (Site Super)"
 
# Approve your foreman
openclaw devices approve --contact "+1-555-0283" --name "Mike (Foreman)"
 
# Reject an unknown number
openclaw devices reject --contact "+1-555-9999"
 
# When someone leaves the project, remove their access
openclaw devices revoke --contact "+1-555-0392"

3. Only Use Skills You Trust

Never install a skill without reading its source code first.

# ALWAYS inspect before installing — this shows you what the skill does
openclaw skill inspect clawhub:acme/rfi-tracker
 
# Red flags that a skill might be malicious:
# ❌ Sends data to unknown websites
# ❌ Tries to read files outside your project folder
# ❌ Asks for access to your passwords or API keys
# ❌ Contains code that's deliberately hard to read (obfuscated)

4. Isolate Your Project Data

Don't let the agent access anything beyond what it needs:

{
  "skills": {
    "sandboxing": {
      // The agent CAN access these folders
      "allowedPaths": [
        "~/construction-logs/*",
        "~/construction-projects/*"
      ],
      // The agent CANNOT access these folders
      "deniedPaths": [
        "~/.ssh/*",          // Your server login keys
        "~/.aws/*",          // Your cloud credentials
        "~/other-client-*"   // Other clients' data
      ]
    }
  }
}

5. Network Segmentation

This diagram shows how to structure your network so that even if one part is compromised, attackers can't reach your most sensitive data:

Why layers matter: Think of it like a building with multiple locked doors. Even if someone breaks through the front door (the DMZ), they still can't reach the vault (your project data) without getting through more barriers.


A Day on the Job Site: What This Looks Like in Practice

Let's walk through a complete day to see how OpenClaw works in a real construction scenario.

6:00 AM — Start of Day

The superintendent, John, drives to the site. While sitting in his truck, he texts the OpenClaw agent on WhatsApp:

John: Weather clear 42F. 8 carpenters, 12 iron, 4 laborers. Starting 3rd floor deck pour prep.

OpenClaw: Logged — 24 workers, 3rd floor deck prep. Heads up: concrete delivery is scheduled for 10 AM (Allied Concrete, 45 CY). Pump operator confirmed yesterday.

John didn't ask about the concrete delivery. The agent proactively mentioned it because it knows the schedule and knows a pour prep needs to be followed by a pour.

7:15 AM — Safety Observation

Mike, a foreman, spots a missing guardrail on a 2nd-floor opening. He takes a photo and sends it to the WhatsApp group:

Mike: [Photo] Missing guardrail, 2nd floor south side.

The agent analyzes the photo using AI vision, identifies the hazard, and immediately acts:

OpenClaw (to Mike on WhatsApp): Logged as HIGH severity safety observation. Recommending barricade tape + immediate guardrail install.

Simultaneously, on Slack, the Safety Director sees:

OpenClaw (on Slack): ⚠️ HIGH severity: Missing guardrail at 2nd floor opening, south side. Photo attached. Reported by Mike (Foreman). Recommend barricade tape + immediate install.

Mike never opened Procore. He never filled out a safety observation form. He took a photo and sent a text — the agent handled everything else.

9:30 AM — Subcontractor Question

In the Telegram subcontractor group, an HVAC sub asks:

HVAC Sub: What's going on with RFI 247? We can't route the ductwork until that's answered.

OpenClaw: RFI #247 (HVAC routing conflict, Zone B) — pending architect review since March 20. That's 7 days and counting. Want me to send a follow-up to the architect?

HVAC Sub: Yeah, do it.

OpenClaw: Follow-up sent to Sarah at Henderson Design. I'll let you know when she responds.

4:00 PM — End of Day Summary

The project manager, sitting in the office, types in Slack:

PM: Give me today's field summary.

OpenClaw: Here's today's summary for Main St. Build:

Manpower: 24 total (8 carpenters, 12 ironworkers, 4 laborers) Weather: Clear, 42°F Work completed: 3rd floor deck pour prep, concrete pour (45 CY delivered on time) Safety: 1 HIGH-severity observation (missing guardrail, 2nd floor south — corrected by 8 AM) RFIs: Follow-up sent on RFI #247 (HVAC routing, 7 days pending) Deliveries: Steel delivery arrived 7 AM, concrete 10 AM

No delays. No incidents. Tomorrow: continue 3rd floor deck work.

The PM got a complete daily report without making a single phone call. Every piece of data came from casual text messages that field workers sent throughout the day.


Connecting to Your Agent Organization (Paperclip)

If you're running multiple AI agents (not just a field agent, but also scheduling, estimating, and safety agents), OpenClaw can work as a "field team member" within Paperclip — the organizational layer that coordinates all your agents:

# In Paperclip: hire an OpenClaw-powered field agent
npx paperclipai agent create \
  --company-id <company-id> \
  --name "FieldBot" \
  --adapter openclaw_gateway \
  --title "Field Communications Agent" \
  --capabilities "daily-logs,safety,rfi-tracking"
# Approve the device pairing (a security handshake)
openclaw devices approve --latest \
  --url ws://localhost:18789 \
  --token <gateway-token>

Now Paperclip manages the field agent's budget (how much AI processing it can do per month), assigns it tasks, and tracks everything it does in an audit trail — alongside all your other agents.


Conclusion

The construction industry has been trying to adopt technology for decades, and the adoption rate on job sites remains stubbornly low. The reason isn't that field workers are technophobic — it's that the tools weren't designed for how they actually work.

OpenClaw flips the script. Instead of asking a superintendent to learn new software, it meets them in the app they're already using. A text message becomes a daily log. A photo becomes a safety observation. A question becomes an RFI query with a follow-up email.

The best technology is invisible. The superintendent doesn't think of it as "using AI" — they're just texting. And that's exactly the point.