如何在本地通过 Docker 一键部署 ClawdBot，打造零配置的 Telegram AI 翻译机器人。它支持语音转写、图文识别及核心翻译功能，所有处理在本地完成以保障隐私。教程涵盖安装启动、控制台验证、Telegram 交互模式（私聊/群聊）、快捷命令以及高级配置（如切换翻译模型、隐私模式）。适用于需要离线 AI 能力、保护数据隐私的个人或团队用户。
跨国团队沟通效率低、群聊消息看不懂？本文介绍如何快速部署 ClawdBot，实现本地 AI 翻译与多模态处理。它不是简单的文字翻译器，而是能听懂语音、看懂图片、查天气、换汇率的'多模态生活助理'。所有处理都在你自己的设备上完成，消息不上传、隐私不泄露。
所谓零配置，是指你不需要申请 Telegram Bot Token、配置反向代理、修改防火墙或编辑.env 文件。只需要一台能跑 Docker 的机器（Mac/Windows/Linux/树莓派均可），执行一条 docker run 命令即可。
| 问题类型 | 传统做法 | ClawdBot 方案 |
|---|---|---|
| 群聊消息乱码 | 手动复制→粘贴到网页翻译→再回帖 | 在 Telegram 群中@ClawdBot 或直接私聊发送消息 |
| 会议录音听不清 | 录音→导出→上传第三方→等转写→再翻译 | 发送语音消息给 ClawdBot → 自动转写 + 翻译成中文 |
| 截图问价/查参数 | 截图→OCR 工具识别→复制→翻译→搜索 | 直接发送图片给 ClawdBot → OCR 识别文字 → 翻译 → 自动调用维基/汇率/天气插件 |
请确保已安装 Docker（Docker Desktop 或 Linux apt install docker.io）。
打开终端（Mac/Linux）或 PowerShell（Windows），执行以下命令：
docker run -d \
--name clawdbot \
-p 7860:7860 \
-p 18780:18780 \
-v ~/.clawdbot:/app/workspace \
-v ~/.clawdbot:/root/.clawdbot \
--restart=unless-stopped \
ghcr.io/clawd-bot/clawdbot:latest
-d：后台运行-p 7860:7860：暴露 Web 控制台端口-p 18780:18780：暴露内部 WebSocket 网关（Telegram 连接用）-v：持久化保存配置、日志、模型缓存--restart=unless-stopped：开机自启启动后，立即执行：
docker logs clawdbot | grep "Dashboard URL"
你会看到类似输出：
Dashboard URL: http://127.0.0.1:7860/?token=abc123def456...
复制整条 URL，在浏览器中打开。如果提示'Connection refused'，说明容器还没完全就绪，请等待 10–20 秒后重试。
小技巧：若你在远程服务器（如 VPS）上部署，无法直接访问 127.0.0.1，请改用 SSH 端口转发，然后本地浏览器打开 http://localhost:7860。
首次访问控制台时，页面会显示'Pending device request'。这是因为 ClawdBot 采用设备信任机制，保障安全。
回到终端，执行：
docker exec -it clawdbot clawdbot devices list
复制 ID（如 d1a2b3c4），执行批准命令：
docker exec -it clawdbot clawdbot devices approve d1a2b3c4
刷新浏览器，控制台即可正常加载。
在控制台左上角，点击「Status」标签页，你会看到 Gateway、Models、Channels 状态均为 Running 或 Ready。同时，终端中执行 docker exec -it clawdbot clawdbot models list 应输出包含 vllm/Qwen3-4B-Instruct-2507 的表格。
ClawdBot 支持三种交互模式，全部免 Token、免认证、免关注。
在任意 Telegram 群中，只需输入 @clawdbot + 消息，例如：@clawdbot 请把这条消息翻译成日语。ClawdBot 默认启用'群聊只响应@'策略，不会监听全群消息。
| 命令 | 示例 | 返回内容 |
|---|---|---|
/weather 北京 | 查询实时天气与预报 | 温度、湿度、风速、空气质量 |
/fx 100 USD to CNY | 实时汇率换算 | 精确到小数点后 4 位 |
/wiki Transformer | 维基百科摘要 | 自动提取词条首段 |
/help | 查看全部命令列表 | 带说明的可交互菜单 |
ClawdBot 默认使用 LibreTranslate。你可以轻松切换为 Google Translate 提升质量：
google-translate 条目，将 enabled 设为 trueapiKey 字段填入你的 Google Cloud Translation API Key如果你处理的是敏感会议记录或客户资料，可开启消息自动清除：
autoDeleteMessagesAfterSeconds，设为 300（5 分钟）disableMessageHistory技术文档、公司产品名常被机器乱翻。ClawdBot 支持本地词典映射：
~/.clawdbot/clawdbot.jsonagents.defaults.model 下添加翻译规则docker restart clawdbotdocker ps | grep clawdbot 是否显示 Up X minutesRestarting：执行 docker logs clawdbot，查找 OSError: [Errno 98] Address already in use —— 说明 7860 端口被占用，改用 -p 7861:7860Whisper tiny 模型对安静环境录音最友好。建议：使用耳机麦克风，避免环境噪音；说话速度放慢，每句≤15 秒。
PaddleOCR 轻量版默认优化英文印刷体。启用中文支持：
ch（简体中文）和 enClawdBot 极简、可靠且真实。没有一行配置代码，没有一次 API 申请，所有计算在本地，不依赖任何云服务 SLA。它是你构建个人 AI 工作流的起点。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online