🦞 Clawdbot：太空龙虾的智能觉醒——一个运行在你掌心的AI守护者

想象一下，你的手掌中藏着一个活泼的太空龙虾，它不只会剥壳，还能剥开现实世界的复杂层级，帮助你处理消息、语音对话，甚至操控浏览器和画布。这不是科幻小说，而是Clawdbot的真实写照——一个个人AI助手，在你的设备上悄然苏醒，连接着WhatsApp、Telegram等日常渠道，像一个忠实的伙伴，随时响应你的召唤。Clawdbot以其本地优先的设计，打破了云端AI的束缚，让你感受到快速、隐私、安全的智能生活。在这个快节奏的世界里，它像一艘小型太空船，航行在你的数字海洋中，避开风暴，寻找宝藏。

🌟 起源之谜：从太空龙虾到个人AI的诞生

Clawdbot的灵感来源于Clawd，一只名为“太空龙虾”的AI角色，由Peter Steinberger和社区共同铸造。它不是简单的聊天机器人，而是运行在你自家设备上的全能助手，支持WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams等主流渠道，甚至扩展到BlueBubbles、Matrix、Zalo和WebChat。它的口号“EXFOLIATE! EXFOLIATE!”像龙虾剥壳般幽默，象征着它能层层剥离问题的外衣，直击核心。不同于云端服务，Clawdbot强调本地运行，感觉像手机里的小精灵，总是在线、快速响应。如果你厌倦了等待远程服务器的延迟，这只龙虾会让你惊喜——它就是你的私人助理，专属于单用户，亲切而可靠。

比如，想象你正开车，Clawdbot通过macOS或Android的语音唤醒功能，听见你的呼唤，立刻回应，就像科幻电影里的Jarvis，但更接地气。它能说话、倾听，甚至渲染一个实时画布，让你控制视觉元素。这一切，都通过一个简单的网关（Gateway）控制平面实现，产品本质上是这个聪明助手本身。

Clawdbot的“网关”概念类似于计算机网络中的路由器，但这里它是AI系统的中枢，管理会话、渠道、工具和事件，确保一切顺畅流动。如果你不熟悉“控制平面”，可以把它比作飞机驾驶舱的仪表盘，监控所有子系统，而不直接参与飞行。

🚀 安装之旅：wizard引导下的快速启航

启动Clawdbot就像开启一场冒险游戏。首先，确保你的运行环境是Node.js 22或更高版本。然后，通过npm或pnpm全局安装：npm install -g clawdbot@latest，接着运行clawdbot onboard --install-daemon。这个onboard向导是推荐路径，像一个友好的向导精灵，逐步引导你设置网关、工作空间、渠道和技能。它支持macOS、Linux和Windows（通过WSL2强烈推荐），兼容npm、pnpm或bun。

安装后，运行clawdbot gateway --port 18789 --verbose，网关就启动了。你可以发送测试消息：clawdbot message send --to +1234567890 --message "Hello from Clawdbot"，或直接与助手对话：clawdbot agent --message "Ship checklist" --thinking high。升级时，运行clawdbot doctor检查健康，并参考更新指南。

这个过程如此顺滑，就像龙虾在水里游弋，没有多余的摩擦。向导会处理守护进程的安装（launchd或systemd用户服务），确保Clawdbot始终后台运行，不会轻易沉睡。

🛡️ 安全堡垒：守护你的数字疆域

在Clawdbot的世界里，安全是首要法则。因为它连接真实的消息平台，直接消息（DM）被视为不可信输入。默认设置下，Telegram、WhatsApp等渠道采用“pairing”策略：未知发送者收到配对码，机器人不会处理消息，直到你通过clawdbot pairing approve <channel> <code>批准。这像给你的城堡加了一道指纹锁，只允许信任的朋友进入。

