clawdis

Configuration 🔧

CLAWDIS uses a JSON configuration file at ~/.clawdis/clawdis.json.

Minimal Config

{
  "inbound": {
    "allowFrom": ["+15555550123"],
    "reply": {
      "mode": "command",
      "command": ["tau", ""]
    }
  }
}

Full Configuration

{
  "logging": {
    "level": "info",
    "file": "/tmp/clawdis/clawdis.log"
  },
  "inbound": {
    "allowFrom": [
      "+15555550123",
      "+447700900123"
    ],
    "groupChat": {
      "requireMention": true,
      "mentionPatterns": [
        "@clawd",
        "clawdbot",
        "clawd"
      ],
      "historyLimit": 50
    },
    "timestampPrefix": "Europe/London",
    "reply": {
      "mode": "command",
      "agent": {
        "kind": "pi",
        "format": "json",
        "model": "claude-opus-4-5",
        "contextTokens": 200000
      },
      "cwd": "/Users/you/clawd",
      "command": [
        "tau",
        "--mode", "json",
        ""
      ],
      "session": {
        "scope": "per-sender",
        "idleMinutes": 10080,
        "sessionIntro": "You are Clawd. Be a good lobster."
      },
      "heartbeatMinutes": 10,
      "heartbeatBody": "HEARTBEAT",
      "timeoutSeconds": 1800
    }
  }
}

Configuration Options

`logging`

Key	Type	Default	Description
`level`	string	`"info"`	Log level: trace, debug, info, warn, error
`file`	string	`/tmp/clawdis/clawdis.log`	Log file path

`inbound.allowFrom`

Array of E.164 phone numbers allowed to trigger the AI. Use ["*"] to allow everyone (dangerous!).

"allowFrom": ["+15555550123", "+447700900123"]

`inbound.groupChat`

Key	Type	Default	Description
`requireMention`	boolean	`true`	Only respond when mentioned
`mentionPatterns`	string[]	`[]`	Regex patterns that trigger response
`historyLimit`	number	`50`	Max messages to include as context

`inbound.reply`

Key	Type	Description
`mode`	string	`"command"` for CLI agents
`command`	string[]	Command and args. Use `` for message
`cwd`	string	Working directory for the agent
`timeoutSeconds`	number	Max time for agent to respond
`heartbeatMinutes`	number	Interval for heartbeat pings
`heartbeatBody`	string	Message sent on heartbeat
`agent.kind`	string	Only `"pi"` is supported
`agent.model`	string	Optional model name to annotate sessions (defaults to `claude-opus-4-5`)
`agent.contextTokens`	number	Optional context window size; used for session token % reporting (defaults to ~200,000 for Opus 4.5)

Quick start: If you omit inbound.reply, CLAWDIS falls back to the bundled @mariozechner/pi-coding-agent with --mode rpc, per-sender sessions, and a 200k-token window. No extra install or config needed to get a reply.

Template Variables

Use these in your command:

Variable	Description
``	Full message body
``	Message without mention
``	Sender phone number
``	Current session UUID

Session Configuration

"session": {
  "scope": "per-sender",
  "resetTriggers": ["/new"],
  "idleMinutes": 10080,
  "sessionIntro": "You are Clawd.",
  "sessionArgNew": ["--session", ".jsonl"],
  "sessionArgResume": ["--session", ".jsonl", "--continue"]
}

Key	Type	Description
`scope`	string	`"per-sender"` or `"global"`
`resetTriggers`	string[]	Messages that start a new session
`idleMinutes`	number	Session timeout
`sessionIntro`	string	System prompt for new sessions

Environment Variables

Some settings can also be set via environment:

export CLAWDIS_LOG_LEVEL=debug
export CLAWDIS_CONFIG_PATH=~/.clawdis/clawdis.json

Migrating from Warelay

If you’re upgrading from the old clawdis name:

# Move config
mv ~/.clawdis ~/.clawdis
mv ~/.clawdis/clawdis.json ~/.clawdis/clawdis.json

# Update any hardcoded paths in your config
sed -i '' 's/clawdis/clawdis/g' ~/.clawdis/clawdis.json

Next: Agent Integration 🦞

This site is open source. Improve this page.