架构技术评论

MicroClaw 10分钟配置 Telegram Agent

Image

0. 安装MicroClaw

打开官网 https://microclaw.ai/
直接使用右侧对应系统的脚本,例如我是macOS,则直接用第一个install script即可。
Pasted image 20260222230307.png

curl -fsSL https://microclaw.ai/install.sh | bash

Pasted image 20260223194035.png

我的电脑会安装到这里:$HOME目录下.local文件夹

➜  ~ which microclaw
/Users/eevv/.local/bin/microclaw

1. 第三方平台创建机器人

  • BotFather: https://t.me/BotFather

Pasted image 20260222223501.png
操作步骤:

  1. 在 Telegram 打开 @BotFather,发送 /newbot

Pasted image 20260222223609.png

  1. 按提示输入机器人名称和用户名(用户名必须以 bot 结尾),名字还必须唯一。

Pasted image 20260222223807.png

  1. 复制返回的 token(形如 123456:ABC...)

Pasted image 20260222223833.png

可选:

  • 关闭群隐私模式(让机器人可读取更多群消息):/setprivacy -> Disable
    Pasted image 20260222223939.png

2. MicroClaw 最小配置

可以执行一次

microclaw doctor

一般情况下如下图:
Pasted image 20260222231602.png
这里的warning是因为还没配置,很简单,执行:

microclaw setup

进入交互式的配置页面:
Pasted image 20260222232310.png
使用方法还是比较简单的,上下左右移动,回车开始输入,最后的 ctrl+s 可以保存(或者不在输入状态时 输入s 即可保存)
Pasted image 20260223082302.png

配置模型:
Pasted image 20260222232548.png
模型一般会包含最新的3个模型,当然也可以选择手动输入
Pasted image 20260223082152.png

启用telegram渠道:
Pasted image 20260222232608.png

填写刚才获取的bot token和bot username名称,其他默认即可。
Pasted image 20260222232751.png
然后按ctrl+s 即可保存,保存过程中会校验模型是否可用。
Pasted image 20260222232902.png
进入这里就表示成功配置了。
Pasted image 20260222232930.png

注意 这个配置文件目前会保存在运行 microclaw的目录。配置文件名称是 microclaw.config.yaml 。例如你在~/mydir 中运行的话,那配置文件就在这个目录生成。目前是这样。

3. 启动

microclaw start

Pasted image 20260222233016.png

4. 验证是否成功

  1. 在 Telegram 私聊机器人,发 你好
    Pasted image 20260222233049.png

点击可以进入机器人,或者搜我们这个机器人的名字。
Pasted image 20260222233127.png
点start会自动发一条消息,没什么影响。我们就可以如下正常聊天了。

Pasted image 20260222233306.png

我们的控制台也会出现对应的消息:
Pasted image 20260222233332.png

  1. 群聊里用 @your_bot_username 提及它

创建一个群
Pasted image 20260222233617.png

添加机器人到群里
Pasted image 20260222233515.png

可以测试下记忆。不知道怎么给我回答两次~先不管了,回头看看咋修复下。。

Pasted image 20260222233909.png

5. web ui

如果setup中不主动关闭web ui,默认会启动一个web ui。默认访问地址如下:

http://127.0.0.1:10961

Pasted image 20260223082450.png

打开需要输入一个密码,目前默认helloworld。

Pasted image 20260223082515.png
如果是默认密码会提示你改个密码
Pasted image 20260223082535.png

可以skip,进入后可以选择主题颜色之类的,也能单独聊天,也可以看其他channel的聊天记录
Pasted image 20260222235702.png

主题还是挺多的。
Pasted image 20260222235726.png

6. 其他

macOS下 可以把microclaw安装为系统服务,也可以卸载停止之类。

Pasted image 20260222234451.png

可以查看log
Pasted image 20260222234517.png

这样就在后台运行了(这回答多少还是有点小毛病呢?可能是我配置的SOUL.md有点问题,后续文章咱们再聊)
Pasted image 20260222234642.png

7. 重要

可能项目的稳定性还需继续验证,不过流程已经有了。

如果有问题,欢迎评论,公众号回复 mc 或 microclaw 加微信群,也欢迎大家加入 Discord 讨论 https://discord.gg/pvmezwkAk5

欢迎大家试用,顺手给个Star,更欢迎大家发现问题修复问题提PullRequest

https://github.com/microclaw/microclaw

查看原文可跳转