基础安装

系统选择上有一个硬性要求：必须使用 64 位 Ubuntu。如果用其他发行版，大概率需要自行编译依赖，徒增麻烦。

安装本身使用官方一键脚本即可，会自动配置 Node.js 环境和 Clawdbot 核心组件。安装教程网上很多，这里不赘述，确保 Clawdbot 能正常运行就行。

配置 Telegram 机器人

如果在 Clawdbot 初始化时已经配过 Telegram，可以跳过这一步。

  1. 在 Telegram 中私聊 BotFather，用 /newbot 指令创建机器人，保存好生成的 API Token
  2. 打开 ~/.clawdbot/clawdbot.json，将 Token 写入配置
  3. 配置完成后系统会自动重启 Gateway 以应用更改

开启流式输出：打字机效果

这一步让机器人的回复不再是一整块弹出，而是逐字逐句地"打"出来，体验好很多。需要改两个地方。

Clawdbot 配置侧：在配置文件中启用 streamMode: "partial"。

BotFather 侧（这一步容易踩坑）：流式输出依赖 Telegram 的特定消息处理模式，需要通过 BotFather 的 Web App 小程序界面操作：

  • 进入 BotFather 小程序管理界面
  • 选中你的机器人 → 点击 Bot Settings
  • 找到 Threaded Mode 开关并打开

注意：一定要在小程序界面操作，不是在聊天框发指令。配置完后建议执行 clawdbot gateway restart 重启网关确保生效。

安装 Google Chrome：赋予浏览器能力

要让机器人具备网页浏览和自动化操作的能力，需要安装原生 Google Chrome，然后在 ~/.clawdbot/clawdbot.json 中指定 Chrome 路径并开启控制端口。

这个设计很实用——机器人可以直接操作浏览器，意味着你能让它替你完成各种网页端的自动化任务。

远程调试：通过 SSH 隧道登录账号

当需要给机器人登录某些账号（比如微信、GitHub）时，可以通过 SSH 隧道把服务器上 Chrome 的调试端口转发到本地：

  1. 在本地终端建立 SSH 隧道（将 your_server_ip 替换为实际服务器 IP）
  2. 本地 Chrome 访问 chrome://inspect/#devices
  3. 点击 Configure，确认包含 localhost:9222
  4. 在下方 Remote Target 中找到 Clawdbot 正在运行的页面，点击 inspect 即可像操作本地浏览器一样登录账号

集成 Whisper 语音识别

装好环境依赖后，在 ~/.clawdbot/clawdbot.json 中添加音频处理模型配置。到了这一步，你甚至可以把配置内容直接丢给 Clawdbot，让它自己完成配置——用 AI 配置 AI，属于是。

配置完成后，机器人收到语音消息会自动调用 Whisper 进行转录。

常用管理命令

  • 查看状态：clawdbot gateway status
  • 重启网关：clawdbot gateway restart
  • 查看日志：clawdbot logs

整套流程走下来，你会拥有一个能对话、能浏览网页、能听懂语音的 Telegram AI 助手。对于一人公司来说，这相当于一个 7×24 在线的数字员工。后续可以在此基础上接入更多工具和工作流，比如让它定时抓取信息、自动回复客户消息，或者接入你自己的业务 API——可玩性很高。