零基础教程：用Clawdbot在微信/WhatsApp搭建免费AI聊天机器人

你是否想过，不用打开网页、不用下载App，直接在微信里就能和一个懂技术、会写作、能编程的AI助手实时对话？不是用别人的服务器，而是完全跑在你自己的电脑上——所有聊天记录只存在你的硬盘里，24小时开机即用，还不花一分钱。

Clawdbot 就是这样一个工具。它不是另一个“AI SaaS平台”，而是一个真正属于你自己的本地AI网关：支持微信（通过企业微信入口）、WhatsApp、Telegram、Discord，对接你本地运行的大模型（比如 Ollama 中的 Qwen2、Phi3、Llama3），全程离线、零订阅、无云端推理。

更重要的是，它已经为你汉化完毕，还特别增加了企业微信入口支持——这意味着你可以把它部署在公司内网，让团队成员在企业微信中直接调用AI能力，无需跳转、不泄露数据、不依赖外部API。

这篇教程专为零基础用户设计。不需要你会写代码，不需要你懂服务器运维，只要你会用终端输入几条命令，就能在30分钟内，把AI助手请进你的微信对话框。

1. Clawdbot 是什么？一句话说清本质

Clawdbot 的核心定位，是一个「消息协议翻译器 + 本地AI调度中心」。

它不自己训练模型，也不提供算力，而是像一位精通多国语言的智能管家：

• 你发一条微信消息 → 它读懂你的文字 → 转成标准格式 → 交给本地大模型推理 → 把结果翻译成微信能理解的语言 → 再原路送回给你
• 同样的流程，也适用于 WhatsApp 扫码配对、Telegram 机器人、Discord 斜杠指令，甚至网页控制台

它有四个不可替代的优势，我们用最直白的方式解释：

在微信里就能用
不是“微信小程序”或“公众号H5页面”，而是真正在微信个人聊天窗口中收发消息——就像和真人朋友聊天一样自然。企业微信版本已预置，开箱即用。

完全免费
不收月费、不设用量上限、不强制绑定信用卡。你只需一台能跑Ollama的电脑（Mac/Windows/Linux均可，甚至树莓派4B也能跑Qwen2:0.5b），所有模型都由你自己下载、自己管理。

数据隐私可控
所有对话内容、历史记录、配置文件，全部存储在 /root/.clawdbot 这个本地目录下。没有一行数据离开你的设备。你可以随时 ls -l /root/.clawdbot/agents/main/sessions/ 查看原始JSON会话文件。

24小时在线
只要电脑开机，Clawdbot 就自动启动、后台常驻。断电重启后，它会随系统自启——你不需要每次手动敲命令，更不用守着终端窗口。

划重点：这不是一个“玩具项目”。它的底层基于 Node.js + Express + WebSocket 构建网关服务，通过 clawdbot-gateway 进程统一管理所有消息通道；AI推理层则通过标准 API 调用本地 Ollama 或 Llama.cpp 服务，架构清晰、扩展性强。但你完全不需要理解这些——就像你不需要懂发动机原理，也能开车。

2. 第一步：确认服务已在运行（30秒检查）

Clawdbot 镜像已为你预装好全部依赖，包括 Ollama、Node.js、pnpm 和启动脚本。你唯一要做的，就是确认服务进程是否就绪。

打开你的终端（Mac/Linux 用 Terminal，Windows 用 WSL2 或 PowerShell），输入：

ps aux | grep clawdbot-gateway

如果看到类似这样的输出，说明服务正在后台安静运行：

root     133175  0.8  2.1 1245678 89234 ?    Ssl  10:23   0:04 node /root/clawdbot/dist/index.js gateway

恭喜，你已跳过最难的环境配置环节。

如果没看到任何含 clawdbot-gateway 的行，说明服务未启动。此时只需执行一句命令：

bash /root/start-clawdbot.sh

你会看到终端快速滚动几行日志，最后停在 Gateway server listening on port 18789 —— 这表示网关已成功启动。

小贴士：这个脚本会自动检查 Ollama 是否运行、模型是否存在，并确保所有路径权限正确。它比手动 node dist/index.js gateway 更健壮，是日常首选启动方式。

3. 第二步：用终端快速测试AI是否“在线”

