准备工作：这些东西你得先备好
说实话，我刚接触“小龙虾”这个工具的时候，也是一头雾水。明明就是个消息推送的小玩意儿，怎么文档写得跟天书似的？后来折腾了两天，总算摸透了门道。今天就把我踩过的坑、绕过的路，全给你掰扯清楚。你跟着一步步来，半小时就能把“小龙虾”跑起来，顺带把钉钉和飞书都直连上，往后监控告警、表单通知、自动化流程就再也不用人工转发了。
动手之前，先捋一捋你手头需要准备的东西。其实真不多，就三样：一台能联网的服务器（或者你自己的电脑），一个域名（最好有，没有也能凑合），再加一个钉钉机器人和飞书机器人的Webhook地址。服务器配置不用太高，1核2G的轻量云服务器就够用，最便宜的几十块钱一个月。你要是懒得买服务器，在自己电脑上装个虚拟机也行，不过得保证电脑不关机。域名的话，可以去云厂商那儿注册个几块钱的，当然直接用IP地址也能访问，就是后续配置HTTPS麻烦点。钉钉和飞书的机器人，分别在它们的管理后台里创建，“自定义机器人”选Webhook模式，复制那个长串的地址就行。
小提醒：钉钉机器人的安全设置，建议选“自定义关键词”，比如填“通知”两个字。飞书那边同样设置好签名验证，别为了省事跳过，后面跑通了你才会发现这一步能挡掉多少垃圾消息。
你可能会问，这些东西到底能干嘛？简单说，“小龙虾”就是个消息中转站，它接受各种来源的推送（比如服务器监控报警、电商订单通知、GitHub代码更新），然后根据你设定的规则，再转发到钉钉、飞书、企业微信甚至个人邮箱里。而TopClaw是它的一个免费插件，专门把钉钉和飞书这俩平台拉通，让你不用写一行代码就能直接连上。
一步一步搭起来：保姆级操作流程
准备工作做好之后，咱们开始动手。我用的是最轻量的Docker方式搭建，你要是对命令行不熟，也可以直接用官方提供的一键安装脚本。
- 第一步：在服务器上安装Docker和Docker Compose。不会的可以去搜“CentOS安装Docker”或者“Ubuntu安装Docker”，照着官方教程敲几行命令就行。
- 第二步：拉取小龙虾的镜像。执行
docker pull topclaw/crayfish:latest—— 别紧张，就是这一条命令。 - 第三步：创建配置文件。在服务器上新建一个文件夹，比如
mkdir ~/crayfish_config，然后新建一个docker-compose.yml文件，把官方仓库里的示例内容复制进去，改一下端口号和域名。 - 第四步：启动服务。运行
docker-compose up -d，等几秒钟，浏览器输入你的服务器IP加端口号（默认是8080），就能看到小龙虾的登录界面了。 - 第五步：初始化设置。第一次登录会让你设置管理员账号和密码，按提示填好就行。进去之后，先不要急着配置流程，先去“插件市场”找到TopClaw，点击安装。安装完成后，在左侧菜单栏就能看到“钉钉”和“飞书”的配置入口。
你可能会遇到一个常见问题：启动后页面打不开。八成是防火墙没放行端口。去云服务器的控制台，把安全组规则里加上8080端口的入站规则，或者直接在服务器里关掉防火墙（不推荐生产环境关，但测试阶段可以临时用 systemctl stop firewalld 解决）。
我自己第一次装的时候，因为服务器上已经跑了个Nginx占用了80端口，结果小龙虾的8080端口也冲突了。后来改成8090端口，一切顺利。所以端口号你灵活调，只要没被占用就行。
直连钉钉飞书：TopClaw插件的灵魂用法
插件装好以后，真正的“直连”开始了。这一部分是我花时间最久的，但搞明白之后发现特别简单。你要做的就是把之前准备好的钉钉和飞书机器人Webhook地址，填进小龙虾后台对应的配置框里。
- 钉钉配置：在后台进入“钉钉”模块，点击“添加机器人”，填入机器人名字（随便起一个，比如“告警通知”），再把Webhook地址粘贴进去。安全设置里选“自定义关键词”，填上你之前在钉钉机器人那边设定的关键词，比如“通知”。然后点“测试”，如果提示成功，恭喜，钉钉那条路就通了。
- 飞书配置：操作几乎一样，不过飞书多了一个“签名校验”的步骤。你需要在小龙虾后台生成一个签名密钥，然后复制到飞书机器人的安全设置里。别嫌麻烦，这一步能保证你的消息不会被外人伪造。
- 创建自动化流程：配置好两边之后，回到小龙虾的“流程”页面，新建一个流程。触发器可以选择“Webhook”，意思是别人往这个地址发请求，就会自动转发。然后添加一个“动作”，选择“发送消息到钉钉”或“发送消息到飞书”，甚至两个都选上，这样就可以同时通知钉钉群和飞书群。
举个例子：我把自己服务器的CPU温度监控脚本加上了curl请求，当温度超过80度，就往小龙虾的Webhook地址发一条JSON数据。小龙虾收到后立刻推送到钉钉和飞书，我手机秒收到告警。以前得开好几个监控平台，现在一个界面全搞定。
进阶玩法：你可以用TopClaw的“模板”功能自定义消息样式，比如钉钉里显示成Markdown卡片，飞书里显示成富文本。我们团队后来把每日销售数据也接进去了，每天早上一睁眼，手机“叮”一声，数据表就躺在群里了。
整个搭建过程，只要你不像我一开始那样手误把端口号写错，基本半小时内就能跑通。说实话，这个组合最大的价值就是“免费”和“无代码”，特别适合小团队或者个人开发者。不用啃长文档，不用写又臭又长的API对接代码，把时间省下来干点正事。我现在的习惯是，但凡遇到需要重复通知的场景，第一反应就是拉个小龙虾流程，几分钟搞定。
技术这东西，有时候越简单越实用。别被那些花里胡哨的术语吓住，你按照上面的步骤走一遍，就会发现所谓“搭建”不过是复制粘贴加几个点击。往后你还能自己琢磨出更多玩法，比如对接电商平台的订单提醒、GitHub的commit通知，甚至IoT设备的状态上报。趁着免费的机会，赶紧动手试试，有问题随时回来翻翻这篇文章，保准帮你少走弯路。
