一款开源AI助手，让AI直接住进你的微信、Telegram、飞书里！

---

一、OpenClaw是什么？

OpenClaw（小龙虾）是一款开源AI助手，最大的特点是：把AI直接接入你常用的聊天软件。

不用打开网页，不用切App，在微信、Telegram、飞书里直接跟AI对话，让它帮你处理各种任务。

核心优势：

• ✅ 开源免费，自己部署，数据在自己手里
• ✅ 支持多平台：微信、Telegram、飞书、Discord、WhatsApp等
• ✅ 可扩展：安装各种技能插件，功能无限
• ✅ 私有部署：不依赖第三方服务

---

二、安装前的准备

2.1 系统要求

• Linux：推荐 Ubuntu 20.04+
• macOS：10.15+
• Windows：WSL2（推荐）或 PowerShell

2.2 必备环境

需要安装 Node.js 18+

# 检查Node版本
node -v

# 如果没有安装，用nvm安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

图1：Node版本检查

---

三、安装OpenClaw

3.1 全局安装

npm install -g openclaw

安装完成后，验证：

openclaw --version
# 输出：OpenClaw 2026.3.24

图2：OpenClaw安装成功

3.2 初始化配置

openclaw setup --wizard

这会启动交互式配置向导，按提示操作即可。

---

四、启动Gateway（核心服务）

Gateway是OpenClaw的核心服务，负责处理消息和AI对话。

4.1 首次启动

openclaw gateway run --dev

--dev 参数会自动创建开发配置，适合首次体验。

4.2 查看状态

openclaw gateway status

正常输出应该显示：

Gateway: running
Port: 18789
Bind: loopback

图3：Gateway运行状态

---

五、连接聊天平台

5.1 Telegram（最简单）

1. 找 @BotFather 创建机器人
2. 获取Token
3. 添加配置：

openclaw channels add --channel telegram --token YOUR_BOT_TOKEN

5.2 飞书

1. 创建飞书应用，获取 App ID 和 App Secret
2. 配置事件订阅
3. 添加配置：

openclaw channels add --channel feishu --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

5.3 查看已连接的平台

openclaw channels list

图4：已连接的聊天平台

---

六、常见问题及解决方案

❌ 问题1：Gateway启动失败

错误信息：

Error: Gateway refused to start without gateway.mode=local

解决方案：

# 方法1：使用--allow-unconfigured参数
openclaw gateway run --allow-unconfigured

# 方法2：先运行setup初始化配置
openclaw setup --wizard
openclaw gateway run

❌ 问题2：端口被占用

错误信息：

Error: Port 18789 already in use

解决方案：

# 方法1：强制终止占用端口的进程
openclaw gateway run --force

# 方法2：使用其他端口
openclaw gateway run --port 18790

❌ 问题3：Node版本过低

错误信息：

Error: Node.js version 16.x is not supported

解决方案：

# 升级到Node 22
nvm install 22
nvm use 22
node -v  # 确认版本

❌ 问题4：npm安装失败

错误信息：

npm ERR! network timeout

解决方案：

# 切换国内镜像
npm config set registry https://registry.npmmirror.com
npm install -g openclaw

❌ 问题5：Telegram机器人不回复

排查步骤：

# 1. 检查Token是否正确
openclaw channels status --probe

# 2. 检查Gateway是否运行
openclaw gateway status

# 3. 查看日志
openclaw gateway logs

常见原因：Token配置错误、Gateway未启动、网络问题

❌ 问题6：飞书机器人无响应

排查步骤：

1. 确认事件订阅配置正确
2. 检查应用权限是否包含 im:message
3. 验证签名是否匹配

# 查看飞书通道状态
openclaw channels status --channel feishu --probe

# 查看详细日志
openclaw channels logs --channel feishu

❌ 问题7：模型调用失败

错误信息：

Error: Model not found or API key invalid

解决方案：

# 1. 检查模型配置
openclaw models list

# 2. 配置API密钥
openclaw models add --provider openai --api-key YOUR_KEY

❌ 问题8：技能安装失败

错误信息：

Error: Skill installation failed

解决方案：

# 检查技能是否存在
openclaw skills search SKILL_NAME

# 使用verbose模式查看详细错误
openclaw skills install SKILL_NAME --verbose

---

七、日常使用技巧

设置开机自启

# 安装为系统服务
openclaw gateway install

# 启动服务
openclaw gateway start

查看运行状态

# 快速检查
openclaw status

# 详细状态
openclaw gateway status --deep

更新OpenClaw

npm update -g openclaw
openclaw gateway restart

---

八、总结

OpenClaw是一款强大的开源AI助手，核心价值在于：

1. 隐私可控：自己部署，数据不外泄
2. 平台通用：微信、Telegram、飞书都能用
3. 功能可扩展：安装技能插件，无限可能
4. 使用便捷：在聊天软件里直接用AI

推荐新手路线：

1. 先用Telegram体验（最简单）
2. 熟悉后再接入飞书/微信
3. 根据需求安装技能插件

---

官方资源

官网 · 文档 · GitHub · 社区

小龙虾在手，AI我有！

有问题欢迎在评论区留言

OpenClaw AI助手 开源 效率工具 Telegram 飞书