Ubuntu 部署 OpenClaw 完整指南
⚠️ 声明：本文内容由 AI 总结生成，仅供参考。
什么是 OpenClaw？
OpenClaw 是一个多渠道 AI 网关，支持多种消息平台集成（如飞书、Discord、Telegram 等），可以让你通过统一的接口管理和使用 AI 能力。
主要特性：
- 多渠道消息支持
- 可扩展的技能系统 (Skills)
- 支持多种 AI 模型
- 灵活的配置管理
环境要求
- 操作系统：Ubuntu 20.04+ 或其他 Linux 发行版
- Node.js：v18.0.0 或更高版本
- npm 或 yarn
安装步骤
1. 安装 Node.js
# 使用 NodeSource 安装 Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version
2. 全局安装 OpenClaw
# 通过 npm 安装
npm install -g openclaw
# 验证安装
openclaw --version
3. 初始化配置
# 创建配置目录
mkdir -p ~/.openclaw/config
# 初始化配置
openclaw configure
4. 配置 AI 模型
编辑 ~/.openclaw/config/models.json 文件，添加你的 AI 模型配置：
{
"models": {
"default": "openai",
"openai": {
"provider": "openai",
"apiKey": "your-api-key"
}
}
}
5. 启动 Gateway 服务
# 前台运行
openclaw gateway start
# 或使用 systemd 管理（推荐）
openclaw gateway enable
openclaw gateway start
配置消息渠道
OpenClaw 支持多种消息渠道，以下是常用配置：
飞书配置
{
"feishu": {
"appId": "your-app-id",
"appSecret": "your-app-secret"
}
}
Telegram 配置
{
"telegram": {
"botToken": "your-bot-token"
}
}
技能系统 (Skills)
OpenClaw 的技能系统允许你扩展 AI 的能力。
安装技能
# 搜索技能
clawhub search <skill-name>
# 安装技能
clawhub install <skill-name>
创建自定义技能
在 ~/.openclaw/skills/ 目录下创建技能文件夹。
常用命令
| 命令 | 说明 |
|---|---|
openclaw status | 查看服务状态 |
openclaw gateway start | 启动 Gateway |
openclaw gateway stop | 停止 Gateway |
openclaw configure | 配置向导 |
clawhub search | 搜索技能 |
clawhub install | 安装技能 |
进阶配置
使用 systemd 管理
创建 systemd 服务文件 /etc/systemd/system/openclaw.service：
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
User=your-username
WorkingDirectory=/home/your-username
ExecStart=/usr/bin/openclaw gateway start
Restart=on-failure
[Install]
WantedBy=multi-user.target
启用服务：
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
反向代理配置 (Nginx)
server {
listen 80;
server_name your-domain.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
}
}
相关链接
- 官方文档：https://docs.openclaw.ai
- GitHub：https://github.com/openclaw/openclaw
- 技能市场：https://clawhub.com
- 社区：https://discord.com/invite/clawd
本文由 AI 自动生成于 2026-03-04，内容可能存在更新不及时的情况，请以官方文档为准。
评论区