ClawdBot 本地部署：零配置 Telegram AI 翻译机器人

小技巧：若你在远程服务器（如 VPS）上部署，无法直接访问 127.0.0.1，请改用 SSH 端口转发，然后本地浏览器打开 http://localhost:7860。

2.3 接受设备授权（仅首次需要）

首次访问控制台时，页面会显示'Pending device request'。这是因为 ClawdBot 采用设备信任机制，保障安全。

回到终端，执行：

docker exec -it clawdbot clawdbot devices list

复制 ID（如 d1a2b3c4），执行批准命令：

docker exec -it clawdbot clawdbot devices approve d1a2b3c4

刷新浏览器，控制台即可正常加载。

2.4 验证核心服务是否就绪

在控制台左上角，点击「Status」标签页，你会看到 Gateway、Models、Channels 状态均为 Running 或 Ready。同时，终端中执行 docker exec -it clawdbot clawdbot models list 应输出包含 vllm/Qwen3-4B-Instruct-2507 的表格。

3. 使用指南

ClawdBot 支持三种交互模式，全部免 Token、免认证、免关注。

3.1 私聊模式

1. 打开 Telegram App
2. 搜索用户名 @clawdbot（注意：是你本地部署的实例）
3. 点击「Start」或直接发送任意消息，例如：'今天北京天气怎么样？'、'请把这段话翻译成法语'。

3.2 群聊模式

在任意 Telegram 群中，只需输入 @clawdbot + 消息，例如：@clawdbot 请把这条消息翻译成日语。ClawdBot 默认启用'群聊只响应@'策略，不会监听全群消息。

3.3 快捷命令

4. 高级配置

4.1 切换更强大的翻译模型

ClawdBot 默认使用 LibreTranslate。你可以轻松切换为 Google Translate 提升质量：

1. 在 Web 控制台左侧导航栏，点击 Config → Models → Providers
2. 找到 google-translate 条目，将 enabled 设为 true
3. 在 apiKey 字段填入你的 Google Cloud Translation API Key

4.2 启用'阅后即焚'隐私模式

如果你处理的是敏感会议记录或客户资料，可开启消息自动清除：

1. 控制台进入 Config → Security
2. 开启 autoDeleteMessagesAfterSeconds，设为 300（5 分钟）
3. 开启 disableMessageHistory

4.3 自定义快捷词库

技术文档、公司产品名常被机器乱翻。ClawdBot 支持本地词典映射：

1. 编辑配置文件：~/.clawdbot/clawdbot.json
2. 在 agents.defaults.model 下添加翻译规则
3. 重启容器：docker restart clawdbot

5. 常见问题

5.1 '控制台打不开，一直显示 Loading'

• 检查：docker ps | grep clawdbot 是否显示 Up X minutes
• 若状态为 Restarting：执行 docker logs clawdbot，查找 OSError: [Errno 98] Address already in use —— 说明 7860 端口被占用，改用 -p 7861:7860

5.2 '发语音没反应，或识别错误率高'

Whisper tiny 模型对安静环境录音最友好。建议：使用耳机麦克风，避免环境噪音；说话速度放慢，每句≤15 秒。

5.3 '图片 OCR 识别不了中文/手写体'

PaddleOCR 轻量版默认优化英文印刷体。启用中文支持：

1. 进入 Config → OCR → Language
2. 勾选 ch（简体中文）和 en
3. 保存并重启容器

6. 总结

ClawdBot 极简、可靠且真实。没有一行配置代码，没有一次 API 申请，所有计算在本地，不依赖任何云服务 SLA。它是你构建个人 AI 工作流的起点。