OpenClaw入门教程：从安装到上手的完整指南

作者：CSDN博客
一款开源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+

1. # 检查Node版本
2. node -v
4. # 如果没有安装，用nvm安装
5. curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
6. nvm install 22
7. nvm use 22

复制代码

图1：Node版本检查

---

三、安装OpenClaw

3.1 全局安装

1. npm install -g openclaw

复制代码

安装完成后，验证：

1. openclaw --version
2. # 输出：OpenClaw 2026.3.24

复制代码

图2：OpenClaw安装成功
3.2 初始化配置

1. openclaw setup --wizard

复制代码

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

---

四、启动Gateway（核心服务）

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

1. openclaw gateway run --dev

复制代码

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

1. openclaw gateway status

复制代码

正常输出应该显示：

1. Gateway: running
2. Port: 18789
3. Bind: loopback

复制代码

图3：Gateway运行状态

---

五、连接聊天平台

5.1 Telegram（最简单）

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

1. openclaw channels add --channel telegram --token YOUR_BOT_TOKEN

复制代码

5.2 飞书

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

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

复制代码

5.3 查看已连接的平台

1. openclaw channels list

复制代码

图4：已连接的聊天平台

---

六、常见问题及解决方案

❌ 问题1：Gateway启动失败

错误信息：

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

复制代码

解决方案：

1. # 方法1：使用--allow-unconfigured参数
2. openclaw gateway run --allow-unconfigured
4. # 方法2：先运行setup初始化配置
5. openclaw setup --wizard
6. openclaw gateway run

复制代码

❌ 问题2：端口被占用

错误信息：

1. Error: Port 18789 already in use

复制代码

解决方案：

1. # 方法1：强制终止占用端口的进程
2. openclaw gateway run --force
4. # 方法2：使用其他端口
5. openclaw gateway run --port 18790

复制代码

❌ 问题3：Node版本过低

错误信息：

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

复制代码

解决方案：

1. # 升级到Node 22
2. nvm install 22
3. nvm use 22
4. node -v  # 确认版本

复制代码

❌ 问题4：npm安装失败

错误信息：

1. npm ERR! network timeout

复制代码

解决方案：

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

复制代码

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

排查步骤：

1. # 1. 检查Token是否正确
2. openclaw channels status --probe
4. # 2. 检查Gateway是否运行
5. openclaw gateway status
7. # 3. 查看日志
8. openclaw gateway logs

复制代码

常见原因：Token配置错误、Gateway未启动、网络问题
❌ 问题6：飞书机器人无响应

排查步骤：

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

1. # 查看飞书通道状态
2. openclaw channels status --channel feishu --probe
4. # 查看详细日志
5. openclaw channels logs --channel feishu

复制代码

❌ 问题7：模型调用失败

错误信息：

1. Error: Model not found or API key invalid

复制代码

解决方案：

1. # 1. 检查模型配置
2. openclaw models list
4. # 2. 配置API密钥
5. openclaw models add --provider openai --api-key YOUR_KEY

复制代码

❌ 问题8：技能安装失败

错误信息：

1. Error: Skill installation failed

复制代码

解决方案：

1. # 检查技能是否存在
2. openclaw skills search SKILL_NAME
4. # 使用verbose模式查看详细错误
5. openclaw skills install SKILL_NAME --verbose

复制代码

---

七、日常使用技巧

设置开机自启

1. # 安装为系统服务
2. openclaw gateway install
4. # 启动服务
5. openclaw gateway start

复制代码

查看运行状态

1. # 快速检查
2. openclaw status
4. # 详细状态
5. openclaw gateway status --deep

复制代码

更新OpenClaw

1. npm update -g openclaw
2. openclaw gateway restart

复制代码

---

八、总结

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

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

推荐新手路线：

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

---

官方资源
官网 · 文档 · GitHub · 社区
小龙虾在手，AI我有！
有问题欢迎在评论区留言
OpenClaw AI助手 开源 效率工具 Telegram 飞书

原文地址：https://blog.csdn.net/qq5649293/article/details/159513057