Ubuntu下安装OpenClaw，打造专属本地AI助手
Ubuntu下安装OpenClaw，打造专属本地AI助手
这两天出差，上周已经搭好的环境，正好周末有时间分享下。有问题的同学可以直接找我，包教包会。
先简单科普下：OpenClaw是一款开源的跨平台个人AI助手，核心优势是本地部署、多渠道联动，支持对接Anthropic Claude、OpenAI，还有国内豆包，Kimi等模型，还能通过插件扩展功能；搭配飞书插件后，我们可以直接在飞书私聊或群聊中下达指令，让AI帮我们处理文档、执行命令、查询信息，大幅提升工作效率。本文适配22.04版本（其它版本没试过），全程实操可复制，新手也能跟着走，建议收藏后再操作！
一、前置准备（必做）
安装OpenClaw前，需要先配置好基础依赖，重点是Node.js环境（要求版本≥22），否则会安装失败哦 🚨
1. 系统更新（确保依赖兼容）
打开Ubuntu终端（快捷键Ctrl+Alt+T），执行以下命令更新系统软件包，避免后续安装出现依赖冲突：sudo apt update && sudo apt upgrade -y
2. 安装Node.js（≥22版本，推荐用nvm）
不建议用Ubuntu默认的apt安装Node.js（版本过低），推荐用nvm（Node版本管理工具）安装，方便后续切换版本，步骤如下：安装nvm：可以去 https://github.com/nvm-sh/nvm 安装最新版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
生效nvm（无需重启终端，执行命令即可）：source ~/.bashrc安装Node.js 22（我用的是23）：nvm install 22设置默认使用Node.js 22：nvm use 22验证安装（显示版本号≥22即为成功）：node --version
二、安装OpenClaw（3种方式，我采用的是方式1）
OpenClaw支持脚本安装、npm/pnpm安装、源码安装3种方式，新手优先选脚本安装，一键完成，无需复杂配置；有开发需求的可以选源码安装。
方式1：脚本一键安装（新手首选）
终端执行以下命令，自动下载并安装最新稳定版OpenClaw：curl -fsSL https://openclaw.ai/install.sh | bash
方式2：npm/pnpm全局安装（备选）
如果脚本安装失败，可尝试用npm或pnpm安装（已安装Node.js，默认自带npm）：npm安装：npm install -g openclaw@latestpnpm安装（需先安装pnpm：npm install -g pnpm）：pnpm add -g openclaw@latest
方式3：源码安装（开发版，适合进阶用户）
如果需要最新开发功能或贡献代码，可通过源码安装：克隆仓库：git clone https://github.com/openclaw/openclaw.git进入目录：cd openclaw安装依赖（推荐pnpm）：pnpm install构建项目：pnpm build
验证OpenClaw安装
安装完成后，执行以下命令，显示版本号即为安装成功：openclaw --version
三、OpenClaw基础配置与使用（快速上手）
安装完成后，无需复杂配置，通过新手引导向导即可快速完成基础设置，步骤如下：
1. 启动新手引导向导（必做）
终端执行命令，向导会一步步引导你完成模型配置、网关设置、后台服务安装：openclaw onboard --install-daemon跟着向导完成以下5步即可（全程交互式，按提示操作）：配置AI模型：选择自己的模型，按提示输入密钥完成授权；我这里是用公司内部的模型，用的是open completions兼容的api，这步跳过，后面直接修改~/.openclaw/openclaw.json的文件。
配置工作区：默认路径为~/.openclaw/workspace，无需修改，直接确认即可；配置通道：暂时跳过（后续专门配置飞书通道）；安装Gateway守护进程：确认安装，让Gateway在后台持续运行（开机自启）；完成配置：向导自动保存所有设置，无需手动操作。
2. 启动Gateway网关（核心组件）
Gateway是OpenClaw的控制中枢，负责管理所有插件和通道，新手引导中已安装守护进程，默认已启动，可通过以下命令验证：openclaw gateway status若显示“running”，说明网关正常运行；若未运行，执行命令启动：openclaw gateway start也可前台运行并查看日志（便于排查问题）：openclaw gateway --port 18789 --verbose启动后，可通过浏览器访问仪表盘：http://127.0.0.1:18789/（需输入网关令牌，默认存储在~/.openclaw/openclaw.json中）。
看到这个界面，说明搭建成功了。下期分享如何结合飞书的插件。