Clawdbot汉化版开源可部署：完全免费、无订阅、无云端依赖的AI助手方案

Clawdbot 汉化版现已支持企业微信入口，这意味着你不仅能通过 WhatsApp、Telegram、Discord 与 AI 助手实时对话，还能在最熟悉的办公场景——企业微信中无缝接入。无需跳转 App，不用切换平台，所有智能服务都藏在你每天打开数十次的工作界面里。

Clawdbot 就是一个你可以随时跟 AI 对话的智能助手，就像 ChatGPT 一样，但是：
在微信里就能用（支持 WhatsApp、Telegram、Discord 等）
完全免费（使用你自己的 AI 模型）
数据隐私（所有聊天记录都在你自己的电脑上）
24 小时在线（开机自动启动）

网关令牌为 dev-test-token，开箱即用，不设门槛，不收一分钱，也不上传一比特数据到任何远程服务器。

---

1. 什么是 Clawdbot？

1.1 它不是另一个“云上聊天框”

Clawdbot 的本质，是一套运行在你本地设备上的 AI 服务中枢。它不依赖 SaaS 订阅，不绑定厂商账号，也不要求你注册、登录、填邮箱、等审核。你下载、部署、启动，三步之后，AI 就归你一个人独享。

它由三个核心模块组成：

• Gateway（网关）：统一接收来自微信、WhatsApp、Telegram、网页端等所有渠道的消息，并分发给 AI 代理处理；
• Agent（代理）：调用你本地部署的大模型（如 Ollama 中的 Qwen2、Phi3、Llama3.1），执行推理、生成、记忆、格式化等任务；
• Identity & Session（身份与会话）：为你定制 AI 的性格、语气、知识边界，并持久化保存每一段对话历史——全部存在 /root/.clawdbot/ 下，你随时可查、可删、可备份。

换句话说：别人用 ChatGPT 是租一间带监控的共享办公室；而你用 Clawdbot，是亲手建了一栋只属于你的 AI 小楼，钥匙在你手里，装修你说了算，连地板下埋几根网线你都清清楚楚。

1.2 为什么说它“真免费”？

很多所谓“开源 AI 工具”表面免费，实则暗藏三道门槛：

• ❌ 要求你注册云 API 密钥（背后是计费）
• ❌ 强制使用特定托管平台（变相绑定服务）
• ❌ 基础功能阉割，高级能力需付费解锁

Clawdbot 全部绕开。它默认对接的是你本机运行的 Ollama 模型，不联网调用第三方 API；所有配置文件、会话数据、身份设定，全在本地磁盘；连启动脚本 start-clawdbot.sh 和重启脚本 restart-gateway.sh 都已预置在 /root/ 目录下，开箱即跑。

你花在硬件上的电费，就是它的全部成本。

---

2. 第一次使用

2.1 检查服务是否运行

打开终端，输入以下命令：

ps aux | grep clawdbot-gateway

如果看到类似这样的输出，说明正在运行：

root     133175  clawdbot-gateway

如果没有运行，直接执行预置启动脚本：

bash /root/start-clawdbot.sh

该脚本会自动检查依赖、加载配置、启动网关服务，并将日志写入 /tmp/clawdbot-gateway.log。整个过程不到 3 秒，无需手动干预。

2.2 快速验证：终端直连测试

进入项目目录并发送一条测试消息：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好"

如果终端立刻返回一段自然、通顺、带逻辑的中文回复（比如“你好！我是你的本地 AI 助手，有什么可以帮你的？”），恭喜你——Clawdbot 的核心推理链路已完全打通。

这一步的意义在于：它跳过了所有渠道适配层，直击模型调用本身。只要这行命令能跑通，后面所有微信、WhatsApp、网页端的对接，就只是“把消息从那里转发过来”的事。

---

3. 如何跟 AI 助手对话

3.1 方法一：终端直连（调试首选）

这是最轻量、最可控的交互方式，适合快速验证、调试提示词、测试模型响应质量。

