Ubuntu 服务器部署 OpenClaw 完整指南

Posted on Sat 21 March 2026 in AI工具

前言

OpenClaw 是一个开源的 AI Agent 平台，可以连接各种 LLM（大语言模型）并提供丰富的技能生态系统。部署在 Ubuntu 服务器上后，你可以通过飞书、Discord、WhatsApp 等渠道与 AI 助手对话，还能安装 ClawHub 上的各种技能插件，让它帮你管理邮件、查询股票、操作浏览器等等。

本文记录了我在 Ubuntu 服务器上部署 OpenClaw 的完整过程，希望对你有帮助。

环境准备

服务器要求

操作系统：Ubuntu 22.04+（推荐 24.04 LTS）
内存：至少 1GB，推荐 2GB+
存储：10GB+
网络：能访问 GitHub 和飞书 API

基础依赖

# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装必要工具
sudo apt install -y git curl build-essential

# 安装 Node.js（OpenClaw 需要 Node 22+）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node -v  # v22.x+
npm -v

安装 OpenClaw

OpenClaw 提供了一键安装脚本，非常方便：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

安装完成后验证：

openclaw --version
# OpenClaw 2026.x.x

提示：如果安装脚本因为网络问题失败，也可以通过 npm 手动安装： bash npm install -g openclaw

配置 Gateway

OpenClaw 的核心是 Gateway 服务，负责管理会话、连接渠道和技能。

初始化配置

# 启动 Gateway（首次会引导你配置）
openclaw gateway start

配置 LLM 提供商

OpenClaw 支持多种 LLM 提供商。以智谱（GLM）为例：

编辑配置文件（通常在 ~/.openclaw/agents/main/agent/ 目录下），添加模型配置：

# 查看当前配置
openclaw status

OpenClaw 会通过 Web 界面或 CLI 引导你配置 API Key。

常用 Gateway 命令

openclaw gateway start    # 启动
openclaw gateway stop     # 停止
openclaw gateway restart  # 重启
openclaw gateway status   # 状态检查

连接飞书

飞书是国内最常用的协作平台，OpenClaw 提供了飞书插件，支持消息收发、日历管理、多维表格操作等。

安装飞书插件

# 克隆飞书扩展
git clone https://github.com/openclaw-lark/openclaw-lark.git ~/.openclaw/extensions/openclaw-lark
cd ~/.openclaw/extensions/openclaw-lark
npm install

配置飞书应用

在飞书开放平台创建一个应用
获取 App ID 和 App Secret
配置事件订阅（消息接收地址）
配置权限（消息发送、日历、多维表格等）

验证连接

配置完成后，在飞书里给应用发消息测试。如果能正常回复，说明连接成功。

安装 ClawHub 技能插件

ClawHub 是 OpenClaw 的技能市场（clawhub.ai），有大量社区贡献的技能。

安装方式

大多数技能可以通过下载 zip 直接安装：

# 通用安装方式
curl -L -o /tmp/skill.zip "https://wry-manatee-359.convex.site/api/v1/download?slug=技能名" 
unzip -o /tmp/skill.zip -d ~/.openclaw/skills/技能名/
cd ~/.openclaw/skills/技能名 && npm install  # 如果需要

推荐技能

以下是我在实际使用中安装的技能，按用途分类：

📧 邮件管理

imap-smtp-email — 通过 IMAP/SMTP 收发邮件

# 安装
curl -L -o /tmp/imap-smtp-email.zip "https://wry-manatee-359.convex.site/api/v1/download?slug=imap-smtp-email"
unzip -o /tmp/imap-smtp-email.zip -d ~/.openclaw/skills/imap-smtp-email
cd ~/.openclaw/skills/imap-smtp-email && npm install

配置邮箱账号（创建 ~/.config/imap-smtp-email/.env）：

IMAP_HOST=imap.163.com
IMAP_PORT=993
IMAP_USER=[email protected]
IMAP_PASS=your_password
IMAP_TLS=true

SMTP_HOST=smtp.163.com
SMTP_PORT=465
SMTP_USER=[email protected]
SMTP_PASS=your_password
SMTP_TLS=true

支持多账号配置，比如同时配置 163 邮箱和 QQ 邮箱。

📊 预测市场

polymarket-trade — 查询 Polymarket 预测市场数据

pip3 install requests
# 下载安装（同上方式）

无需 API Key，直接查询热门市场和价格趋势。

📈 股票分析

stock-analysis — 股票数据查询和分析

pip3 install yfinance
# 下载安装

🎬 视频工具

youtube-watcher — 获取 YouTube 视频字幕/转录

pip3 install youtube-transcript-api

video-frames — 视频抽帧（内置技能，无需安装）

📝 内容工具

summarize — 总结 URL、PDF、YouTube 内容

npm install -g @steipete/summarize
# 配置 API Key（支持智谱）
export Z_AI_API_KEY="your_key"

nano-pdf — 编辑 PDF 文件

🌐 浏览器自动化

browser-use — AI 驱动的浏览器操作

uv tool install browser-use

agent-browser — Stagehand 浏览器自动化

🤖 自我进化

self-improving-agent — AI Agent 自我学习能力

evolver — 运行时历史分析，识别改进点

验证已安装技能

openclaw skills check

安装 Claude Code（开发辅助）

如果你的服务器安装了 Claude Code，OpenClaw 可以调用它来完成复杂的开发任务。

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证
claude --version

使用时可以通过 --dangerously-skip-permissions 参数跳过权限确认：

claude --dangerously-skip-permissions -p "你的指令"

这样 OpenClaw 调用 Claude Code 时就不会卡在权限确认上了。

性能优化

如果你的服务器配置较低（1GB 内存或 ARM 设备），可以进行以下优化：

Node.js 编译缓存

echo 'export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' >> ~/.bashrc
echo 'mkdir -p /var/tmp/openclaw-compile-cache' >> ~/.bashrc
source ~/.bashrc

systemd 服务优化

sudo systemctl edit openclaw

添加以下配置：

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

常见问题

Q: 安装时报 GitHub 限流？

A: 配置 GitHub Token：

gh auth login

或者设置环境变量：

export GITHUB_TOKEN="your_token"

Q: 浏览器技能报 socksio 错误？

A: 这是因为服务器配置了 socks5 代理。可以在 skill 的启动脚本中清除 all_proxy 环境变量，或者将代理改为 http 协议。

Q: MySQL 8.0 连接报 2002 错误？

A: 通常是 MySQL 8.0 默认使用 caching_sha2_password 认证，旧客户端不兼容。可以改为 mysql_native_password：

ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
FLUSH PRIVILEGES;

Q: Python 3.14 兼容性问题？

A: 一些 Python 脚本中 argparse 的 help 字符串包含 %，在 Python 3.14+ 中会报错。需要将 % 转义为 %%。

总结

OpenClaw 部署到 Ubuntu 服务器后，配合 ClawHub 的技能生态，可以打造一个功能强大的 AI 助手。核心步骤：

安装 OpenClaw — 一键脚本
配置 LLM — 选择你喜欢的模型提供商
连接渠道 — 飞书、Discord、WhatsApp 等
安装技能 — 从 ClawHub 按需安装
性能优化 — 针对低配服务器调整

如果你也在搭建自己的 AI 助手，欢迎交流！

相关链接： - OpenClaw GitHub - ClawHub 技能市场 - OpenClaw 文档 - OpenClaw Discord 社区

Previous Post Next Post

前言