先说说为什么要玩 ZeroClaw Telegram 助手

说实话，市面上那点所谓“AI 小助手”大多是云端跑的，卡顿、隐私泄漏简直是常态。

ZeroClaw 用 Rust 写的，轻量、原生 Linux，配合 Landlock/Seatbelt 双层沙箱，安全感杠杠的。

而且，它直接支持 Telegram 频道和群聊，你在手机上随手敲几句指令，AI 就给你回答案。

哈哈，这不就是咱们老友聚会时的“点子”吗？想聊点技术，又不想打开网页，直接来一杯“Telegram 酱”。

准备工作：装 Rust、拉代码、搞环境变量

先确认系统里装了 Rustup，没装的话就去官网刷一遍，然后：

cargo install zeroclaw \
  --features "channel-telegram provider-anthropic memory-sqlite tool-shell"

装完以后你会kan到一个叫 zeroclaw 的二进制文件。

接下来把 Telegram Bot Token 放进环境变量——别直接写在配置里不然谁douNeng偷走。

export TG_BOT_TOKEN="你的机器人Token"

还有 Anthropic 的 API Key，也别硬写，ZeroClaw 自带加密存储：

zeroclaw secret set anthropic.api_key
# 粘贴你的 Key，然后回车

创建项目目录并初始化配置

咱们先把工作目录弄好：

mkdir -p ~/zeroclaw-demo && cd ~/zeroclaw-demo
zeroclaw init

这一步会自动生成一个 zeroclaw.toml 基础配置文件，你Ke以直接编辑它。

核心配置：让 ZeroClaw Neng在 Telegram 上跑起来

下面这段 TOML 配置是Zui小可运行版，记得根据自己的需求删改。

name        = "demo-bot"
system_prompt = "你是一个简洁、友好的技术助手。回答控制在 200 字以内。"
kind  = "anthropic"
model = "claude-sonnet--"
]
kind = "telegram"
# token 从环境变量读取，安全第一
token_env = "TG_BOT_TOKEN"
# 白名单聊天 ID，强烈建议配上
allowed_chats = 
kind = "sqlite"
path = "data/memory.db"
]
kind = "shell"
allow_commands = 
# 文件系统白名单，只允许访问 data 目录
allowed_paths = 
default_policy = "deny"

要点就在这里：

只打开了两个 shell 命令——date 和 uptime——防止被滥用。

默认拒绝其它工具和路径，安全感瞬间提升。

memory 用 SQLite 持久化对话记录，省事又靠谱。

把 ZeroClaw 包装成 systemd 服务，让它开机自启

想让它一直跑着？那就写个 systemd unit 吧。

Description=ZeroClaw demo bot
After=network-online.target
Type=simple
User=zeroclaw
WorkingDirectory=/home/zeroclaw/zeroclaw-demo
EnvironmentFile=/home/zeroclaw/zeroclaw-demo/.env
ExecStart=/usr/local/bin/zeroclaw run
Restart=on-failure
# 再加一层 sandbox
NoNewPrivileges=true
ProtectSystem=strict
ReadWritePaths=/home/zeroclaw/zeroclaw-demo/data
PrivateTmp=true
WantedBy=multi-user.target

保存到 /etc/systemd/system/zeroclaw.service 后：

systemctl daemon-reload
systemctl enable zeroclaw.service
systemctl start zeroclaw.service

不对不对，我忘了说要先把 .env 文件里写上 TG_BOT_TOKEN 环境变量，不然 bot 启动会报错。

启动后会kan到的日志样子

 zeroclaw v0.1.0 starting  
 sandbox: landlock enabled   
 provider: anthropic / claude-sonnet-- ready  
 channel: telegram polling started  
 memory: sqlite at ./data/memory.db  
 tools: allowed   
 policy: deny-by-default  
 agent loop ready  

然后打开 Telegram，给你的 Bot 发条 “现在几点”，它会调 /usr/bin/date, 把结果甩回去。

再来点花活：自定义指令和白名单聊天

Ru果你想让 Bot 在特定群里才响应，Ke以往 那块加个白名单：

allowed_chats = 

这样只有这两个 chat_id 会收到回复，其他人敲指令根本没反应——安全感再升一级。

P.S. 常见坑 & 小技巧

Pain Point: Linux 内核太老不支持 Landlock。解决办法是升级到至少 5.13 内核。害，这事儿真得提前检查下。

Pain Point: Telegram Token 写错了。别忘了在 .env 或者 export 时不要多加空格，不然报 “invalid token”。咱就是说多检查几遍再跑服务。

Pain Point: SQLite 权限问题。确保 data 目录对运行用户可写，否则 memory 初始化会炸掉。

TIPS: 调试时Ke以直接用 zeroclaw run --debug, 日志geng详细，好抓住细节。

TIPS: 想让 Bot 支持geng多 shell 命令？只要在 .allow_commands 增加路径即可，但记得保持 “deny-by-default”。你懂的，小心别给黑客打开后门。

Killer 应用案例：树莓派口袋 AI 助手

A 某开发者用了树莓派 Zero 2W + WM8960 麦克风扬声器模组 + PiSugar 电池，把 ZeroClaw 装进去，一台Neng放进口袋的私人 AI 助手就诞生了——成本才百来块钱！哈哈，这种玩意儿真的Neng把 AI 带进日常生活中去，好像把科幻搬到了厨房桌面上似的。

怎么玩？简单几步：

Cargo 编译交叉编译到 armv6；

SCP 把二进制传到树莓派；

Aurora 环境变量配好； Docker 不需要，用 systemd 就行； Lithium 电池保活两天以上，你Ke以随时喊 “Hey ZeroClaw”。 动手吧，你比想象中gengNeng搞定它！

说实话，这篇文章Yi经把从零到上线所有关键点dou抖落出来了。 别光kan着字，还得真动手敲几行代码。 ZeroClaw 的设计哲学就是“低门槛+高安全”， 只要你有 Rust 环境，有一点点 Linux 常识，就Neng把自己的 Telegram AI 助手拎回家。 哈哈，遇到问题先去仓库的 examples 对一下再去 GitHub issue 区kankan有没有类似报错。 不对不对，还有一点：记得定期geng新二进制和依赖库，保持安全补丁跟上。

Zui后祝你玩得开心， Ru果哪天你的 Bot Neng帮你抢票或者提醒喝水，那我真的算是成功啦！ 懂的dou懂，我就不多说啦。 祝好运~

---