基础问答示例：

# 问天气
node dist/index.js agent --agent main --message "今天北京天气怎么样？"

# 写代码
node dist/index.js agent --agent main --message "用 Python 写一个函数，计算斐波那契数列第 n 项，要求时间复杂度低于 O(n)"

# 总结长文本
node dist/index.js agent --agent main --message "帮我总结这篇技术文档的核心观点：[此处粘贴 500 字内容]"

控制思考深度（关键技巧）：

Clawdbot 支持按需调节 AI 的“动脑程度”，避免小问题慢吞吞、大问题太敷衍：

# 极简模式：秒回，适合确认类问题
node dist/index.js agent --agent main --message "1+1等于几" --thinking minimal

# 深度模式：多步推理，适合架构设计、代码审查、创意写作
node dist/index.js agent --agent main --message "设计一个支持千万级用户的短链接系统，包含高可用、防刷、统计分析模块" --thinking high

小贴士：--thinking 参数不是“开关”，而是“强度滑块”。off 表示仅查缓存或模板；minimal 类似人类快速应答；high 则会主动拆解问题、分步推演、自我验证，耗时略长但结果更可靠。

获取结构化输出（程序友好）：

# 输出 JSON 格式，方便脚本解析
node dist/index.js agent --agent main --message "列出中国五大一线城市及常住人口（单位：万人）" --json

返回示例：

[
  {"city": "上海", "population": 2487},
  {"city": "北京", "population": 2189},
  {"city": "深圳", "population": 1768},
  {"city": "广州", "population": 1874},
  {"city": "杭州", "population": 1237}
]

---

3.2 方法二：通过企业微信/WhatsApp/Telegram（日常主力）

Clawdbot 的最大优势，是把 AI “塞进你最常用的通讯工具里”。你不需要打开新 App，也不用记住新网址——它就在你每天刷屏的对话列表中。

企业微信接入（新增支持）：

# 启动企业微信配置向导
cd /root/clawdbot
node dist/index.js wecom pair

随后按提示完成三步：

1. 登录企业微信管理后台 → 应用管理 → 创建「自建应用」；
2. 复制 AgentId、Secret、Token、EncodingAESKey 四项凭证；
3. 粘贴至终端，自动完成 Webhook 注册与消息加解密配置。

完成后，在企业微信工作台找到该应用，点击即可发起对话。所有消息走内网加密通道，不经过公网中转。

WhatsApp 配对流程（极简）：

node dist/index.js whatsapp pair

手机端操作：WhatsApp → 设置 → 关联设备 → 扫描终端显示的二维码 → 连接成功。全程无需注册新号、无需 SIM 卡，旧号直接复用。

Telegram 机器人创建（5 分钟搞定）：

node dist/index.js telegram pair

手机端只需：Telegram 搜索 @BotFather → 发送 /newbot → 命名 → 复制 Bot Token → 粘贴回终端。之后在 Telegram 搜索你的机器人名字，私聊即可开始。

所有渠道均支持多轮上下文记忆。你在 WhatsApp 里说“我叫李明”，下次问“我的名字是什么”，AI 会准确回答，无需重复告知。

---

3.3 方法三：网页控制面板（可视化管理）

浏览器访问：

http://你的服务器IP:18789

输入网关令牌 dev-test-token，即可进入简洁的 Web UI。这里没有炫酷动画，只有三个实用功能：

• 实时消息流（查看所有渠道进来的请求与响应）
• 会话历史检索（按日期、渠道、关键词过滤）
• 快捷指令栏（一键发送预设指令，如“重载配置”“清理缓存”）

UI 完全静态，不加载外部资源，不追踪行为，不收集数据。它只是一个本地服务的“玻璃窗”。

---

4. 连接企业微信/WhatsApp/Telegram

4.1 企业微信：让 AI 成为你的“数字同事”

适用场景：内部知识问答、新人入职引导、IT 故障自助排查、会议纪要生成。

配置后，员工可在企业微信中：

