Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
💡 Use Cases
适合需要完全控制数据、跨多个通讯平台使用、且希望深度定制AI工作流的个人开发者或小团队。
跨平台个人AI助手
Problem: 开发者需要在多个即时通讯平台(如WhatsApp、Telegram、Slack)上使用AI助手,但不想依赖云端服务或担心隐私泄露。
Solution: 在本地部署OpenClaw,通过网关连接所有支持的通讯渠道,实现一个统一的、数据完全由自己控制的AI助手。
Example: 在Telegram上让助手帮忙规划周末行程,在Slack上让它总结工作群聊要点,在Discord上让它生成代码片段,所有对话历史都保存在本地设备上。
本地化AI工作流集成
Problem: 开发者希望将AI能力深度集成到日常工作流中,但现有云端AI服务响应慢、有使用限制,且无法访问本地文件或执行本地操作。
Solution: 部署OpenClaw作为常驻后台服务,利用其支持长上下文和本地技能扩展的能力,创建个性化的自动化工作流。
Example: 通过iMessage让助手读取本地文档并生成摘要,在Slack中让它执行本地脚本处理数据,或通过语音指令让它在macOS上打开特定应用并执行任务。
安全可控的团队协作助手
Problem: 团队需要在内部协作工具(如Microsoft Teams、Google Chat)中使用AI助手,但担心敏感商业信息泄露给第三方AI服务商。
Solution: 在团队服务器上部署OpenClaw,配置仅限内部成员使用,所有对话数据都保留在可控环境中,实现安全的企业级AI协作。
Example: 在Microsoft Teams中设置一个仅供内部成员访问的OpenClaw频道,用于代码审查、文档生成、会议纪要整理等,完全避免数据外泄风险。
多模型智能切换与降级
Problem: 开发者依赖特定AI模型(如Claude Pro),但遇到API限制、服务中断或需要根据任务复杂度切换不同模型时操作繁琐。
Solution: 利用OpenClaw的模型配置和故障转移功能,设置主备模型策略,实现自动切换和智能降级,确保服务持续可用。
Example: 配置Claude Opus 4.5为主要模型处理复杂长文档分析,当达到使用限额时自动切换到GPT-4处理常规对话,所有切换对用户透明。
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 205,252
- Forks
- 37,403
- Today
- +4,201
- Ranking
- #6
- Collection
- Overall
- Trending Date
- February 17, 2026
- Last Push
- 2/17/2026
🏷️ Topics
5分钟上手 OpenClaw 个人AI助手
通过本指南,您将在5分钟内完成OpenClaw的安装、配置,并启动您的私有化AI助手网关。
🖥️ OS
⚙️ Runtime
🔧 Tools
📝 Steps
安装OpenClaw CLI
使用npm全局安装OpenClaw命令行工具。
全局安装OpenClaw
$ npm install -g openclaw运行配置向导
启动交互式配置向导,这是推荐的快速配置路径。
启动配置向导
$ openclaw onboard跟随向导完成基础配置
在向导中,您需要: 1. 配置网关(控制中心)。 2. 设置一个工作区。 3. 选择一个AI模型提供商(如Anthropic或OpenAI)并进行OAuth授权。 4. 选择一个初始通信通道(如WebChat用于测试)。
验证安装与连接
检查网关服务状态并测试基础功能。
诊断系统状态和配置
$ openclaw doctor✅ 验证成功
完成以上步骤后,您的OpenClaw私有AI助手网关已成功部署并运行在本地。
- ✓`openclaw onboard` 向导成功完成,无报错退出。
- ✓`openclaw doctor` 命令显示网关服务状态为运行中(running)。
- ✓您可以通过配置的初始通道(如WebChat)与您的AI助手进行交互。
⚡ Quick Tips
🔍 Troubleshooting
❓ 安装 `openclaw` 时出现权限错误(EACCES)。
→ 尝试使用 `sudo npm install -g openclaw`(不推荐),或更好的是按照Node.js官方指南修复npm的全局安装权限。
❓ 运行 `openclaw onboard` 或 `openclaw` 命令提示“命令未找到”。
→ 确保Node.js已正确安装且版本>=22,并检查npm全局安装路径是否已添加到系统的PATH环境变量中。
❓ 向导中模型授权(OAuth)失败。
→ 确保您拥有对应服务(如Anthropic, OpenAI)的有效订阅账户。检查网络连接,或稍后重试。
❓ 网关服务启动失败。
→ 运行 `openclaw doctor` 查看详细错误。检查端口是否被占用,或尝试重启电脑后再次运行 `openclaw start`。
🎯 Next Steps
探索更多通信通道
前往配置,添加 WhatsApp、Telegram、Slack 等您常用的通信工具。
配置语音功能
在支持macOS/iOS/Android的设备上,设置语音唤醒和对话模式。
挂载技能(Tools)
为您的助手添加浏览器、画布、定时任务等扩展能力。
阅读完整文档
访问项目网站和DeepWiki,深入了解高级功能和配置选项。
Difficulty
初级
Est. Time
3-4小时
Target Audience
对个人AI助手感兴趣、有一定编程基础但可能没有Node.js/TypeScript项目经验的开发者,希望将AI助手私有化部署到个人设备并集成到日常通讯工具中
🎯 What You'll Learn
能够在个人设备上成功部署OpenClaw AI助手,配置至少一个通讯渠道(如Telegram或WhatsApp),并让AI助手响应你的消息
📋 Prerequisites
OpenClaw基于Node.js运行,需要知道如何安装Node.js和使用npm/pnpm/bun等包管理器
项目主要通过CLI命令行工具进行配置和管理,需要熟悉终端基本操作
需要从GitHub克隆项目或通过npm安装
项目使用TypeScript开发,但作为使用者只需了解基本概念,配置主要通过CLI向导完成
可选,如果选择Docker方式部署需要了解Docker基础
📚 Resources
Getting Started 指南
官方完整的新手入门教程,包含详细步骤和截图
Models 配置指南
如何配置不同的AI模型和认证方式
Security 安全指南
了解OpenClaw的安全默认设置和最佳实践
Discord 社区
官方Discord服务器,可以提问和获取帮助
DeepWiki
项目的深度技术文档和架构说明
🗺️ Learning Phases
环境准备与安装
安装Node.js 22+
确保系统已安装Node.js 22或更高版本,可通过node -v命令检查
选择包管理器
安装npm、pnpm或bun中的任意一个,推荐使用pnpm
安装OpenClaw CLI
通过包管理器全局安装OpenClaw命令行工具:npm install -g openclaw 或 pnpm add -g openclaw
快速启动与向导配置
运行入门向导
执行 openclaw onboard 命令,跟随交互式向导完成初始配置
配置网关和工作区
在向导中设置网关(控制中心)和创建工作区(AI助手的工作环境)
选择并配置AI模型
选择AI服务提供商(推荐Anthropic Claude Pro/Max或OpenAI),并按照向导提示完成API密钥或OAuth认证
连接通讯渠道
选择第一个通讯渠道
从支持的渠道中选择一个开始配置,推荐从Telegram或WebChat开始(相对简单)
配置Telegram Bot(示例)
1. 在Telegram中联系@BotFather创建新bot 2. 获取API token 3. 在OpenClaw向导中输入token
测试基础功能
向配置好的渠道发送消息,检查OpenClaw是否正常响应
基础使用与安全配置
了解配对机制
学习OpenClaw的安全策略:默认情况下,陌生人的私信需要配对验证
批准配对请求
使用 openclaw pairing approve <code> 命令批准特定用户的访问
运行健康检查
执行 openclaw doctor 检查配置是否有安全问题或错误
⚠️ Common Mistakes
❌ Node.js版本过低
✅ 确保安装Node.js 22或更高版本,使用 node -v 检查,如果版本低请升级
❌ 跳过向导直接手动配置
✅ 新手强烈建议使用 openclaw onboard 向导,避免复杂的配置文件编辑
❌ API密钥配置错误
✅ 仔细检查API密钥是否正确,确保有足够的额度,并确认服务商区域设置正确
❌ 忘记启动网关服务
✅ 安装后网关可能未自动启动,可以运行 openclaw gateway start 手动启动
❌ 未处理配对请求
✅ 如果AI助手不回复消息,检查是否有待处理的配对请求需要批准
❌ 防火墙或网络问题
✅ 确保本地端口未被防火墙阻止,检查网络连接是否正常
🚀 Next Steps
掌握基础部署后,可以探索:1. 配置更多通讯渠道(如WhatsApp、Slack) 2. 启用语音功能(需要ElevenLabs API) 3. 尝试Live Canvas可视化功能 4. 学习技能扩展开发 5. 配置多代理路由 6. 部署到移动设备(iOS/Android)

