Clawdbot汉化版使用教程：在WhatsApp、Telegram里用AI

1. 为什么你需要一个“聊天软件里的AI助手”？

想象一下这些场景：

• 你正在微信群里讨论一个技术问题，需要快速写一段示例代码，但切换App、打开网页版AI工具太麻烦。
• 客户在WhatsApp上发来一段产品需求，你想立刻生成一份简洁的总结，却不想离开聊天窗口。
• 深夜在Telegram频道里看到一篇长文，想让AI帮你提炼要点，但电脑已经关机。

Clawdbot汉化版就是为了解决这些“即时性”需求而生的。它不是一个需要你反复登录的网页工具，而是一个能直接“住”在你常用聊天软件里的智能伙伴。更关键的是，它完全运行在你自己的设备上，你的所有对话记录、数据隐私都牢牢掌握在自己手里，无需担心信息泄露。

这个镜像预装了所有必要的组件，包括一个轻量级的AI模型，让你在几分钟内就能拥有一个24小时在线、完全免费的私人AI助手。标题中提到的“企业微信入口”，指的是其架构设计天然支持通过Webhook等方式接入企业微信这类办公协同工具，为后续搭建企业内部AI助手提供了可能。

这篇文章将带你从零开始，用最简单直白的步骤，在WhatsApp和Telegram里唤醒你的AI助手。我们假设你没有任何命令行或服务器管理经验，所有操作都配有可直接复制的命令和明确的成功提示。

2. 第一步：启动你的AI引擎（检查与测试）

别被“部署”这个词吓到。Clawdbot汉化版镜像已经为你准备好了一切。你需要做的第一件事，就是确认服务已经正常启动并运行。

2.1 检查AI服务是否“在线”

打开你的终端（在Mac上是“终端”应用，在Windows上可以使用WSL或PowerShell），输入下面这行命令并回车：

ps aux | grep clawdbot-gateway

这条命令的作用是查看系统中是否有名为 clawdbot-gateway 的程序正在运行。

如果看到类似下面的输出，说明一切正常：

root     133175  0.2  2.1 1245678 89012 ?      Ssl   10:23   0:04 /usr/bin/node /root/clawdbot/dist/index.js gateway

看到 clawdbot-gateway 这一行，就表示你的AI助手服务已经在后台安静地待命了。

如果什么都没看到，或者只显示了 grep 本身，说明服务没有启动。 别担心，只需要运行一个简单的启动脚本：

bash /root/start-clawdbot.sh

等待几秒钟，然后再运行一次 ps aux | grep clawdbot-gateway 检查，应该就能看到服务进程了。

2.2 和AI打个招呼，确认它能“说话”

服务运行了，但AI真的能听懂我们说话吗？让我们用最直接的方式测试一下。

在终端里，依次输入以下两行命令：

cd /root/clawdbot
node dist/index.js agent --agent main --message “你好，Clawdbot！”

稍等片刻（首次运行可能会慢一些，因为需要加载模型），你应该会看到AI的回复，内容大致是向你问好并介绍它能做什么。

看到这个回复，恭喜你！你的AI引擎核心功能已经完全正常，可以开始下一步，把它连接到你的聊天软件了。

3. 把AI装进WhatsApp：扫码即用，像添加好友一样简单

这是最推荐的方式，因为WhatsApp的使用体验和微信非常相似，连接过程也极其简单。

3.1 第一步：启动配对，获取二维码

在终端中，确保你在 /root/clawdbot 目录下，然后执行配对命令：

node dist/index.js whatsapp pair

运行后，终端屏幕上会显示一个大大的二维码。

3.2 第二步：用手机WhatsApp扫描二维码

1. 在你的手机上打开 WhatsApp 应用。
2. 点击右上角的 三个点（菜单） -> “关联设备” -> “关联设备”。
3. 用手机摄像头扫描终端屏幕上显示的二维码。

3.3 第三步：开始对话

扫描成功后，终端会显示 Connected! 之类的成功信息。现在，回到你的手机WhatsApp。

你会发现你的WhatsApp里多了一个“设备”，名字可能是一串数字或“Chrome”等。接下来是关键操作：

不要在这个设备对话里发消息。你需要：

1. 在WhatsApp的主界面，找到 你自己的聊天窗口（就是你可以给自己发消息的那个对话）。
2. 或者，随便找一个联系人的聊天窗口。
3. 在这个聊天窗口里，直接输入你想问AI的问题，比如：“帮我写一份简单的会议纪要模板”。

