Clawdbot汉化版开源可部署：完全免费+本地存储聊天记录+自主模型替换方案
Clawdbot汉化版开源可部署：完全免费+本地存储聊天记录+自主模型替换方案
Clawdbot汉化版不仅完成了全界面中文化，更关键的是新增了企业微信入口——这意味着你不再需要切换平台，就能在最熟悉的办公环境中，随时调用属于你自己的AI助手。它不是另一个云端SaaS服务，而是一套真正“装进你电脑里”的智能对话系统：所有数据留在本地，所有模型由你掌控，所有功能开箱即用。
Clawdbot就是一个你可以随时跟AI对话的智能助手，就像ChatGPT一样，但是：
在微信里就能用（同时原生支持WhatsApp、Telegram、Discord等主流通讯工具）
完全免费（不收订阅费、不设用量限制，只依赖你本地运行的AI模型）
数据隐私（所有聊天记录、会话历史、配置信息全部存储在你自己的设备上，不上传、不联网、不共享）
24小时在线（设置开机自启后，无需人工干预，断电重启后自动恢复服务）
网关令牌为 dev-test-token，开箱即用，无需额外申请。
1. 什么是Clawdbot？
1.1 不是另一个“AI网页”，而是一个“能说话的本地程序”
Clawdbot的本质，是一个运行在你本地电脑或服务器上的轻量级AI网关程序。它不依赖任何外部API密钥，也不把你的问题发往远程大厂服务器。当你在微信里问“帮我写个周报”，这句话不会离开你的内网；AI生成的回复，也直接从你本机的Ollama模型中实时计算出来——整个过程像打开一个计算器一样私密、可控、零延迟。
它解决了三个真实痛点：
- 怕隐私泄露？聊天记录全存在
/root/.clawdbot/agents/main/sessions/下，用ls就能看到，用cat就能读，连加密都不用，因为本来就不需要防外人。 - 怕用不起？不用买Token、不用充会员，只要你的机器能跑起Qwen2:0.5b（2GB显存或8GB内存即可），它就永远免费。
- 怕被封号？所有通讯协议都是本地桥接：微信走企业微信官方SDK，WhatsApp用官方Web端协议模拟，Telegram/Discord用Bot API直连——不黑产、不逆向、不违规，稳定如本地软件。
1.2 汉化版的核心升级点
相比原版英文界面，汉化版不只是翻译文字，而是做了深度适配：
- 全路径提示、错误日志、配置文件注释全部中文输出，排查问题时不再需要查词典；
- 企业微信入口独立配置项，支持扫码绑定、消息接收、群聊@响应、已读回执等完整工作流；
- 命令行提示语优化，比如
node dist/index.js agent --message "你好"执行后，终端直接显示「AI已回复：你好！今天想聊点什么？」而非原始JSON； - 配置文件
.clawdbot/clawdbot.json中关键字段（如auth.token、agents.defaults.model.primary）均附带中文注释，改配置像填表格一样简单。
2. 第一次使用
2.1 检查服务是否正在运行
打开终端，输入以下命令查看进程：
ps aux | grep clawdbot 如果看到类似输出，说明服务已在后台运行：
root 133175 0.8 2.1 1245678 172345 ? Ssl 10:23 0:15 node dist/index.js gateway 注意：clawdbot-gateway 进程名代表核心网关已启动，这是所有通讯渠道（微信、WhatsApp等）的统一入口。如果没有运行，请执行一键启动脚本：
bash /root/start-clawdbot.sh 该脚本会自动检查依赖、加载配置、启动网关，并将日志输出到 /tmp/clawdbot-gateway.log。
2.2 三步验证AI是否正常工作
不需要打开微信或网页，直接在终端完成首次对话测试：
cd /root/clawdbot node dist/index.js agent --agent main --message "你好，我是第一次使用" 正常响应示例：
「你好！我是你的本地AI助手，很高兴认识你。我可以帮你写文案、查资料、写代码，或者只是陪你聊聊天。需要我做什么？」
❌ 若报错 Error: Cannot find module 'ollama'，说明Ollama未安装，请先执行 curl -fsSL https://ollama.com/install.sh | sh；
❌ 若报错 connect ECONNREFUSED 127.0.0.1:11434，说明Ollama服务未启动，请运行 ollama serve 后再试。
3. 如何跟AI助手对话
3.1 终端直连：最透明、最可控的交互方式
这是理解Clawdbot底层逻辑的最佳入口。所有参数都明明白白，没有隐藏设置：
基础问答（适合快速验证）
# 问天气 node dist/index.js agent --agent main --message "北京今天最高气温多少度？" # 写Python脚本 node dist/index.js agent --agent main --message "写一个脚本，把当前目录下所有.jpg文件重命名为日期+序号，比如20240520_001.jpg" # 总结长文本 node dist/index.js agent --agent main --message "总结以下内容：[粘贴一段技术文档]" 控制AI“思考强度”（比调温度更直观）
Clawdbot把推理过程拆解成可感知的档位，不用纠结temperature=0.7这种抽象参数：
# 极简模式：秒回，适合闲聊/确认类问题 node dist/index.js agent --agent main --message "1+1等于几" --thinking minimal # 平衡模式：默认档位，兼顾速度与质量 node dist/index.js agent --agent main --message "解释Transformer架构" --thinking medium # 深度模式：允许AI分步推理、自我验证，适合编程/设计/写作 node dist/index.js agent --agent main --message "设计一个支持离线使用的笔记App，包含同步冲突解决机制" --thinking high 获取结构化结果（给程序员的贴心设计）
当你要把AI输出喂给其他程序时，JSON格式省去所有解析成本：
node dist/index.js agent --agent main --message "列出中国五大一线城市及GDP（单位：万亿元）" --json 输出直接是标准JSON数组，可被jq、Python json.loads()等工具无缝处理。
3.2 微信/WhatsApp/Telegram：把AI装进日常通讯工具
这才是Clawdbot最惊艳的落地场景——让AI成为你通讯录里的“第200个好友”。
企业微信接入（汉化版专属）
- 打开企业微信管理后台 → 应用管理 → 自建应用 → 创建应用（记下AgentId和Secret）
- 回到终端，按提示依次输入CorpId、AgentId、Secret、Token、EncodingAESKey
- 扫码授权后，Clawdbot会自动创建一个“AI小助手”应用，员工在企业微信工作台点击即可发起对话
在Clawdbot目录执行：
cd /root/clawdbot node dist/index.js workwechat pair 优势：支持单聊、群聊@响应、消息已读状态、文件上传解析（PDF/Word/Excel），且全程走企业微信官方API，合规无风险。
WhatsApp快速配对（无需手机卡）
node dist/index.js whatsapp pair 终端会生成一个二维码。用手机WhatsApp → 设置 → 关联设备 → 扫描即可。注意：此方式使用WhatsApp Web协议，不占用手机流量，不需SIM卡，一台服务器可同时挂载多个WhatsApp账号。
Telegram Bot全自动部署
node dist/index.js telegram pair 执行后会引导你：
- 在Telegram中搜索
@BotFather→ 发送/newbot→ 命名机器人 → 获得token - 将token粘贴到终端 → 自动完成Webhook注册
- 在Telegram中搜索你的机器人名称，发送
/start即可开始对话
小技巧：给Bot设置头像和简介，员工一眼就知道这是公司AI助手，不是个人玩具。
3.3 网页控制台：可视化调试与临时会话
对于不熟悉命令行的用户，网页界面是友好入口：
- 浏览器访问
http://你的服务器IP:18789 - 输入令牌
dev-test-token（首次登录后可修改） - 在输入框直接打字，支持多轮上下文、历史记录回溯、模型切换
网页端特别适合：给同事演示AI能力（不用教命令行）调试多轮对话逻辑（左侧显示完整session ID和时间戳）快速切换不同模型对比效果（下拉菜单实时生效）
4. 连接微信/WhatsApp/Telegram
4.1 企业微信：专为企业场景优化的深度集成
Clawdbot汉化版的企业微信支持远超基础消息收发：
| 功能 | 说明 | 使用示例 |
|---|---|---|
| 群聊智能响应 | 在部门群中@AI助手，自动识别提问并回复，不干扰其他人 | @AI小助手 帮我汇总上周所有项目进度 |
| 文件内容解析 | 支持上传PDF/Word/Excel，AI自动提取关键信息 | 上传《Q2销售报表.xlsx》→ 总结前三名销售员业绩 |
| 消息模板推送 | 预设模板，定时向指定成员/部门推送通知 | 每日晨会提醒：今日站会9:00，地点会议室A |
| 会话持久化 | 同一用户的多次对话自动归入同一session，记忆上下文 | 用户问“上个月销量多少”，AI能准确关联到之前查询的“2024年4月” |
配置完成后，在企业微信管理后台的「应用」列表中，你会看到名为“Clawdbot AI助手”的应用图标，点击即可进入配置页管理权限。
4.2 WhatsApp：零门槛个人助理
不同于需要商业资质的WhatsApp Business API，Clawdbot采用无头浏览器协议，普通手机号即可启用：
- 无需认证：跳过Meta官方审核流程
- 免维护：扫码一次，长期有效（除非手机主动退出）
- 多账号：通过
--profile参数可同时运行多个WhatsApp实例，分别服务不同团队
实际使用中，你甚至可以把它当成“永不掉线的私人秘书”：
- 把家人微信消息自动转发到WhatsApp，AI帮你润色后再发回去；
- 接收客户询盘，AI自动分类并转交对应销售；
- 扫描纸质合同，AI提取条款并高亮风险点。
4.3 Telegram：开发者最爱的灵活通道
Telegram Bot的优势在于其开放生态：
- 可通过
/setcommands自定义指令，比如/summary用于总结、/code用于写代码； - 支持Inline模式，在任意聊天中输入
@yourbot hello即时获得回复； - 完整支持Markdown和HTML格式输出，代码块、表格、链接全部原样渲染。
5. 常用问题解决
5.1 服务无法启动？先看这三步
| 现象 | 快速诊断命令 | 解决方案 |
|---|---|---|
command not found: node | which node | 安装Node.js：`curl -fsSL https://deb.nodesource.com/setup_lts.x |
Error: Cannot connect to Ollama | ollama list | 启动Ollama：systemctl start ollama 或 ollama serve |
EACCES: permission denied | ls -l /root/.clawdbot | 修复权限：chown -R root:root /root/.clawdbot |
5.2 AI回复慢？不是模型不行，是选错了“档位”
Clawdbot的响应速度主要取决于两个变量：模型大小 + 思考模式。别急着换模型，先试试调整--thinking：
| 场景 | 推荐命令 | 效果 |
|---|---|---|
| 查快递单号、问会议时间 | --thinking minimal | 响应<2秒，适合高频轻量交互 |
| 写邮件、改文案、查资料 | --thinking medium | 响应3–8秒，质量稳定 |
| 设计系统、写算法、分析财报 | --thinking high | 响应15–60秒，但输出结构清晰、步骤完整 |
实测数据：在8GB内存的Intel i5服务器上，qwen2:1.5b+--thinking medium平均响应4.2秒；换成--thinking low后降至1.8秒，质量损失可忽略。
5.3 聊天记录在哪？如何备份？
所有数据都在你掌控之中：
- 会话记录：
/root/.clawdbot/agents/main/sessions/下按日期分文件夹，每个JSON文件记录一次完整对话 - 系统日志：
/tmp/clawdbot-gateway.log实时记录所有请求与错误
配置备份：一键打包全部数据：
tar -czf clawdbot-full-backup-$(date +%Y%m%d_%H%M%S).tar.gz \ /root/.clawdbot \ /root/clawd \ /root/start-clawdbot.sh \ /root/restart-gateway.sh 5.4 想换个AI性格？改一个文件就够了
Clawdbot把AI“人设”抽离成独立文件，修改后无需重启：
nano /root/clawd/IDENTITY.md 文件内容示例：
- Name: 小智 - Role: 技术支持工程师 - Vibe: 专业、简洁、带点幽默感 - Rules: - 不虚构信息，不确定时回答“我需要查证” - 代码必须可运行，附带环境说明 - 拒绝政治、宗教、成人话题 - Avatar: /root/clawd/avatars/tech.png 保存后，下次对话AI就会以新身份出现。你甚至可以为销售、HR、客服团队分别配置不同人设。
6. 更新和升级
6.1 程序本体更新（保持功能最新）
推荐使用Git方式，确保获取全部汉化补丁：
cd /root/clawdbot git pull origin main pnpm install pnpm build bash /root/restart-gateway.sh 注意：pnpm是Clawdbot官方构建工具，比npm更快更省空间。若未安装，执行curl -fsSL https://get.pnpm.io/install.sh | sh -s -- pnpm。
6.2 AI模型热替换（不中断服务）
Clawdbot支持运行时切换模型，无需停机：
# 查看当前模型 cat /root/.clawdbot/clawdbot.json | jq '.agents.defaults.model.primary' # 切换为更轻量的模型（适合低配服务器） node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b # 切换为更强力的模型（需GPU） node dist/index.js config set agents.defaults.model.primary ollama/llama3.1:8b # 立即生效（无需重启） node dist/index.js agent --agent main --message "模型已切换，现在用的是llama3.1:8b" 6.3 企业微信配置更新（适配新版API）
当企业微信发布新接口时，Clawdbot会通过config update命令推送适配：
node dist/index.js config update workwechat 该命令会自动下载最新SDK、校验签名密钥、刷新AccessToken，全程无人值守。
7. 高级技巧
7.1 终端快捷命令：让AI像Linux命令一样顺手
把常用操作封装成alias，效率翻倍：
echo '# Clawdbot快捷命令' >> ~/.bashrc echo 'alias ai="cd /root/clawdbot && node dist/index.js agent --agent main --message"' >> ~/.bashrc echo 'alias aicode="cd /root/clawdbot && node dist/index.js agent --agent main --message \"\${1}\" --thinking high --json"' >> ~/.bashrc source ~/.bashrc 之后只需：
ai "今天有什么新闻？"aicode "写一个Python函数，计算斐波那契数列前20项"
7.2 定时任务：让AI成为你的数字员工
用crontab实现自动化服务：
# 每天早9点，自动向总监微信发送日报 0 9 * * * cd /root/clawdbot && node dist/index.js agent --agent main --message "生成今日工作日报" --deliver --reply-channel workwechat --to "zongjian" # 每周一上午10点，自动检查所有模型状态 0 10 * * 1 cd /root/clawdbot && node dist/index.js health check > /tmp/clawdbot-health.log 2>&1 7.3 多轮对话进阶：让AI真正“记住你”
Clawdbot提供两种记忆机制：
隐式用户识别：基于通讯渠道ID自动关联（微信OpenID、WhatsApp号码、Telegram用户ID）
# 第一次对话 node dist/index.js agent --agent main --to "+8613800138000" --message "我叫李四" # 后续任意时间，只要用同一号码发消息，AI都会记得“李四” 显式Session ID：适合需要严格隔离的场景（如客服工单）
SESSION_ID=$(uuidgen) node dist/index.js agent --agent main --session-id $SESSION_ID --message "我的订单号是#12345" node dist/index.js agent --agent main --session-id $SESSION_ID --message "查下这个订单物流" 8. 总结
Clawdbot汉化版不是一个“又要学的新工具”，而是一把为你量身打造的AI钥匙：
它把复杂的AI能力，锁进了你最常用的通讯工具里——微信、WhatsApp、Telegram，打开就能用；
它把数据主权，还给了你——聊天记录在本地硬盘，模型在你服务器，连日志都用中文写；
它把控制权，交到了你手上——换模型、改人设、调速度、设定时，全靠几行命令，没有黑盒，没有套路。
你不需要成为AI专家，也能拥有一个24小时待命、懂你业务、守你秘密的智能助手。真正的AI自由，不是选择哪家云服务，而是选择——让AI，住在你自己的地盘上。
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 ZEEKLOG星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。
