Clawdbot汉化版实操手册:Telegram/Discord配对全流程图解
本文介绍了如何在星图GPU平台上自动化部署Clawdbot汉化版(增加企业微信入口)镜像,实现AI助手与主流通讯工具的集成。通过该平台,用户可快速搭建环境,并将AI助手便捷地连接到Telegram、Discord等应用,实现直接在聊天窗口中进行智能问答、代码编写和内容总结等任务,提升日常沟通与工作效率。
Clawdbot汉化版实操手册:Telegram/Discord配对全流程图解
1. 前言:你的私人AI助手,触手可及
想象一下,你正在和朋友聊天,突然想到一个问题需要查资料,或者需要快速写一段代码。传统做法是:退出聊天软件,打开浏览器,搜索答案,再复制粘贴回去。这个过程繁琐又打断思路。
现在,有了Clawdbot,一切都变得简单了。它就像一个住在你电脑里的智能助手,你可以直接在微信、WhatsApp、Telegram、Discord这些日常聊天工具里和它对话。问问题、写代码、翻译、总结文章,它都能帮你搞定。
更重要的是,Clawdbot汉化版完全免费,数据隐私有保障,而且24小时在线。今天,我就带你一步步完成Clawdbot的部署,并重点图解如何将它连接到Telegram和Discord,让你在任何地方都能轻松召唤你的AI伙伴。
2. 快速上手:第一次使用Clawdbot
2.1 检查服务状态
首先,我们需要确认Clawdbot服务已经在你的电脑或服务器上运行起来了。打开终端(命令行窗口),输入以下命令:
ps aux | grep clawdbot
如果你看到类似下面的输出,说明服务正在愉快地工作:
root 133175 clawdbot-gateway
如果什么都没看到,或者进程不存在,别担心,启动它很简单:
bash /root/start-clawdbot.sh
运行这条命令后,再检查一次状态,应该就能看到服务进程了。
2.2 打个招呼,测试连接
服务运行起来后,让我们先和AI助手打个招呼,确保一切正常。在终端里输入:
cd /root/clawdbot
node dist/index.js agent --agent main --message "你好"
稍等片刻,你应该会看到AI的回复。如果它回应了你,比如“你好!有什么可以帮你的吗?”,那么恭喜你,Clawdbot的核心功能已经准备就绪了!
3. 核心对话方式:随时随地与AI交流
Clawdbot提供了多种对话方式,你可以根据场景选择最方便的一种。
3.1 终端直接对话(适合快速调试)
这是最直接的方式,适合在服务器上快速测试或执行一次性任务。
基础问答:
# 问任何问题
node dist/index.js agent --agent main --message "今天天气怎么样?"
# 让它帮你写代码
node dist/index.js agent --agent main --message "帮我写一个Python函数,计算斐波那契数列"
# 让它总结内容
node dist/index.js agent --agent main --message "帮我总结这段话:[这里粘贴你的文本]"
控制回答的“思考”深度: 有时候你只需要一个快速答案,有时候则需要它深入思考。Clawdbot可以调节:
# 快速模式,适合简单事实查询
node dist/index.js agent --agent main --message "北京是中国的首都吗?" --thinking minimal
# 深度思考模式,适合复杂问题或创作
node dist/index.js agent --agent main --message "请为我规划一个为期一周的机器学习学习计划" --thinking high
不同思考级别的区别如下:
| 思考级别 | 适合场景 | 响应速度 | 输出质量 |
|---|---|---|---|
off / minimal |
简单问答、事实确认 | 非常快 | 基础、直接 |
low / medium |
日常对话、一般性解释 | 快 | 清晰、有条理 |
high |
复杂分析、代码编写、创作 | 较慢 | 详细、深入、有创意 |
获取结构化数据: 如果你需要把AI的回答用于其他程序,可以要求它输出JSON格式:
node dist/index.js agent --agent main --message "列出三种流行的编程语言及其主要用途" --json
3.2 网页控制面板(直观易用)
如果你更喜欢图形界面,Clawdbot提供了一个网页版的控制面板。
- 打开你的浏览器。
- 在地址栏输入:
http://你的服务器IP地址:18789- 将“你的服务器IP地址”替换为你电脑的实际IP。如果是本地电脑,通常是
http://localhost:18789或http://127.0.0.1:18789。
- 将“你的服务器IP地址”替换为你电脑的实际IP。如果是本地电脑,通常是
- 在登录页面,输入令牌:
dev-test-token - 登录后,你就能看到一个简洁的聊天界面,可以直接输入问题和AI对话了。
这种方式非常适合在电脑前进行长时间的对话或管理任务。
4. 连接外部平台:在Telegram和Discord中使用AI
将Clawdbot连接到Telegram或Discord,意味着你可以在手机或电脑的聊天软件里直接使用它,这才是真正的“随时随地”。
4.1 连接Telegram全流程详解
Telegram的机器人机制非常完善,连接过程清晰。请跟随下图和步骤操作:
graph TD
A[开始连接Telegram] --> B[在Telegram中搜索 @BotFather];
B --> C[向BotFather发送 /newbot 指令];
C --> D[按提示设置机器人名称和用户名];
D --> E[成功创建, 复制BotFather提供的Token];
E --> F[在终端执行 node dist/index.js telegram pair];
F --> G[在终端粘贴复制的Token];
G --> H[配对成功!];
H --> I[在Telegram中找到你的机器人, 开始对话];
详细步骤拆解:
第一步:在Telegram中创建你的机器人
- 打开手机或电脑上的Telegram应用。
- 在顶部的搜索框中,输入
@BotFather并搜索(注意前面有@符号)。 - 找到官方认证的 BotFather 并进入对话。
- 向它发送命令:
/newbot - BotFather会引导你:
- 为你的机器人起一个显示名称(比如
My AI Helper)。 - 为你的机器人设置一个唯一的用户名,必须以
bot结尾(比如my_ai_helper_bot)。
- 为你的机器人起一个显示名称(比如
- 创建成功后,BotFather会给你一串重要的信息——Token。它看起来像这样:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz。立即复制并保存好它,下一步要用。
第二步:在Clawdbot中配置机器人
- 回到你的终端,确保位于Clawdbot目录下:
cd /root/clawdbot - 启动Telegram配对向导:
node dist/index.js telegram pair - 程序会提示你输入Token。将刚才从BotFather那里复制的Token粘贴进去,然后按回车。
- 看到成功的提示信息后,配置就完成了!
第三步:开始聊天
- 回到Telegram,在搜索框输入你刚才设置的机器人用户名(如
@my_ai_helper_bot)。 - 找到你的机器人,点击“开始”按钮。
- 现在,你可以直接在这个聊天窗口里向你的AI助手提问了!就像和朋友聊天一样简单。
4.2 连接Discord全流程图解
Discord的配置稍微多一步,需要先在网页上创建应用并设置权限。整个过程如下图所示:
graph TD
A[开始连接Discord] --> B[访问 Discord开发者门户];
B --> C[创建新应用 New Application];
C --> D[在应用设置中, 点击添加机器人 Add Bot];
D --> E[复制机器人Token];
E --> F[配置OAuth2 URL, 生成邀请链接];
F --> G[用邀请链接将机器人加入你的服务器];
G --> H[在终端执行 node dist/index.js discord pair];
H --> I[粘贴Token完成配对];
I --> J[在Discord服务器中使用 /ask 命令对话];
详细步骤拆解:
第一步:在Discord开发者页面创建机器人和应用
- 用浏览器打开 Discord开发者应用页面。
- 点击右上角的 “New Application” 按钮。
- 给你的应用起个名字(比如
ClawdBot),然后点击创建。 - 进入应用设置页面后,在左侧菜单找到 “Bot” 选项并点击。
- 在Bot页面,点击 “Add Bot” 按钮。确认后,你就创建了一个机器人。
- 在Bot页面,找到 “Token” 部分,点击 “Reset Token” 或 “Copy” 按钮,复制这串Token。同样,妥善保存。
第二步:生成邀请链接,将机器人加入你的服务器
- 在左侧菜单找到 “OAuth2” -> “URL Generator”。
- 在 “Scopes” 权限范围下,勾选
bot。 - 在下面自动出现的 “Bot Permissions” 机器人权限中,根据你需要勾选权限,通常至少需要:
Send Messages(发送消息)Read Message History(读取消息历史)
- 页面底部会生成一个 “Generated URL”。复制这个链接。
- 在浏览器的新标签页中打开这个链接。它会引导你选择一个Discord服务器(你需要有管理权限),并将机器人添加进去。
第三步:在Clawdbot中完成配对
- 回到终端,进入Clawdbot目录:
cd /root/clawdbot - 启动Discord配对向导:
node dist/index.js discord pair - 粘贴你从Discord开发者页面复制的Bot Token。
- 配对成功后,你就可以在Discord中使用了。
第四步:在Discord中使用 在你的Discord服务器里,你现在可以使用斜杠命令来调用AI助手了。例如:
/ask 今天有什么新闻?
机器人就会在频道里回复你。这让它在社群管理或团队协作中非常有用。
5. 进阶技巧与问题排查
5.1 提升使用效率的技巧
创建快捷命令: 每次都输入一长串命令太麻烦。你可以为常用的操作创建别名(alias),添加到你的 ~/.bashrc 或 ~/.zshrc 文件末尾:
# 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 "快速回答我,太阳系有几大行星?"
aideep "请详细解释量子计算的基本原理。"
实现多轮对话(让AI记住上下文): 默认情况下,每次命令都是独立的。要让AI记住之前的对话,可以使用 --session-id 参数:
# 生成一个会话ID(可以用任何唯一字符串)
SESSION_ID="my_chat_$(date +%s)"
# 第一次对话,告诉AI你的名字
node dist/index.js agent --agent main --session-id $SESSION_ID --message "请记住,我的名字叫小明。"
# 第二次对话,在同一会话中,AI会记得
node dist/index.js agent --agent main --session-id $SESSION_ID --message "我刚才说我叫什么名字?"
# AI会回答:“你刚才说你叫小明。”
5.2 常见问题与解决方法
问题:AI回复速度很慢 这通常是因为使用的AI模型太大,而你的电脑或服务器性能有限。
解决方法:
- 查看当前使用的模型:
cat /root/.clawdbot/clawdbot.json | grep model - 切换到更小、更快的模型:
cd /root/clawdbot # 切换到极速小模型 node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b # 或者切换到平衡型模型 # node dist/index.js config set agents.defaults.model.primary ollama/phi3:3.8b - 重启网关服务使配置生效:
bash /root/restart-gateway.sh
问题:如何修改AI的“性格”或身份? 你可以通过编辑身份文件来定制AI的回复风格。
- 编辑身份文件:
nano /root/clawd/IDENTITY.md - 修改里面的描述,例如:
- Name: 小智 - 角色: 一位幽默风趣的技术助手 - 风格: 回答简洁明了,喜欢用表情包和网络用语,在解释复杂概念时善于比喻。 - 表情符号: 🤖 - 保存文件并重启服务:
之后AI的回复就会带有你设定的风格了。bash /root/restart-gateway.sh
问题:忘记了网页控制面板的令牌 如果你忘记了登录令牌 dev-test-token,可以这样查看:
cat /root/.clawdbot/clawdbot.json | grep -A 2 auth
输出中 token 后面的值就是你的当前令牌。
问题:如何备份所有聊天记录和配置? 定期备份是个好习惯。一条命令就能搞定:
# 这将创建一个包含所有配置和会话的压缩包,以当前日期命名
tar -czf clawdbot-backup-$(date +%Y%m%d).tar.gz /root/.clawdbot /root/clawd
# 查看生成的备份文件
ls -lh clawdbot-backup-*.tar.gz
6. 总结
通过这篇手册,你已经掌握了Clawdbot汉化版从部署到与Telegram、Discord等主流通讯平台连接的全套流程。我们来回顾一下关键点:
- 核心价值:Clawdbot让你能在熟悉的聊天环境(微信、Telegram等)中直接调用强大的AI能力,无缝融入工作流,且完全免费、隐私安全。
- 连接核心:与Telegram或Discord配对的关键在于获取并正确配置 Bot Token。Telegram通过 @BotFather 获取,Discord则在开发者门户创建应用后获取。
- 灵活使用:你可以通过终端命令快速测试,通过网页面板进行管理,更可以通过连接外部平台实现随时随地对话。
- 按需调整:如果响应慢,尝试更换更小的AI模型;如果想改变AI风格,编辑身份文件即可。
现在,你的私人AI助手已经准备就绪。无论是工作中快速查询资料、编写代码片段,还是生活中充当创意伙伴、翻译助手,它都能在你最常用的聊天窗口里随时待命。开始享受这种高效、便捷的人机协作新方式吧!
获取更多AI镜像
想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。
更多推荐




所有评论(0)