发送后，稍等几秒，你就会收到来自AI助手的回复了！它看起来就像是一个联系人在和你对话。

原理小贴士：Clawdbot通过WhatsApp Web协议连接，相当于在你的服务器上登录了一个WhatsApp网页版。所有发给这个“账号”的消息，都会被转发给AI处理并回复。

4. 把AI装进Telegram：创建一个专属机器人

如果你更常用Telegram，那么为AI创建一个专属的机器人是个很棒的选择，管理起来更清晰。

4.1 第一步：在Telegram上创建你的机器人

1. 在Telegram应用中，搜索并打开 @BotFather（这是Telegram官方的机器人管理工具）。
2. 向它发送 /newbot 命令。
3. BotFather 会引导你：
   • 为你的机器人起一个名字（例如：My AI Helper）。
   • 为你的机器人设置一个唯一的用户名，必须以 bot 结尾（例如：my_ai_helper_bot）。
4. 创建成功后，BotFather 会给你一串重要的 Token（看起来像 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz）。请务必复制并保存好这串Token，下一步会用到。

4.2 第二步：在Clawdbot中配置机器人Token

回到你的服务器终端，执行以下命令开始配对：

node dist/index.js telegram pair

系统会提示你输入刚才从 @BotFather 那里获取的Token。粘贴进去并回车。

4.3 第三步：找到你的机器人并开始聊天

配置成功后，在Telegram的搜索框中，输入你刚才设置的机器人用户名（例如 @my_ai_helper_bot）并打开对话。

现在，你可以直接在这个聊天窗口里向你的AI机器人提问了，比如发送：“用Python写一个计算斐波那契数列的函数”。

5. 第三种选择：使用网页控制面板（无需手机）

如果你暂时不方便使用手机，或者想在电脑上有一个更直观的界面，Clawdbot也提供了一个简洁的网页控制面板。

1. 打开你的浏览器。
2. 在地址栏输入：http://你的服务器IP地址:18789
   • 如何找到服务器IP？ 在终端输入 hostname -I 命令，通常会显示一个或多个IP地址，使用第一个即可（通常是内网IP，如 192.168.1.xxx）。
3. 访问后，页面会要求你输入令牌（Token）。
4. 输入默认令牌：dev-test-token，然后点击进入。

你会看到一个类似聊天软件的界面，左侧是历史记录，中间是对话区域。在这里，你可以直接和AI对话，所有功能与在WhatsApp/Telegram中一致。

6. 驾驭你的AI：从基础对话到高级技巧

现在AI已经能和你对话了，让我们来学习如何更好地使用它。

6.1 基础对话：问什么，答什么

最直接的用法就是像和朋友聊天一样提问。无论是在WhatsApp、Telegram还是网页面板，直接输入你的问题即可：

• “今天天气怎么样？”（它会基于知识库回答）
• “帮我写一封感谢客户来访的邮件。”
• “用简单的语言解释一下什么是区块链。”

6.2 调整AI的“思考深度”：让回答又快又好

对于不同复杂度的问题，你可以控制AI的思考程度，平衡速度和质量。在终端命令中，使用 --thinking 参数：

# 快速回答，适合简单事实性问题
node dist/index.js agent --agent main --message “北京是中国的首都吗？” --thinking low

# 深度思考，适合需要逻辑、创意或复杂分析的问题
node dist/index.js agent --agent main --message “为一个新的环保科技创业公司设计一个商业模式画布。” --thinking high

思考级别指南：

级别	适用场景	速度	输出质量
minimal / low	简单问答、翻译、格式转换	非常快	简洁、直接
medium	写邮件、做计划、中等复杂度总结	快	有条理、细节适中
high	编程、系统设计、创意写作、深度分析	较慢	非常详细、结构清晰、富有创意

6.3 获取结构化输出（如JSON）

如果你希望AI的回答能被其他程序直接处理，可以要求它输出JSON格式：

node dist/index.js agent --agent main --message “列出三种流行的编程语言及其主要应用领域。” --json

这样，回复就会是规整的JSON数据，而不是纯文本。

7. 常见问题与故障排除

遇到问题不要慌，大部分情况都可以通过以下方法解决。

7.1 问题：AI回复非常慢，或者超时无响应

可能原因：默认的AI模型可能对您的服务器资源要求较高。 解决方案：切换到一个更轻量、更快的模型。

