
OpenClaw 是一款运行在您个人设备上的 AI 助手。它能通过您日常使用的各类渠道(包括
WhatsApp、Telegram、Slack、Discord、Google
Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft
Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology
Chat、Tlon、Twitch、Zalo、Zalo Personal、微信及 WebChat)为您提供应答服务。在 macOS、iOS 和
Android
平台上,它具备语音交互能力(能说会听),并可实时呈现一个由您掌控的“画布”(Canvas)。请注意,“网关”(Gateway)仅作为控制层存在,而该产品的核心实体,正是这款
AI 助手本身。

OpenClaw无疑是2026年初最火的工具,本文介绍Ubuntu下如何安装,安装之前再次提醒风险!
| 组件 | 要求 |
|---|---|
| 操作系统 | Ubuntu 20.04 LTS 或更高版本 |
| Node.js | ≥ 22.0.0(必需) |
| 内存 | 至少 4GB RAM(建议 8GB) |
| 存储 | 至少 2GB 可用空间 |
| 网络 | 稳定的互联网连接 |
1、Node.js 版本检查
在安装 OpenClaw 之前,请确保您的系统已安装 Node.js ≥ 22:
# 检查 Node.js 版本
node --version
如果版本低于 22,请先安装或升级 Node.js
使用 nvm 安装(推荐)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
2、支持的包管理器
OpenClaw 支持以下包管理器:
- npm (推荐)
- pnpm (备用)
- Bun (用于从源码运行 TypeScript)
建议提前部署,也可以只装npm。
3、安装步骤
方法一:使用 npm 安装(推荐)
# 全局安装 OpenClaw
npm install -g openclaw@latest
# 验证安装
openclaw --version
方法二:使用 pnpm 安装
# 全局安装 OpenClaw
pnpm add -g openclaw@latest
# 验证安装
openclaw --version
方法三:从源码安装(开发版本)
如果您需要最新开发版本或想要贡献代码:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 安装依赖(推荐使用 pnpm)
pnpm install
# 构建项目
pnpm build
# 运行 onboarding 向导
pnpm openclaw onboard --install-daemon
安装验证
安装完成后,运行以下命令验证安装:
# 查看 OpenClaw 版本
openclaw --version
# 查看帮助信息https://www.ufans.top/usr/uploads/2026/03/736078646.pnghttps://www.ufans.top/usr/uploads/2026/03/736078646.pnghttps://www.ufans.top/usr/uploads/2026/03/736078646.png
openclaw --help
4、配置向导
1)启动配置向导
OpenClaw 提供了一个交互式的配置向导,帮助您完成初始设置:
# 启动配置向导并安装守护进程
openclaw onboard --install-daemon
2)配置向导流程
配置向导会引导您完成以下步骤:
OpenClaw Onboarding Wizard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- 配置模型 (anthropic/claude-opus-4-5)
- 配置工作区 (~/.openclaw/workspace)
- 配置通道 (WhatsApp/Telegram/Slack/Discord)
- 安装 Gateway 守护进程
- 完成
步骤 1:配置 AI 模型
OpenClaw 支持多种 AI 模型,官方推荐:
Anthropic Claude Pro/Max (推荐) + Opus 4.5
OpenAI ChatGPT/Codex
配置示例(~/.openclaw/openclaw.json):
{
agent: {
model: "anthropic/claude-opus-4-5",
},
}
步骤 2:配置工作区
工作区是 OpenClaw 存储配置和文件的地方:
默认路径:~/.openclaw/workspace
配置文件:AGENTS.md, SOUL.md, TOOLS.md
步骤 3:配置消息通道
OpenClaw 支持多种消息平台:
平台 配置方式
WhatsApp pnpm openclaw channels login
Telegram 设置 TELEGRAM_BOT_TOKEN
Slack 设置 SLACK_BOT_TOKEN + SLACK_APP_TOKEN
Discord 设置 DISCORD_BOT_TOKEN
Signal 需要 signal-cli
iMessage 通过 BlueBubbles 推荐
步骤 4:安装 Gateway 守护进程
守护进程确保 Gateway 在后台持续运行:
# 安装守护进程
openclaw onboard --install-daemon
# 手动启动 Gateway
openclaw gateway --port 18789 --verbose
启动 Gateway
配置完成后,启动 Gateway:
# 前台运行
openclaw gateway --port 18789 --verbose
# 或使用后台模式
openclaw gateway --port 18789
Gateway 默认监听:ws://127.0.0.1:18789
其余配置涉及API的获取以及设置请参考官网文档!