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提供了一个网页版的控制面板。

  1. 打开你的浏览器。
  2. 在地址栏输入:http://你的服务器IP地址:18789
    • 将“你的服务器IP地址”替换为你电脑的实际IP。如果是本地电脑,通常是 http://localhost:18789http://127.0.0.1:18789
  3. 在登录页面,输入令牌:dev-test-token
  4. 登录后,你就能看到一个简洁的聊天界面,可以直接输入问题和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中创建你的机器人

  1. 打开手机或电脑上的Telegram应用。
  2. 在顶部的搜索框中,输入 @BotFather 并搜索(注意前面有@符号)。
  3. 找到官方认证的 BotFather 并进入对话。
  4. 向它发送命令:/newbot
  5. BotFather会引导你:
    • 为你的机器人起一个显示名称(比如 My AI Helper)。
    • 为你的机器人设置一个唯一的用户名,必须以 bot 结尾(比如 my_ai_helper_bot)。
  6. 创建成功后,BotFather会给你一串重要的信息——Token。它看起来像这样:1234567890:ABCdefGHIjklMNOpqrsTUVwxyz立即复制并保存好它,下一步要用。

第二步:在Clawdbot中配置机器人

  1. 回到你的终端,确保位于Clawdbot目录下:
    cd /root/clawdbot
    
  2. 启动Telegram配对向导:
    node dist/index.js telegram pair
    
  3. 程序会提示你输入Token。将刚才从BotFather那里复制的Token粘贴进去,然后按回车。
  4. 看到成功的提示信息后,配置就完成了!

第三步:开始聊天

  1. 回到Telegram,在搜索框输入你刚才设置的机器人用户名(如 @my_ai_helper_bot)。
  2. 找到你的机器人,点击“开始”按钮。
  3. 现在,你可以直接在这个聊天窗口里向你的AI助手提问了!就像和朋友聊天一样简单。

Telegram配对成功示意

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开发者页面创建机器人和应用

  1. 用浏览器打开 Discord开发者应用页面。
  2. 点击右上角的 “New Application” 按钮。
  3. 给你的应用起个名字(比如 ClawdBot),然后点击创建。
  4. 进入应用设置页面后,在左侧菜单找到 “Bot” 选项并点击。
  5. 在Bot页面,点击 “Add Bot” 按钮。确认后,你就创建了一个机器人。
  6. 在Bot页面,找到 “Token” 部分,点击 “Reset Token”“Copy” 按钮,复制这串Token。同样,妥善保存。

第二步:生成邀请链接,将机器人加入你的服务器

  1. 在左侧菜单找到 “OAuth2” -> “URL Generator”
  2. “Scopes” 权限范围下,勾选 bot
  3. 在下面自动出现的 “Bot Permissions” 机器人权限中,根据你需要勾选权限,通常至少需要:
    • Send Messages (发送消息)
    • Read Message History (读取消息历史)
  4. 页面底部会生成一个 “Generated URL”。复制这个链接。
  5. 在浏览器的新标签页中打开这个链接。它会引导你选择一个Discord服务器(你需要有管理权限),并将机器人添加进去。

第三步:在Clawdbot中完成配对

  1. 回到终端,进入Clawdbot目录:
    cd /root/clawdbot
    
  2. 启动Discord配对向导:
    node dist/index.js discord pair
    
  3. 粘贴你从Discord开发者页面复制的Bot Token。
  4. 配对成功后,你就可以在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模型太大,而你的电脑或服务器性能有限。

解决方法

  1. 查看当前使用的模型:
    cat /root/.clawdbot/clawdbot.json | grep model
    
  2. 切换到更小、更快的模型:
    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
    
  3. 重启网关服务使配置生效:
    bash /root/restart-gateway.sh
    

问题:如何修改AI的“性格”或身份? 你可以通过编辑身份文件来定制AI的回复风格。

  1. 编辑身份文件:
    nano /root/clawd/IDENTITY.md
    
  2. 修改里面的描述,例如:
    - Name: 小智
    - 角色: 一位幽默风趣的技术助手
    - 风格: 回答简洁明了,喜欢用表情包和网络用语,在解释复杂概念时善于比喻。
    - 表情符号: 🤖
    
  3. 保存文件并重启服务:
    bash /root/restart-gateway.sh
    
    之后AI的回复就会带有你设定的风格了。

问题:忘记了网页控制面板的令牌 如果你忘记了登录令牌 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等主流通讯平台连接的全套流程。我们来回顾一下关键点:

  1. 核心价值:Clawdbot让你能在熟悉的聊天环境(微信、Telegram等)中直接调用强大的AI能力,无缝融入工作流,且完全免费、隐私安全。
  2. 连接核心:与Telegram或Discord配对的关键在于获取并正确配置 Bot Token。Telegram通过 @BotFather 获取,Discord则在开发者门户创建应用后获取。
  3. 灵活使用:你可以通过终端命令快速测试,通过网页面板进行管理,更可以通过连接外部平台实现随时随地对话。
  4. 按需调整:如果响应慢,尝试更换更小的AI模型;如果想改变AI风格,编辑身份文件即可。

现在,你的私人AI助手已经准备就绪。无论是工作中快速查询资料、编写代码片段,还是生活中充当创意伙伴、翻译助手,它都能在你最常用的聊天窗口里随时待命。开始享受这种高效、便捷的人机协作新方式吧!


获取更多AI镜像

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

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