# 1. 首先查看Ollama中有哪些可用模型
ollama list

# 2. 切换Clawdbot使用的模型（例如切换到更小的qwen2:0.5b模型）
cd /root/clawdbot
node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b

# 3. 重启网关服务使配置生效
bash /root/restart-gateway.sh

重启后，再次尝试对话，响应速度通常会显著提升。

7.2 问题：WhatsApp/Telegram扫码后连接失败

可能原因：网络问题或会话过期。 解决方案：

1. 重启配对流程：在终端按 Ctrl+C 终止当前的 pair 命令，然后重新运行 node dist/index.js whatsapp pair 或 telegram pair，获取新的二维码。
2. 检查网络：确保你的服务器可以正常访问外部网络（特别是WhatsApp/Telegram的服务）。
3. 查看日志：在终端运行 tail -f /tmp/clawdbot-gateway.log 查看实时日志，里面可能有具体的错误信息。

7.3 问题：忘记了网页控制面板的登录令牌

解决方案：查看或重置令牌。

# 查看当前的令牌
cat /root/.clawdbot/clawdbot.json | grep -A 2 auth

# 如果你想修改令牌，可以编辑配置文件（将your-new-token-here替换成你的新密码）
# 注意：这是一个示例，修改前请备份原文件
# sed -i 's/"token": "dev-test-token"/"token": "your-new-token-here"/g' /root/.clawdbot/clawdbot.json
# bash /root/restart-gateway.sh

7.4 问题：想清除AI的所有聊天记忆

解决方案：删除会话记录文件。

# 删除当前AI助手（main）的会话记录
rm /root/.clawdbot/agents/main/sessions/sessions.json

# 然后重启服务
bash /root/restart-gateway.sh

这样AI就会“忘记”之前的所有对话，从一个全新的会话开始。

8. 进阶玩法：让AI更贴心、更强大

当你熟悉基本操作后，可以尝试这些技巧来提升体验。

8.1 为AI设置专属“人设”

你可以修改AI的身份文件，让它以不同的性格和角色与你对话。

1. 编辑身份文件：

   nano /root/clawd/IDENTITY.md
   

2. 修改文件内容，例如：

   - Name: 技术小助手
   - Creature: 一个严谨、乐于助人的技术专家
   - Vibe: 回答专业且详细，喜欢用比喻解释复杂概念
   - Emoji: 🔧
   

3. 保存文件后，重启服务：

   bash /root/restart-gateway.sh
   

重启后，AI的回复风格就会根据你的设定发生变化。

8.2 创建命令别名，快速调用

觉得输入长命令太麻烦？可以创建简短的别名。

编辑你的bash配置文件（例如 ~/.bashrc）：

nano ~/.bashrc

在文件末尾添加以下几行：

# 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'

保存后，执行 source ~/.bashrc 使配置生效。 现在，你可以这样使用：

ai “你好吗？”
aifast “快速回答1+1”
aideep “详细说明量子计算原理”

8.3 实现多轮对话（让AI记住上下文）

默认情况下，每条命令都是独立的。如果你希望AI记住之前的对话，可以使用 --session-id 参数。

# 第一次对话，告诉AI你的名字
node dist/index.js agent --agent main --session-id mychat --message “请记住，我的名字叫张三。”

# 第二次对话，在同一个会话中，AI会记得你
node dist/index.js agent --agent main --session-id mychat --message “我刚才说我叫什么名字？”

AI在第二次回复时，应该能说出“张三”。

9. 总结：你的私人AI助手已就位

通过以上步骤，你已经成功地将一个强大的AI助手接入了你日常使用的聊天软件。让我们回顾一下你取得的成果：

• 隐私与可控：所有数据都在本地处理，你的对话记录完全私密。
• 便捷与即时：无需打开额外网页或应用，在WhatsApp/Telegram中即可随时调用AI。
• 免费与开源：基于开源模型和框架，无需支付API调用费用。
• 高度可定制：从AI人设、思考深度到连接方式，你都可以按需调整。

Clawdbot汉化版降低了大模型AI的使用门槛，让它从一项“技术”变成了一个触手可及的“工具”。无论是用于快速获取信息、辅助内容创作、学习编程，还是仅仅作为一个聊天伙伴，它都能在你的数字生活中扮演一个有用的角色。

现在，打开你的WhatsApp或Telegram，开始和你新认识的AI助手对话吧！

---

获取更多AI镜像

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