ClawdBot 简介
跨国团队沟通效率低、群聊消息看不懂?本文介绍如何快速部署 ClawdBot,实现本地 AI 翻译与多模态处理。它不是简单的文字翻译器,而是能听懂语音、看懂图片、查天气、换汇率的'多模态生活助理'。所有处理都在你自己的设备上完成,消息不上传、隐私不泄露。
1.1 核心能力
- 语音转写:使用 Whisper tiny 模型,支持实时转写中文/英文语音。
- :PaddleOCR 轻量版,离线识别截图、商品图、手写便签里的文字。
如何在本地通过 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