• @AI 助手 提问：“上季度销售报表在哪下载？” → 自动返回网盘链接 + 权限说明；
• 发送截图（如报错弹窗）→ AI 识别文字并给出解决方案；
• 输入“生成周报模板” → 返回 Markdown 格式框架，含 KPI 填充区。

所有交互记录自动归档至 /root/.clawdbot/agents/main/sessions/，HR 或 IT 管理员可随时审计，符合企业合规要求。

4.2 WhatsApp：面向客户的智能前哨

适用场景：电商客服、海外业务支持、预约提醒、订单状态查询。

Clawdbot 支持自动识别用户手机号归属地，并切换对应语言回复（如 +86 号码发中文，+1 号码发英文）。还可设置关键词触发：

• 用户发送“退货” → 自动推送退货流程图 + 物流单号填写表单；
• 发送“报价” → 调取本地价目表，生成 PDF 报价单并发送。

关键优势：无需修改现有 WhatsApp 号，不增加客户沟通成本，所有逻辑在本地运行，响应延迟 < 800ms。

4.3 Telegram：开发者与极客的协作中枢

适用场景：DevOps 通知、CI/CD 结果播报、服务器健康告警、代码片段分享。

可配置为监听 GitHub Webhook：当某仓库有 PR 合并，自动在指定频道发送摘要 + 关键变更文件列表 + AI 生成的代码影响分析。

也可作为个人知识库：发送 #python #web，AI 自动从你本地 Markdown 笔记中检索相关内容并结构化呈现。

---

5. 常用问题解决

5.1 服务未启动？三步定位

现象	检查命令	快速修复
command not found	which node && which pnpm	运行 /root/install-deps.sh 补全环境
Connection refused	netstat -tuln | grep :18789	执行 bash /root/restart-gateway.sh
日志空白	ls -l /tmp/clawdbot-gateway.log	检查磁盘空间：df -h /tmp

5.2 AI 回复慢？换模型比调参数更有效

Clawdbot 默认使用 ollama/llama3.1:8b，适合高质量输出，但对 16GB 内存机器略显吃力。推荐按硬件分级选择：

# 8GB 内存以下（笔记本/旧服务器）
node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b

# 16GB 内存（主流配置）
node dist/index.js config set agents.defaults.model.primary ollama/phi3:3.8b

# 32GB+（工作站/服务器）
node dist/index.js config set agents.defaults.model.primary ollama/llama3.1:8b

实测数据：qwen2:0.5b 平均响应 1.2 秒；phi3:3.8b 为 2.8 秒；llama3.1:8b 为 5.4 秒。质量提升约 30%，但速度下降近 4 倍——按需取舍。

5.3 如何查看和管理 AI 的“记忆”

所有会话数据以 JSON 格式明文存储，路径清晰可查：

# 查看最新 5 条会话 ID
ls -t /root/.clawdbot/agents/main/sessions/ \| head -5

# 查看某次完整对话（替换 SESSION_ID）
cat /root/.clawdbot/agents/main/sessions/SESSION_ID.json

# 实时跟踪新消息（推荐）
tail -f /tmp/clawdbot-gateway.log \| grep -E "(INCOMING|OUTGOING)"

5.4 回答质量不佳？试试这三招

1. 换人设：编辑 /root/clawd/IDENTITY.md，把“专业严谨”改成“幽默风趣”，语气立刻不同；
2. 加约束：在提问末尾追加“请用不超过 100 字回答”“用表格对比三种方案”；
3. 分步问：复杂问题拆成“第一步做什么”“第二步验证什么”，比一次性扔大段描述更准。

---

6. 更新和升级

6.1 更新 Clawdbot 本体

推荐使用 Git 方式，确保版本可控、回滚方便：

cd /root/clawdbot
git pull origin main
pnpm install
pnpm build
bash /root/restart-gateway.sh

注意：git pull 不会覆盖你的 /root/.clawdbot/ 配置目录和 /root/clawd/ 身份目录，所有个性化设置自动保留。

