Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
💡 Use Cases
最适合需要跨平台AI助手且高度重视数据隐私和完全控制权的个人用户或小团队。
跨平台私密助手
Problem: 开发者需要在多个即时通讯平台(如WhatsApp、Telegram、Slack)上使用AI助手,但担心敏感对话数据被第三方云服务存储和分析。
Solution: 在本地设备部署moltbot,它作为网关连接所有支持的通讯渠道,所有AI处理和数据都保留在用户自己的设备上,实现真正的端到端隐私保护。
Example: 开发者可以在自己的Mac上运行moltbot,同时在WhatsApp上询问日程安排、在Slack上查询技术文档、在Telegram上让AI总结新闻,所有对话历史都不会离开本地。
个人数据主权维护
Problem: 注重隐私的用户不希望个人对话、工作笔记或敏感信息被AI服务商用于模型训练或商业分析。
Solution: 使用moltbot的“own-your-data”架构,用户完全控制自己的数据存储位置和访问权限,可以选择本地模型或通过OAuth连接Anthropic/OpenAI等API而不暴露完整对话历史。
Example: 自由职业者用moltbot处理客户项目的敏感需求讨论,所有对话记录都加密存储在本地NAS中,即使使用Claude API也通过安全的OAuth连接,避免API密钥泄露风险。
统一工作流自动化
Problem: 开发者在不同平台(Discord、Teams、iMessage)上有分散的工作沟通,需要AI助手统一处理任务而不必在不同应用间切换。
Solution: moltbot作为统一的控制平面,通过配置不同的channel技能,可以在所有支持的平台上响应指令、执行自动化任务,如会议总结、代码片段生成或信息检索。
Example: 开发者在Teams收到同事的技术问题,在Discord看到社区讨论,在iMessage收到朋友的技术咨询,moltbot可以统一处理这些请求,根据上下文提供一致的帮助。
安全可控的团队协作
Problem: 小团队或初创公司需要内部AI助手提高效率,但担心商业机密通过第三方AI服务泄露,且需要控制访问权限。
Solution: 部署moltbot并配置DM配对策略,只有经过批准的团队成员才能与助手交互,所有交互数据保留在公司内部服务器,结合模型故障转移确保服务连续性。
Example: 5人创业团队在内部Slack部署moltbot,通过`openclaw pairing approve`命令逐个批准成员访问,助手帮助整理会议纪要、生成产品需求文档,所有数据都在团队NAS上。
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 103,270
- Forks
- 14,441
- Today
- +16,338
- Ranking
- #1
- Collection
- Overall
- Trending Date
- January 29, 2026
🏷️ Topics
Difficulty
初级
Est. Time
2-3小时
Target Audience
对个人AI助手感兴趣、希望数据私有、有一定命令行基础的新手开发者或技术爱好者。适合想在自己的设备上部署AI助手,而不想依赖云服务的用户。
🎯 What You'll Learn
能在自己的电脑上成功安装并运行moltbot(OpenClaw),连接至少一个通讯渠道(如Telegram),并开始与你的个人AI助手进行基础对话。
📋 Prerequisites
项目基于Node.js运行,需要能安装Node.js(版本≥22)和包管理器(npm/pnpm/bun)。
安装和配置过程主要通过命令行完成,需要会打开终端并执行基本命令。
用于连接AI助手,例如Telegram或WhatsApp账号,以便测试助手功能。
有助于理解项目结构和未来自定义,但对快速上手非必需。
📚 Resources
Getting Started (入门指南)
项目README中提到的完整新手指南,包含更详细的授权、配对、频道设置步骤。
项目官网与Docs
获取最新的功能说明、配置详解和高级教程。
Discord 社区
遇到问题时可以在这里提问,与其他用户和开发者交流。
Onboarding Wizard (向导本身)
最核心的交互式教程,务必完整走一遍。
🗺️ Learning Phases
环境准备与安装
安装Node.js
访问Node.js官网,下载并安装版本≥22的Node.js。安装完成后,在终端输入 `node --version` 和 `npm --version` 验证安装成功。
安装OpenClaw(moltbot)
打开终端,运行项目推荐的安装命令:`npm install -g @openclaw/cli`。这将在全局安装OpenClaw命令行工具。
验证安装
安装完成后,在终端输入 `openclaw --version` 或 `openclaw --help`,确认命令行工具可以正常调用。
快速启动与向导配置
运行入门向导
在终端执行 `openclaw onboard` 命令。这是官方推荐的新手路径,一个交互式向导将引导你完成核心设置。
配置网关与工作空间
在向导中,设置网关(Gateway)的运行方式。向导会帮你将其安装为系统后台服务(守护进程),确保助手持续运行。
配置AI模型(如Claude或ChatGPT)
在向导的“Models”步骤,你需要提供一个AI模型的API密钥(例如Anthropic Claude或OpenAI)。这是助手的大脑。
连接第一个通讯渠道
选择并配置一个频道
在向导的“Channels”步骤,选择一个你常用的通讯应用,例如Telegram。按照向导提示,完成该频道的机器人创建或账号绑定。
理解并完成配对
配置完成后,向你的新Telegram机器人发送一条消息。由于默认安全策略,你会收到一个配对码。
批准配对请求
回到终端,运行 `openclaw pairing list` 查看待处理的配对请求。使用 `openclaw pairing approve <配对码>` 批准你自己的请求。
首次对话与验证
开始与助手对话
在已配对的Telegram聊天窗口中,向你的机器人发送“Hello”或任何问题,等待AI助手的回复。
运行系统检查
在终端运行 `openclaw doctor` 命令。这个命令会检查你的安装配置是否存在常见问题或安全风险,并给出修复建议。
探索基础命令
尝试 `openclaw status` 查看网关状态,`openclaw channels list` 查看已连接的频道。熟悉这些管理命令。
⚠️ Common Mistakes
❌ Node.js版本过低
✅ 严格确保Node.js版本≥22。使用 `node --version` 检查,过低请升级。
❌ 未正确配置AI模型API密钥
✅ 向导中配置模型时,确保填入的API密钥有效且有余额。密钥错误会导致助手无法思考回应。
❌ 忽略配对步骤,以为助手没反应
✅ 向Telegram机器人发消息后,务必在终端用 `openclaw pairing approve` 完成配对,否则消息不会被处理。
❌ 在Windows上直接安装(非WSL2)
✅ 官方强烈推荐Windows用户使用WSL2(Windows Subsystem for Linux)环境运行,可避免许多兼容性问题。
❌ 忘记启动网关服务
✅ 安装向导通常会配置好后台服务。如果助手无响应,运行 `openclaw status` 检查网关是否在运行,或用 `openclaw start` 启动。
🚀 Next Steps
成功运行基础助手后,可以:1. 连接更多频道(如Discord、Slack)。2. 探索“技能”(Skills)并尝试安装新功能。3. 了解“多智能体路由”,为不同联系人或群组分配不同的助手角色。4. 尝试配置“语音唤醒”或“Live Canvas”等高级功能。5. 阅读项目源码结构,尝试进行简单的自定义修改。