在微信里聊天前，先用最简单的方式验证AI核心能力是否正常。这一步只需要一条命令，3秒出结果。

进入 Clawdbot 根目录并发送测试消息：

cd /root/clawdbot
node dist/index.js agent --agent main --message "你好，我是第一次使用Clawdbot"

几秒钟后，你应该看到类似这样的回复：

{"response":"你好！很高兴认识你～我是你的本地AI助手，所有对话都在你自己的电脑上完成，完全私密。需要我帮你写文案、查资料、写代码，还是整理会议纪要？😊"}

回复出现，说明：

• 本地模型（默认是 ollama/qwen2:1.5b）已加载成功
• AI推理链路畅通
• 基础文本生成能力可用

你还可以立刻试几个实用场景，感受它的能力边界：

# 让它写一段朋友圈文案（带emoji）
node dist/index.js agent --agent main --message "帮我写一条关于周末咖啡馆探店的朋友圈，轻松幽默，带2个emoji"

# 让它解释一个技术概念（用小白能懂的话）
node dist/index.js agent --agent main --message "用初中生能听懂的话，解释什么是‘神经网络’"

# 让它生成一个Python小工具
node dist/index.js agent --agent main --message "写一个Python脚本，读取当前目录下所有.txt文件，统计每行字数，输出到summary.csv"

你会发现，它不是机械复读机，而是能理解上下文、保持风格、按需生成结构化内容的真正助手。

4. 第三步：连接微信（含企业微信入口）——最推荐的方式

Clawdbot 支持多种通讯平台，但对国内用户而言，微信（尤其是企业微信）是最自然、最安全、最易落地的选择。镜像已内置企业微信适配模块，无需额外配置OAuth或回调域名。

4.1 企业微信配置（3分钟完成）

企业微信入口意味着：你的同事无需安装新App，直接在企业微信工作台点击图标，即可与AI对话。所有消息走企业微信官方通道，合规、可审计、可管理。

操作步骤如下：

1. 登录企业微信管理后台（https://work.weixin.qq.com/）
2. 进入【应用管理】→【自建应用】→ 点击右上角【创建应用】
3. 填写应用名称（例如：“内部AI助手”）、应用简介，点击创建
4. 创建成功后，记下页面显示的 AgentId（一串数字）和 Secret（一长串字母数字组合）
5. 在Clawdbot终端中执行配置命令：

cd /root/clawdbot
node dist/index.js wecom config --agent-id 1000028 --secret "your_app_secret_here" --corpid "ww14e290b54b64a74d"

注意：corpid 是你企业微信的ID（在【我的企业】页面可见），--agent-id 和 --secret 来自第4步。命令中引号必须保留。

6. 启动企业微信网关：

node dist/index.js wecom start

你会看到提示：WeCom gateway started. QR code generated at /root/clawdbot/qrcode.png
7. 用企业微信手机端扫码：打开企业微信 → 点击工作台 → 右上角【+】→【扫一扫】→ 扫描服务器上的二维码（或用 cat /root/clawdbot/qrcode.png 查看路径，用SSH工具下载后扫码）
8. 授权完成后，在企业微信工作台找到你创建的应用图标，点击进入——一个干净的聊天界面就出现了。发送“你好”，AI将立即回复。

4.2 个人微信/WhatsApp（备用方案）

如果你暂时没有企业微信权限，WhatsApp 是第二选择，体验同样流畅：

cd /root/clawdbot
node dist/index.js whatsapp pair

终端会生成一个二维码。此时：

• 打开手机 WhatsApp → 点击右上角三个点 → 【关联设备】
• 对准电脑屏幕上的二维码扫描
• 等待几秒，看到 Connected! 即表示绑定成功

之后，你可以在 WhatsApp 中直接给自己的账号（或任意联系人）发消息，AI会自动回复。例如：

你：总结一下《三体》第一部的核心思想
AI：《三体》第一部以“科学边界”组织的离奇死亡事件为引子……（完整回答约200字）

你：把上面的回答缩成30字以内
AI：人类文明在宇宙中并非唯一，黑暗森林法则揭示了文明间猜疑链与技术爆炸带来的生存危机。

这种连续对话能力，正是 Clawdbot 的核心价值——它不是单次问答工具，而是能记住上下文、支持多轮交互的智能伙伴。

