OpenClaw Linux 环境 完整安装部署文档

适配：Ubuntu 22.04 / ARM64 & X86_64、纯命令行部署、飞书机器人对接

一、前置依赖安装

1. 安装基础环境

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git

2. 安装 Node.js 22（必装）

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证
node -v
npm -v

二、OpenClaw 正式安装

方式一：官方一键安装（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

方式二：NPM 全局安装

npm install -g openclaw

三、初始化引导配置

openclaw onboard

交互式配置关键步骤：

1. 模型选择：填入 MiniMax API Key
2. 插件安装选择：

• 飞书插件：选择 Use local plugin path（本地插件，不下载）

3. 群聊权限：选择 Open - respond in all groups (requires mention)
4. 搜索服务：Skip for now 跳过
5. 技能依赖：全部勾选 Skip for now（Linux ARM 无法安装brew依赖，避免报错）
6. 钩子配置：按需勾选，一般只保留日志、记忆即可
7. 启动方式：选择 Hatch in Terminal 终端启动

四、飞书机器人专项配置

1. 弹出二维码，使用飞书/Lark 手机端扫码授权
2. 授权完成自动加载飞书通讯插件
3. 通讯规则：群聊需@机器人、私聊直接回复

五、日常启动 & 停止

启动 OpenClaw 控制台

openclaw tui

停止运行

终端直接按下 Ctrl + C 即可关闭

六、关键避坑点（你踩过的问题）

1. 不要安装 brew 相关依赖
   Linux/ARM 无Homebrew，勾选额外技能会全部安装失败
2. 编译/依赖报错
   所有额外语音、PDF、第三方技能一律跳过，轻量化运行
3. 机器人不回复

• 私聊测试优先
• 群聊必须@机器人
• 确认飞书扫码授权成功、插件加载正常

4. 全程不要用 sudo 全局强制安装，避免权限冲突

七、卸载清理

# 停止进程
pkill -f openclaw
# 删除配置缓存
rm -rf ~/.openclaw
# 卸载全局包
npm uninstall -g openclaw