Appearance
开始安装
本文档带你从零开始安装 OpenClaw 到你的服务器。
安装 Node.js
如果你还没有安装 Node.js，请先安装：
bash
# Debian/Ubuntu
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs验证版本：
bash
node --version # 应该输出 v22.x 或更高
npm --version更多细节请看 系统要求。
安装 OpenClaw
使用 npm 全局安装：
bash
npm install -g openclaw@latest等待安装完成。安装完成后验证：
bash
openclaw --version应该输出版本号，比如 1.0.0。
初始化工作区
安装完成后，第一次运行需要初始化工作区：
bash
openclaw onboard这个命令会：
- 创建
~/.openclaw/工作区目录 - 生成默认配置文件
- 初始化数据库
如果你想让 OpenClaw 作为系统服务开机启动，加上 --install-daemon 参数：
bash
openclaw onboard --install-daemon配置通道
初始化完成后，需要配置你想要使用的聊天通道。
OpenClaw 支持多种通道：
- 飞书 - 自建应用，适合国内用户
- Telegram - 需要 Bot Token
- Discord - 需要 Bot Token
- WhatsApp - 基于 web.js 配对
- 更多... 请查看 通道配置
以飞书为例，你需要：
- 在飞书开发者后台创建应用
- 获取 App ID 和 App Secret
- 配置事件回调地址
- 使用
openclaw channels login feishu登录
详细配置说明请看各个通道的文档。
启动网关
配置完成后，启动 Gateway：
如果你安装了系统服务：
bash
sudo systemctl start openclaw
sudo systemctl enable openclaw如果你想直接在前台运行测试：
bash
openclaw gateway --port 18789默认端口是 18789。
打开控制面板
启动成功后，在浏览器打开控制面板：
http://your-server-ip:18789/在这里你可以：
- 查看会话列表
- 管理配置
- 直接和 AI 对话
- 查看日志
验证安装
在你的聊天应用里发送一条消息给 OpenClaw Bot，如果收到回复，说明安装成功！
常见问题
npm 安装很慢
使用淘宝镜像加速：
bash
npm config set registry https://registry.npmmirror.com/然后重新安装。
权限错误
如果全局安装时报权限错误，可以使用：
bash
npm install -g openclaw@latest --unsafe-perm端口被占用
如果 18789 端口被占用，可以使用其他端口：
bash
openclaw gateway --port 28789