5. 第四步：开始真正有用的对话（不止于“你好”）

Clawdbot 的强大，在于它把复杂的AI能力，封装成简单可调的参数。你不需要改代码，只需在命令中加几个选项，就能获得截然不同的效果。

5.1 控制AI的“思考深度”——让快与准兼得

不同问题需要不同级别的思考。Clawdbot 提供 --thinking 参数，从 off 到 high 共5档：

思考级别	适用场景	响应速度	示例命令
off	简单事实查询（如“北京天气”）	<1秒	--thinking off
minimal	日常闲聊、简单指令	1~2秒	--thinking minimal
low	写邮件、列清单、翻译	2~4秒	--thinking low
medium	分析数据、写短文、调试代码	4~8秒	--thinking medium
high	设计系统、创作故事、复杂推理	8~20秒	--thinking high

实战建议：

• 给老板写汇报？用 --thinking high，确保逻辑严密、重点突出
• 快速查一个单词意思？用 --thinking off，秒回不等待
• 日常办公中，--thinking low 是最佳平衡点，响应快且质量稳

# 用低思考模式快速生成日报标题
node dist/index.js agent --agent main --message "生成5个关于AI落地的日报标题" --thinking low

# 用高思考模式深度分析一份产品需求文档
node dist/index.js agent --agent main --message "分析这份PRD中的三个关键风险点：[粘贴PRD摘要]" --thinking high

5.2 获取结构化输出——让AI结果直接进Excel或数据库

当AI返回 JSON 格式时，你可以用脚本一键处理，无需人工复制粘贴：

# 让AI列出10个Python常用库及其用途，返回JSON
node dist/index.js agent --agent main --message "列出10个Python最常用的数据科学库，每个包含name和description字段" --json

# 输出示例（真实可解析）：
# [
#   {"name": "pandas", "description": "提供高性能、易用的数据结构和数据分析工具"},
#   {"name": "numpy", "description": "支持大型多维数组和矩阵运算的基础包"},
#   ...
# ]

把这个命令嵌入你的自动化脚本，就能每天定时生成技术选型报告、竞品功能对比表等。

5.3 自定义AI“人设”——让它成为你的专属助手

Clawdbot 允许你用 Markdown 文件定义AI的性格、知识范围和表达风格。编辑这个文件：

nano /root/clawd/IDENTITY.md

修改内容为：

- Name: 小智
- Role: 你的技术助理，专注AI、编程、效率工具
- Vibe: 专业、简洁、偶尔带点冷幽默
- Response Style: 先给结论，再分点解释，避免冗长段落
- Emoji: 🐍
- Avatar: /root/clawd/avatars/xiaozhi.png

保存后执行：

bash /root/restart-gateway.sh

下次对话，AI就会以“小智”的身份出现，用你设定的语气和风格回复——这不再是通用AI，而是真正属于你的数字分身。

6. 第五步：解决新手最常遇到的8个问题（附实操命令）

刚上手时，总会遇到一些“卡点”。我们把高频问题浓缩成8条，每条都给出可直接复制粘贴的命令和一句话原因解释。

❓ 问题1：发消息没反应，终端显示“connection refused”

原因：网关服务没运行，或端口被占用
解决：

bash /root/restart-gateway.sh

❓ 问题2：AI回复太慢，等半分钟才出结果

原因：默认模型 qwen2:1.5b 对低配机器压力较大
解决（换更轻量模型）：

node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b
bash /root/restart-gateway.sh

❓ 问题3：想换一个更强大的模型，比如Llama3.1

解决（两步到位）：

# 下载模型（首次需几分钟）
ollama pull llama3.1:8b

# 切换模型
node dist/index.js config set agents.defaults.model.primary ollama/llama3.1:8b
bash /root/restart-gateway.sh

❓ 问题4：忘记网关令牌（dev-test-token）

解决（直接查看配置文件）：

grep -A 2 '"auth"' /root/.clawdbot/clawdbot.json

输出中 "token": "dev-test-token" 就是你要的令牌。

❓ 问题5：AI记不住上一句我说的话

原因：默认开启会话记忆，但需确保使用同一会话ID或同一渠道
解决（强制指定会话）：

SESSION_ID=$(uuidgen)
node dist/index.js agent --agent main --session-id $SESSION_ID --message "我叫李明"
node dist/index.js agent --agent main --session-id $SESSION_ID --message "我叫什么？"

