agent-chat

Files (38)

• CHANGELOG.md
• README.md
• SKILL.md
• cli.mjs
• default.json · config/
• daemon.mjs
• package.json
• setup-identity.mjs
• agent.mjs · src/
• bridge.mjs · src/
• consent.mjs · src/
• groups.mjs · src/
• health.mjs · src/
• identity.mjs · src/
• index.mjs · src/
• paths.mjs · src/
• payer.mjs · src/
• peers.mjs · src/
• router.mjs · src/
• com.everclaw.agent-chat.plist · templates/launchd/
• everclaw-agent-chat.service · templates/systemd/
• consent-attacks.test.mjs · test/adversarial/
• router-attacks.test.mjs · test/adversarial/
• v02-attacks.test.mjs · test/adversarial/
• setup-test-env.mjs · test/fixtures/
• v6-messages.mjs · test/fixtures/
• middleware-chain.test.mjs · test/integration/
• bridge.test.mjs · test/unit/
• consent.test.mjs · test/unit/
• groups.test.mjs · test/unit/
• health.test.mjs · test/unit/
• identity.test.mjs · test/unit/
• paths.test.mjs · test/unit/
• payer.test.mjs · test/unit/
• peers-v02.test.mjs · test/unit/
• peers.test.mjs · test/unit/
• router-v02.test.mjs · test/unit/
• router.test.mjs · test/unit/

SKILL.md (first lines)

# agent-chat

XMTP real-time agent-to-agent and user-to-agent messaging for EverClaw.

## Overview

Always-on daemon providing E2E-encrypted messaging via XMTP's MLS protocol. Runs as a separate process managed by launchd (macOS) or systemd (Linux), communicating with OpenClaw through a filesystem bridge.

## Version

0.2.0

## Dependencies

- `@xmtp/agent-sdk` ^2.3.0
- `xmtp-comms-guard` ^6.0.0 (peer)
- Node.js >= 20.0.0

## Quick Start

```bash
# 1. Generate XMTP identity (one-time)
node skills/agent-chat/setup-identity.mjs

# 2. Install daemon as system service
bash scripts/setup-agent-chat.sh

# 3. Check status
bash scripts/setup-agent-chat.sh --status
```

## Daemon Management

The `setup-agent-chat.sh` script installs the XMTP daemon as a persistent system service.

### Commands

```bash
# Install and start daemon (auto-detects OS)
bash scripts/setup-agent-chat.sh

# Check daemon status
bash scripts/setup-agent-chat.sh --status

# View recent logs
bash scripts/setup-agent-chat.sh --logs

# Restart daemon
bash scripts/setup-agent-chat.sh --restart

# Uninstall daemon
bash scripts/setup-agent-chat.sh --uninstall

# Install without starting
bash scripts/setup-agent-chat.sh --skip-start
```

### Platform Support

| Platform | Service Manager | Location | Logs |
|----------|----------------|----------|------|
| macOS | launchd | `~/Library/LaunchAgents/com.everclaw.agent-chat.plist` | `~/.everclaw/logs/agent-chat.*` |
| Linux | systemd (user) | `~/.config/systemd/user/everclaw-agent-chat.service` | `journalctl --user -u everclaw-agent-chat` |

**Note:** Linux uses user-level systemd (no sudo required). All services run as your user account.

### Manual Commands

**macOS (launchd):**
```bash
# Check if loaded
launchctl list | grep everclaw

# View logs
tail -f ~/.everclaw/logs/agent-chat.log

# Stop/start
launchctl bootout gui/$(id -u)/com.everclaw.agent-chat
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.everclaw.agent-chat.plist
```

**Linux (systemd):**
```bash
# Check status
systemctl --user status everclaw-agent-chat

# View logs
journalctl --user -u everclaw-agent-chat -f

# Stop/start
systemctl --user stop everclaw-agent-chat
systemctl --user start everclaw-agent-chat
```

## Architecture

- **Process model**: Separate always-on daemon (not in-process with OpenClaw)
- **IPC**: Filesystem bridge (`~/.everclaw/xmtp/outbox/` → `inbox/`)
- **Message format**: V6 JSON inside XMTP text content type
- **Consent**: Configurable per-agent (`open`/`handshake`/`strict`)
- **Middleware chain**: Consent → CommsGuard V6 → Router

## Identity Model

Two-tier:
- **28 flavor canonical wallets** — project-controlled, `open` consent
- **Per-user wallets** — generated at install, `handshake` consent

XMTP wallet is messaging-only — no funds. Separate from MOR staking wallet.

## CLI Reference

```bash
# Identity status
node skills/agent-chat/cli.mjs status

# Daemon health
node skills/agent-chat/cli.mjs health

From profbernardoj/androidclaw.org, MIT.