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. 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 ## How it works
1. User sends a message to the bot 1. User sends a message to the bot
2. First message must be the auth passphrase, otherwise the bot replies "not authenticated" 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 3. Once authenticated, messages are piped to `claude --resume <session_id>` via stdin
4. `claude` stdout is sent back as the reply 4. `claude` stdout is streamed back as the reply (message is edited live as tokens arrive)
5. Sessions are scoped per chat and refresh daily at 5am local time 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 ## Setup
@@ -31,7 +44,7 @@ cp config.example.yaml config.yaml
make deploy 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 ## Logs