Ubuntu 服务器部署 OpenClaw 完整指南

Sat, 21 Mar 2026 21:46:00 +0800

前言

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=your@email.com
IMAP_PASS=your_password
IMAP_TLS=true

SMTP_HOST=smtp.163.com
SMTP_PORT=465
SMTP_USER=your@email.com
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 助手，欢迎交流！

相关链接：

Ubuntu on heyaohua's Blog