OpenClaw Linux 部署教程
本文档详细介绍了 OpenClaw 在 Linux 环境下的部署流程。内容包括环境准备(Node.js、内存、API Key)、两种部署方案(阿里云一键部署与手动部署)、飞书机器人对接配置以及常见运维命令和故障排查。重点强调了虚拟内存配置、Node.js 版本要求及飞书权限开通步骤,帮助用户快速搭建本地 AI 智能体。

本文档详细介绍了 OpenClaw 在 Linux 环境下的部署流程。内容包括环境准备(Node.js、内存、API Key)、两种部署方案(阿里云一键部署与手动部署)、飞书机器人对接配置以及常见运维命令和故障排查。重点强调了虚拟内存配置、Node.js 版本要求及飞书权限开通步骤,帮助用户快速搭建本地 AI 智能体。

OpenClaw 是运行在本地服务器上的高权限 AI 智能体,相比云端 SaaS 服务,其核心优势在于:
| 项目 | 要求 | 备注 |
|---|---|---|
| 操作系统 | Linux (推荐) / macOS / Windows (WSL2) | 本文以 Linux 为例 |
| Node.js | ≥ 22.x | 必须,低版本会安装失败 |
| 内存 | ≥ 2GB (建议 4GB) | 2GB 内存必须配置虚拟内存 |
| 网络 | 可访问 GitHub, npm | 国内服务器建议配置镜像源或代理 |
| AI 模型 | 通义千问 (Qwen) / OpenAI 等 API Key | 推荐通义千问,有免费额度 |
如果您使用阿里云轻量应用服务器,可使用此方案,快速完成。
18789。http://公网 IP:18789 访问。适合所有 Linux 环境,步骤稍多但灵活性更高。
1. 安装 Git
sudo apt update && sudo apt install git -y && git --version
2. 安装 Node.js (v22+)
推荐使用 NVM 管理版本:
# 国内用户使用 Gitee 镜像源安装 NVM
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 加载环境变量
source ~/.bashrc
# 安装并使用 Node.js 22
nvm install 22
nvm use 22
# 验证版本
node -v # 应显示 v22.x.x
npm -v
3. 配置虚拟内存 (2GB 内存服务器必做)
防止安装过程中因内存不足 (OOM) 导致失败:
# 创建 2G 交换文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 设置开机自动挂载
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# 验证
free -h
执行官方一键安装脚本:
curl -fsSL https://openclaw.bot/install.sh | bash
注意:首次安装耗时约 5-10 分钟,请勿中断。若提示
npm install failed,请检查虚拟内存是否生效。
安装完成后会自动进入向导 (openclaw onboard),按以下步骤操作:
Yes 确认知晓风险。QuickStart (快速配置)。Qwen (OAuth) (通义千问)。Keep current 保持默认模型。Skip for now (稍后单独配置飞书)。No (稍后安装)。Hatch in TUI 进入终端聊天测试。
Hello 测试响应。Ctrl + C 退出终端界面。OpenClaw 默认监听本地端口 18789,需通过 SSH 隧道访问:
获取带 Token 的链接 (在服务器终端执行):
openclaw dashboard
本地终端执行 (替换为您的用户名和 IP):
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器公网IP
contact:user.base:readonly (获取用户信息)im:message (发送接收消息,勾选全部子项)im:chat (获取群组信息)im.message.receive.v1 (接收消息)。Feishu/Lark (飞书)。Download from npm 安装插件。Feishu (feishu.cn)。Open (允许在所有群被 @ 响应)。Open。重启服务:
配置完成后,务必重启网关使配置生效:
openclaw gateway restart
报错处理:若提示 Cannot find module 'zod',请重新进入配置向导:
openclaw onboard
(依次确认安全风险、QuickStart 模式、模型配置,直到通道选择页)
在飞书中搜索机器人名称,发送 Hello,若收到回复即表示对接成功。
| 命令 | 功能描述 |
|---|---|
openclaw status | 查看运行状态 |
openclaw dashboard | 获取 Web 面板访问链接 |
openclaw gateway restart | 重启服务 (修改配置后必用) |
openclaw onboard | 重新进入配置向导 |
openclaw update | 更新到最新版本 |
openclaw doctor | 诊断并修复常见问题 |
openclaw skills install <名字> | 安装新技能插件 |
openclaw uninstall | 卸载 OpenClaw |
npm install failed 或卡住?free -h 查看 Swap 行)。若未配置,请按 4.1.3 步骤配置后重试。im:message 等权限是否已开通?openclaw gateway restart?查看日志:
# 查看技能运行日志
docker exec -it openclaw-2026 tail -f /opt/openclaw/logs/skills/run.log
# 或者查看系统日志
journalctl -u openclaw-gateway -f
openclaw dashboard 获取最新带 Token 的链接。openclaw 命令提示 command not found?source ~/.bashrc 刷新环境变量,或关闭终端重开。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online