# NOC — Not OpenClaw

Telegram bot that bridges messages to local `claude` CLI sessions — chat with Claude directly from Telegram.

```
User → Telegram → noc bot → claude --resume → stream back → Telegram
```

~600 lines of Rust. One binary. One config file. Does the thing.

## Why "Not OpenClaw"?

[OpenClaw](https://openclaw.io) is an open-source AI agent framework with admirable ambitions. It supports 20+ messaging platforms, 35+ LLM providers, a hub-and-spoke gateway (Node.js), an agent runtime (separate language, naturally), a three-tier skills override system, built-in RAG pipelines, multi-agent routing, cron scheduling, browser automation, and voice wake-word detection. It has 400,000+ lines of code, 1,800+ open issues, and requires at least 1 GB of RAM to breathe. The official docs recommend a $600 Mac mini as a minimum viable host. Cold-start on a modest CPU: ~500 seconds. Security researchers have called it "a security nightmare dressed up as a daydream."

To be fair, if you need to orchestrate 47 Telegram bots across 12 LLM backends with a RAG pipeline and overnight autonomous tasks, OpenClaw is probably fine.

Most people just want to talk to Claude on their phone.

NOC is for those people.

## How it works

1. User sends a message to the bot
2. First message must be the auth passphrase, otherwise the bot replies "not authenticated"
3. Once authenticated, messages are piped to `claude --resume <session_id>` via stdin
4. `claude` stdout is streamed back as the reply (message is edited live as tokens arrive)
5. Files uploaded to the bot are forwarded to Claude; files Claude writes to the output dir are sent back
6. Sessions are scoped per chat and refresh daily at a configurable hour (default: 5am)

Session IDs are deterministic — generated with UUIDv5 from `(chat_id, date)`, format: `noc-{chat_id}-{YYYYMMDD}`.

## Setup

```bash
cp config.example.yaml config.yaml
# fill in your values
```

### Config

| Key | Description |
|-----|-------------|
| `tg.key` | Telegram bot token |
| `auth.passphrase` | Passphrase required to authenticate each session |
| `session.refresh_hour` | Hour (local time, 24h) when sessions reset (default: `5`) |

## Deploy

### Local

```bash
make deploy
```

Builds the release binary and installs a `systemd --user` service.

### Remote (hera)

```bash
make deploy-hera
```

Builds locally, copies the binary and config to `heradev`, then starts the service there.

## Logs

```bash
journalctl --user -u noc -f
```

## Tech stack

| Layer | Technology |
|-------|-----------|
| Language | Rust (2021 edition) |
| Telegram | teloxide 0.12 |
| Async runtime | tokio (full) |
| Config | YAML + serde |
| Deployment | systemd user service + Makefile |

## Roadmap

- [ ] Streaming responses — edit message as output arrives
- [ ] Markdown formatting — MarkdownV2 rendering
- [ ] Timeout handling — kill claude if it hangs
- [ ] Graceful shutdown on SIGTERM
- [ ] `/reset` command — force new session without waiting for daily refresh
- [ ] Rate limiting per chat
- [ ] Voice message support — STT (whisper.cpp) → text → claude
- [ ] Video/audio transcription