Send a task or message to an OpenClaw agent. Three modes:

• "async" (default): fire-and-forget via webhook. Returns immediately with accepted status. Supports delivery to Telegram.

• "sync": wait for agent reply via chat completions. Blocks until response.

• "spawn": tracked sub-agent delegation via /sessions_spawn. Returns runId + childSessionKey for observation. Routes to Tani (main), Alan (coding), or Rachel (rachel). Only call when the user has explicitly requested execution.

Multi-view agent observation. Consolidates health checks, session listings, activity monitoring, and log access into a single tool.

• "health": gateway reachability (~38ms)

• "sessions": all agent sessions with metadata from sessions.json + JSONL

• "actions": active processes, recently-modified sessions, recent tool calls, log tail

• "logs": gateway/command/heartbeat log scenarios

• "history": JSONL transcript read for a specific session

Control running agent sessions: abort stuck agents, steer them in a new direction, compact their context, or reset them. Uses the gateway /tools/invoke API. If the gateway does not support a given action, returns a clear error with CLI fallback instructions.

OpenClaw CLI operations: read/write config, run doctor, check version, restart instructions.

• "config_get": reads openclaw.json directly from filesystem (~16ms, no CLI overhead). Supports dot-paths like "agents.list[0].model".

• "config_set": writes via CLI over SSH (slower but safe — CLI handles validation and env var resolution).

• "doctor": runs openclaw doctor via SSH.

• "version": returns the installed OpenClaw version.

• "restart": returns manual restart instructions (gateway cannot be restarted remotely).

Read an entire file or a specific line range. Content comes back through JSON — no shell, no escaping issues. Use start_line / end_line for large files. Output is capped at 2000 lines.

Create or overwrite a file with the given content. Content goes through JSON parameters — never a shell — so there are no escaping or newline-stripping issues. Automatically creates parent directories if they do not exist. Use this for new files and full rewrites. For targeted edits to existing files, use file_edit instead.

Replace a unique string in a file with another string. old_str must match the raw file content exactly and appear exactly once. Use this instead of shell-based sed/python for all file edits — content goes through JSON parameters, never a shell, so there are no escaping issues.

Search for a literal string pattern in a file or recursively in a directory. Returns structured hits with surrounding context lines. Case-insensitive. Replaces grep -n. For regex searches, use shell_exec.

Execute arbitrary shell commands on the Termux device. Useful for direct filesystem inspection and diagnostics. Only call when the user has explicitly requested execution, or when diagnostics are clearly required for the task at hand. Do not use for speculative exploration or as a default first step.

Snapshot of Termux device health: RAM, CPU load, disk space, OpenClaw version, gateway reachability, and active OpenClaw/node processes. Fast and read-only — safe to call any time.