openclaw-logo

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
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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  1. 配置模型 (anthropic/claude-opus-4-5)
  2. 配置工作区 (~/.openclaw/workspace)
  3. 配置通道 (WhatsApp/Telegram/Slack/Discord)
  4. 安装 Gateway 守护进程
  5. 完成

步骤 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的获取以及设置请参考官网文档

最后修改:2026 年 03 月 31 日
如果觉得我的文章对你有用,请随意赞赏