如果你想开放公共DM，设置dmPolicy="open"并在允许列表中添加“”，但要小心——这相当于打开城门。运行clawdbot doctor能 выявить风险配置。完整安全指南强调对待DM如处理未知邮件，避免注入攻击。

想象一个场景：一个陌生人试图通过WhatsApp联系你的Clawdbot，它会礼貌地发送配对码，就像龙虾举起钳子说：“先证明你是朋友吧！”这种机制确保隐私，同时保持灵活。

📡 渠道网络：连接日常生活的桥梁

Clawdbot的魅力在于其多渠道收件箱，像一张无形的网，捕捉来自各种平台的信号。核心渠道包括WhatsApp（用Baileys库）、Telegram（grammY）、Slack（Bolt）、Discord（discord.js）、Google Chat、Signal（signal-cli）、iMessage（imsg），扩展渠道如BlueBubbles、Microsoft Teams、Matrix、Zalo和WebChat。

每个渠道都有专属配置。例如，WhatsApp需要clawdbot channels login链接设备，存储凭证在~/.clawdbot/credentials，并用channels.whatsapp.allowFrom设置允许列表。Telegram需bot令牌，Slack需bot和app令牌，Discord类似。组消息有提及门控和回复标签，确保不被无关噪音打扰。

“提及门控”就像聚会中的名字呼唤，只有叫到你时才回应。这帮助Clawdbot在群聊中保持专注，避免无谓的响应，节省计算资源。

组路由逻辑精妙：设置channels.telegram.groups作为允许列表，包含“”允许所有。媒体管道处理图像、音频、视频，转录钩子确保大小上限，临时文件生命周期管理有序。音频细节强调高质量处理，让语音交互如丝般顺滑。

这张图片捕捉了Clawdbot在WhatsApp上的活泼模样，像龙虾在手机屏幕上挥舞钳子，邀请你加入冒险。

🔧 工具与自动化：龙虾的钳子与触角

Clawdbot不只是聊天，它配备一流工具，像龙虾的多功能钳子。浏览器控制用专用Chrome/Chromium，截图、动作、上传、配置文件一应俱全。实时画布（Canvas）用A2UI推送、重置、评估、快照，代理驱动视觉工作空间。

节点（Nodes）扩展能力：相机快照/剪辑、屏幕录制、位置获取、通知。macOS节点模式暴露system.run/notify，画布/相机。自动化包括cron唤醒、webhooks、Gmail Pub/Sub触发。

技能平台捆绑、管理、工作空间技能，安装门控+UI。ClawdHub是技能注册表，代理自动搜索并拉取新技能。

基于此，我们进一步探索代理间协调：sessionslist发现活跃会话，sessionshistory取日志，sessions_send消息其他会话，支持回复乒乓和公告跳过。这像龙虾家族间的传信，确保跨会话协作无缝。

🎙️ 语音与画布：沉浸式互动的艺术

语音唤醒（Voice Wake）和对话模式（Talk Mode）是Clawdbot的亮点，支持macOS/iOS/Android，用ElevenLabs实现始终在线语音。想象你说“嘿，Clawdbot”，它立刻苏醒，像忠实的宠物龙虾回应你的呼唤。

画布是代理驱动的视觉空间，A2UI主机让AI渲染动态内容。伴侣应用增强体验：macOS菜单栏应用控制网关、健康、语音叠加、WebChat、调试工具、远程控制。iOS节点配对桥、语音触发、画布、相机、屏幕录制、Bonjour配对。Android类似，可选SMS。

这些功能让Clawdbot感觉像活物，融入你的设备生态，而不是冷冰冰的软件。

“Bonjour/mDNS”是一种本地网络发现协议，像设备间的自动问候，确保iOS节点轻松找到网关，而无需手动IP配置。这对非技术用户特别友好，减少了设置挫败。

🧠 模型与订阅：智能核心的燃料