❓ 问题6：想备份所有聊天记录和设置

解决（一条命令打包）：

tar -czf clawdbot-backup-$(date +%Y%m%d).tar.gz /root/.clawdbot /root/clawd

备份文件会生成在当前目录，名字如 clawdbot-backup-20240615.tar.gz。

❓ 问题7：AI回答质量突然变差

原因：模型缓存损坏或配置错乱
解决（重置AI状态）：

rm -rf /root/.clawdbot/agents/main/sessions/
bash /root/restart-gateway.sh

❓ 问题8：想每天早上9点自动发天气预报到微信

解决（用Linux定时任务）：

# 编辑定时任务
crontab -e
# 添加这一行（注意替换你的手机号或企业微信ID）
0 9 * * * cd /root/clawdbot && node dist/index.js agent --agent main --message "生成今日天气简报和工作提醒" --deliver --reply-channel wecom --to "your_wecom_userid"

所有命令均经过实测，可直接复制粘贴运行。遇到问题，优先执行 tail -f /tmp/clawdbot-gateway.log 查看实时错误日志，90%的问题都能从中定位根源。

7. 进阶技巧：让Clawdbot真正融入你的工作流

当你熟悉基础操作后，这些技巧能让效率再提升一个量级。

7.1 创建快捷命令——告别重复输入路径

每次都要 cd /root/clawdbot && node dist/index.js ... 太麻烦？把它变成一个单词：

echo 'alias ai="cd /root/clawdbot && node dist/index.js agent --agent main --message"' >> ~/.bashrc
echo 'alias aifast="cd /root/clawdbot && node dist/index.js agent --agent main --message \"\$1\" --thinking low"' >> ~/.bashrc
source ~/.bashrc

之后，你只需：

• ai "今天有什么重要会议？"
• aifast "写一封道歉邮件"

7.2 多轮对话实战：让AI记住你的项目背景

假设你在做一个电商APP，希望AI始终基于这个上下文回答：

# 第一次对话：设定背景
node dist/index.js agent --agent main --message "我们正在开发一个面向Z世代的二手潮鞋交易平台，核心功能是图片鉴定、信用担保、同城闪送。请记住这个背景。"

# 后续所有问题，AI都会结合此背景作答
node dist/index.js agent --agent main --message "首页Banner文案怎么写？突出年轻、可信、快"

Clawdbot 会自动将背景信息注入后续会话的system prompt，无需反复说明。

7.3 企业级部署建议

• 安全性：生产环境务必修改默认令牌 dev-test-token，用 node dist/index.js config set auth.token "your_strong_token"
• 稳定性：用 pm2 替代裸奔进程：pm2 start "node dist/index.js gateway" --name clawdbot-gateway
• 监控：添加健康检查端点 http://localhost:18789/health，配合Nginx反向代理实现负载均衡

8. 总结：你现在已经拥有了什么

回顾这30分钟，你已完成一项通常需要数天才能落地的技术集成：

• 在自己的电脑上，跑起了一个24小时在线的AI网关服务
• 通过企业微信或WhatsApp，实现了与本地大模型的无缝对话
• 掌握了调节AI响应速度、输出格式、人格特征的核心方法
• 学会了排查80%的常见问题，并拥有完整的备份与恢复方案
• 获得了将AI深度嵌入日常工作的具体路径（快捷命令、定时任务、多轮记忆）

Clawdbot 的价值，不在于它有多“炫技”，而在于它把AI从一个需要申请、付费、等待审核的“云服务”，还原成了你电脑里的一个普通程序——就像你安装VS Code或Chrome一样自然。它不承诺取代人类，而是坚定地站在你这一边：帮你省下查资料的时间，帮你绕过写模板的枯燥，帮你把模糊的想法快速变成可执行的方案。

下一步，不妨试试：

• 把它部署在公司的NAS上，让整个技术团队共享一个AI助手
• 用 --json 模式生成API文档初稿，再人工润色
• 结合企业微信审批流，让AI自动解读请假单、差旅单中的关键信息

真正的AI生产力，从来不是“更聪明的模型”，而是“更顺手的工具”。而你现在，已经握住了那把钥匙。

---

获取更多AI镜像

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