README: explain the name, add a note about OpenClaw

This commit is contained in:
Fam Zheng
2026-04-07 13:00:17 +01:00
committed by 麻薯
parent 4d88e80f1c
commit 1f978b0691

View File

@@ -1,14 +1,27 @@
# NOC
# NOC — Not OpenClaw
Telegram bot that bridges messages to `claude` sessions.
~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 `ms --resume <session_id>` via stdin
4. `claude` stdout is sent back as the reply
5. Sessions are scoped per chat and refresh daily at 5am local time
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)
## Setup
@@ -31,7 +44,7 @@ cp config.example.yaml config.yaml
make deploy
```
This builds the release binary and installs a `systemd --user` service.
Builds the release binary and installs a `systemd --user` service. Remote deployment via `make deploy-hera`.
## Logs