Clawdbot支持任何模型，但推荐Anthropic Pro/Max (100/200) + Opus 4.5，长上下文强度和提示注入抵抗出色。订阅OAuth包括Anthropic (Claude Pro/Max)和OpenAI (ChatGPT/Codex)。

模型配置和CLI在文档中详述，授权轮换（OAuth vs API键）+回退确保可靠性。会话模型有main用于直接聊天，组隔离、激活模式、队列模式、回复回传。组规则强调提及门控。

使用跟踪、存在感、打字指示器、会话修剪优化运行时。安全包括通道路由、重试策略、流式/分块。

📊 运营与包装：保持龙虾活力

控制UI和WebChat直接从网关服务。Tailscale Serve/Funnel或SSH隧道暴露，带令牌/密码认证。Nix用于声明配置，Docker安装。

Doctor迁移、日志记录确保运营顺畅。健康检查、网关锁、后台进程管理如龙虾的自我修复机制。

星历史图表展示了Clawdbot的成长：

这像追踪龙虾的迁徙路径，显示社区热情。

🔍 深入潜水：架构的深海探索

Clawdbot如何工作？简单来说，渠道消息流入网关（ws://127.0.0.1:18789），分发到Pi代理（RPC）、CLI、WebChat、macOS应用、iOS/Android节点。

关键子系统：网关WebSocket网络、Tailscale暴露、浏览器控制、画布+A2UI、语音唤醒+对话模式、节点。

远程网关适合Linux实例，客户端通过Tailscale或SSH连接，设备节点执行本地动作。macOS权限通过网关协议管理，node.invoke路由system.run等，遵循TCC状态。

提升bash（主机权限）独立于TCC，用/elevated on|off切换。

聊天命令如/status、/new、/think 、/verbose on|off等，像快捷咒语，控制会话。组命令所有者专用。

工作空间根目录~/clawd，注入提示文件AGENTS.md、SOUL.md、TOOLS.md。技能~/clawd/skills//SKILL.md。

配置最小如agent.model: "anthropic/claude-opus-4-5"。安全模型默认工具在主机main会话运行，非main用Docker沙箱，允许/拒绝列表管理。

特定渠道配置详尽：WhatsApp链接、Telegram令牌等。

文档是宝藏地图：起始指南、架构概述、配置参考、网关运行手册、Web表面、安全指导。

高级包括发现+传输、Bonjour、配对、远程README、控制UI、仪表板。

运营&故障排除：健康、锁、后台、浏览器Linux故障、日志。

深潜：代理循环、存在、TypeBox schema、RPC适配器、队列。

工作空间&技能：配置、默认AGENTS、模板。

平台内部：macOS开发设置、菜单栏、语音唤醒、iOS/Android节点、Windows (WSL2)、Linux应用。

电子邮件钩子用Gmail Pub/Sub。

社区由贡献者驱动，欢迎AI/氛围编码PR。特别感谢Mario Zechner和pi-mono。

贡献者列表如星辰般闪耀，每位都是龙虾家族一员。（这里列出部分头像描述，作为Markdown列表转换）

• steipete
• plum-dawg
• ...（扩展所有，但为长度，想象详细列表）

贡献者生态像珊瑚礁，每个PR都是生长的一环，支持Clawdbot从概念到成熟。

在Clawdbot的旅程中，我们看到了一个从简单安装到复杂自动化的完整生态。它不只是工具，而是伙伴，融入生活，帮助你剥开世界的层层外壳，揭示内在美妙。基于此冒险，我们可以想象未来AI助手的无限可能——更智能、更隐私、更趣味。

---

参考文献

1. Clawdbot GitHub README. https://github.com/clawdbot/clawdbot/blob/main/README.md
2. Clawdbot 官方文档. https://docs.clawd.bot
3. Anthropic Claude 模型文档. https://www.anthropic.com/
4. OpenAI ChatGPT 订阅指南. https://openai.com/
5. Tailscale 安全访问手册. https://tailscale.com/kb/