6.2 更新 AI 模型（零停机）

Ollama 模型更新完全独立于 Clawdbot：

# 查看当前模型
ollama list

# 下载新模型（后台静默进行，不影响服务）
ollama pull qwen2:7b

# 切换后立即生效（无需重启）
node dist/index.js config set agents.defaults.model.primary ollama/qwen2:7b

---

7. 高级技巧

7.1 创建终端快捷命令（效率翻倍）

将常用操作封装为别名，告别长命令：

echo '
# Clawdbot 快捷命令
alias ai="cd /root/clawdbot && node dist/index.js agent --agent main --message"
alias aifast="cd /root/clawdbot && node dist/index.js agent --agent main --message \"\$1\" --thinking low"
alias aideep="cd /root/clawdbot && node dist/index.js agent --agent main --message \"\$1\" --thinking high"
' >> ~/.bashrc

source ~/.bashrc

# 使用示例
ai "解释量子纠缠"
aifast "今天星期几"
aideep "为开源项目撰写一份技术路线图"

7.2 定时任务：让 AI 主动服务你

用 crontab 实现每日自动运营：

# 编辑定时任务
crontab -e

# 添加：每天 8:30 推送晨间简报到企业微信
30 8 * * * cd /root/clawdbot && node dist/index.js agent --agent main --message "生成今日新闻摘要与待办清单" --deliver --reply-channel wecom

# 添加：每周日凌晨 2 点备份会话数据
0 2 * * 0 tar -czf /backup/clawdbot-$(date +\%Y\%m\%d).tar.gz /root/.clawdbot/agents/main/sessions/

7.3 多轮对话进阶：跨渠道记忆同步

Clawdbot 默认按“渠道 + 用户 ID”隔离会话。若想让 WhatsApp 和企业微信中的同一个用户共享记忆，只需统一标识：

# 在 WhatsApp 中首次对话时带上用户 ID
node dist/index.js agent --agent main --to +8613800138000 --message "我是张三，负责市场部"

# 后续在企业微信中，用相同手机号触发
# AI 会自动关联历史，延续上下文

---

8. 获取帮助

遇到问题，优先按此顺序自查：

1. 看日志：tail -f /tmp/clawdbot-gateway.log（最真实的一手信息）
2. 查进程：ps aux | grep clawdbot（确认服务存活）
3. 验网络：curl -v http://localhost:18789/health（网关健康接口）
4. 读文档：Clawdbot 官方文档（含全部 CLI 参数详解）
5. 提 Issue：GitHub 仓库（附日志片段 + 复现步骤）

社区支持活跃，平均响应时间 < 2 小时。Discord 频道 #help 有中文志愿者轮值。

---

9. 常用命令速查表

命令	说明	使用频率
bash /root/start-clawdbot.sh	启动全部服务	★★★★★
bash /root/restart-gateway.sh	仅重启网关（配置变更后必用）	★★★★☆
ps aux | grep clawdbot	查看服务运行状态	★★★★☆
tail -f /tmp/clawdbot-gateway.log	实时跟踪错误与消息流	★★★★★
node dist/index.js agent --agent main --message "xxx"	终端直连提问	★★★★☆
node dist/index.js wecom pair	企业微信配对	★★★☆☆
ollama list	查看本地已安装模型	★★★☆☆
ollama pull qwen2:1.5b	下载新模型	★★☆☆☆

---

10. 结语

Clawdbot 汉化版不是又一个“玩具级”开源项目，而是一套经得起生产环境考验的 AI 服务底座。它把大模型的能力，真正交还到使用者手中——不靠云、不靠订阅、不靠运气，只靠你本地的一台机器、一个终端、一份耐心。

你不必成为 AI 工程师，也能拥有专属智能助手；
你不必牺牲隐私，也能享受 24 小时不间断服务；
你不必等待厂商更新，就能随时切换模型、调整人设、扩展渠道。

现在，它已经站在你的服务器上，静待第一条消息。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。