Linux安装OpenClaw
Linux安装OpenClaw，核心是安装nodejs和openclaw，以及在安装完成后进行初始话配置。
安装要求
- Node 24（推荐）（出于兼容性考虑，仍支持 Node 22 LTS，目前为 22.16+；）
- Linux 支持
- 仅当你从源码构建时需要 pnpm（推荐不安装）
安装 Node.js
在 Linux 上安装 Node.js 时，默认会包含 corepack、node、npm 和 npx 工具命令。
安装方法有很多，比如：
- yum/dnf/apt 安装： Linux系统包管理工具安装的版本可能比较老旧。
- Nvm 安装： Nvm是 Node.js 的版本管理工具，可以安装和升级 node 版本。但是nvm自身安装依赖访问外网。
- 官方安装脚本： 官方默认安装脚本，也是先安装 nvm，需要访问GitHub
raw.githubusercontent.com。 - （推荐）官方安装包下载安装： 官方还提供了PKG安装包，可以离线安装。
nodejs官网可正常访问，因此可以直接访问官网下载 Linux 版本的 node 安装包。 https://nodejs.org/zh-cn/download
选择安装包并下载：
- 在页面上方选择 Node.js 版本，推荐选择
v24.14.1 LTS版本。 - 在页面下方选择操作系统（Linux）和CPU架构（x64和amd64一般是同一种架构，arm64和aarch64一般是同一种架构）
- 点击下载后上传到Linux服务器，或者右键复制下载链接。
例如，Linux ARM64 v24.14.1 LTS 版本下载地址：
# wget https://nodejs.org/dist/v24.14.1/node-v24.14.1-linux-x64.tar.xz
下载后的包解压到 /usr/local 目录下
# tar xf node-v24.14.1-linux-x64.tar.xz -C /usr/local
# ls /usr/local/node-v24.14.1-linux-x64/bin/
corepack node npm npx
解压后需要配置PATH环境变量
# echo $SHELL
/bin/bash
# echo 'export PATH="/usr/local/node-v24.14.1-linux-x64/bin:$PATH"' >> ~/.bashrc && . ~/.bashrc
第一条命令是查看当前的shell，第二条命令是添加PATH环境变量。如果是 /bin/zh ，则需要将 ~/.bashrc 替换为 ~/.zshrc。
安装完成后进行验证。使用命令node和npm进行操作了。
% node -v
v24.14.1
% npm -v
11.11.0
安装 OpenClaw
OpenClaw 是基于 Node.js 实现的，因此默认就会发布到 npm 仓库中。
NPM官方仓库在国内无法直接访问或者网络很慢，可以通过国内的镜像源进行加速。
安装 OpenClaw 命令如下：
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
安装没有报错就是安装成功，一般会有如下的输出，可以忽略提示和告警信息。
added 459 packages in 1m
84 packages are looking for funding
run `npm fund` for details
npm notice
npm notice New minor version of npm available! 11.11.0 -> 11.12.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.12.0
npm notice To update run: npm install -g npm@11.12.0
安装成功后，执行 openclaw -v 有版本输出则说明安装成功了。
# openclaw -v
OpenClaw 2026.3.24 (cff6dc9)
OpenClaw包安装路径
# which openclaw
/usr/local/node-v24.14.1-linux-x64/bin/openclaw
初始化
OpenClaw 安装完后，一般需要进行初始化配置。
其核心就是通过交互式引导，完成一些配置，生成 ~/.openclaw/openclaw.json 文件，如果熟悉该文件内容，也可以直接创建该文件，不需要进行交互式初始化。
openclaw onboard --install-daemon
交互式初始化过程说明：
- 安全警告，选择
yes。通过键盘左右键选择，回车确认。◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? │ ● Yes / ○ No - 设置运行模式模式，选择默认的
QuickStart。通过上下键选择，回车确认。
确认后进行默认的配置。默认的配置只能通过本地环回接口访问（localhost/127.0.0.1），如果需要跨机器访问，也可以在后续修改配置文件。◆ Setup mode │ ● QuickStart (Configure details later via openclaw configure.) │ ○ Manual◇ QuickStart ─────────────────────────╮ │ │ │ Gateway port: 18789 │ │ Gateway bind: Loopback (127.0.0.1) │ │ Gateway auth: Token (default) │ │ Tailscale exposure: Off │ │ Direct to chat channels. │ │ │ ├──────────────────────────────────────╯ - 模型提供商配置，选择最后一个
Skip for now跳过配置。提供大模型服务的厂商，后续单独进行模型配置。◆ Model/auth provider │ ○ Anthropic │ ○ BytePlus │ ○ Chutes │ ○ Cloudflare AI Gateway │ ○ Copilot │ ○ Custom Provider │ ○ DeepSeek │ ○ Google │ ○ Hugging Face │ ○ Kilo Gateway │ ○ Kimi Code │ ○ LiteLLM │ ○ MiniMax │ ○ Mistral AI │ ○ Moonshot AI (Kimi K2.5) │ ○ Ollama │ ○ OpenAI │ ○ OpenCode │ ○ OpenRouter │ ○ Qianfan │ ○ Qwen │ ○ Qwen (Alibaba Cloud Model Studio) │ ○ SGLang │ ○ Synthetic │ ○ Together AI │ ○ Venice AI │ ○ Vercel AI Gateway │ ○ vLLM │ ○ Volcano Engine │ ○ xAI (Grok) │ ○ Xiaomi │ ○ Z.AI │ ● Skip for now - 模型列表提供商，选择默认
All providers。这个配置后续配置模型时会镜像修改，主要用于在Web页面聊天窗口切换模型列表的选项。◆ Filter models by provider │ ● All providers │ ○ amazon-bedrock │ ○ anthropic │ ○ azure-openai-responses │ ○ cerebras │ ○ github-copilot │ ○ google │ ○ google-antigravity │ ○ google-gemini-cli │ ○ google-vertex │ ○ groq │ ○ huggingface │ ○ kimi-coding │ ○ minimax │ ○ minimax-cn │ ○ mistral │ ○ ollama │ ○ openai │ ○ openai-codex │ ○ opencode │ ○ opencode-go │ ○ openrouter │ ○ vercel-ai-gateway │ ○ xai │ ○ zai - 设置默认模型，选择一个模型作为默认模型，回车确认。这里主要是配置默认模型，后续调用模型时，如果没有指定模型，则使用默认模型。该配置后续会覆盖修改。
◆ Default model │ ● Keep current (default: anthropic/claude-opus-4-6) │ ○ Enter model manually │ ○ amazon-bedrock/anthropic.claude-3-haiku-20240307-v1:0 │ ○ amazon-bedrock/anthropic.claude-3-5-haiku-20241022-v1:0 │ ○ amazon-bedrock/anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/eu.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0 │ ○ amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0 ...... - 配置IM渠道，选择
Skip for now。这里主要是配置通过哪些渠道连接OpenClaw，如QQ、飞书、钉钉等，后面会单独进行配置。◆ Select channel (QuickStart) │ ○ Telegram (Bot API) │ ○ WhatsApp (QR link) │ ○ Discord (Bot API) │ ○ IRC (Server + Nick) │ ○ Google Chat (Chat API) │ ○ Slack (Socket Mode) │ ○ Signal (signal-cli) │ ○ iMessage (imsg) │ ○ LINE (Messaging API) │ ○ Feishu/Lark (飞书) │ ○ Nostr (NIP-04 DMs) │ ○ Microsoft Teams (Teams SDK) │ ○ Mattermost (plugin) │ ○ Nextcloud Talk (self-hosted) │ ○ Matrix (plugin) │ ○ BlueBubbles (macOS app) │ ○ Zalo (Bot API) │ ○ Zalo (Personal Account) │ ○ Synology Chat (Webhook) │ ○ Tlon (Urbit) │ ○ Twitch (Chat) │ ● Skip for now (You can add channels later via `openclaw channels add`) - 配置Web搜索服务，选择
Skip for now跳过。部分搜索需要注册配置APKEY才能使用，后续可单独配置。◆ Search provider │ ○ Brave Search │ ○ DuckDuckGo Search (experimental) │ ○ Exa Search │ ○ Firecrawl Search │ ○ Gemini (Google Search) │ ○ Grok (xAI) │ ○ Kimi (Moonshot) │ ○ Perplexity Search │ ○ Tavily Search │ ● Skip for now (Configure later with openclaw configure --section web) - 配置SKILL，选择
No。OpenClaw会有一些默认安装的SKILL，额外的SKILL可以通过 ClawHub 进行查询和安装，后续按需安装即可。◆ Configure skills now? (recommended) │ ○ Yes / ● No - 启动哪些hooks，选择第一个
Skip for now。通过键盘上的空格键进行选择，然后回车。hooks用于OpenClaw和大模型沟通过程中添加的额外信息。◆ Enable hooks? │ ◼ Skip for now │ ◻ 🚀 boot-md │ ◻ 📎 bootstrap-extra-files │ ◻ 📝 command-logger │ ◻ 💾 session-memory - 使用哪种方式访问OpenClaw？选择
Open the Web UI就会自动打开浏览器访问OpenClaw页面。◆ How do you want to hatch your bot? │ ○ Hatch in TUI (recommended) │ ● Open the Web UI │ ○ Do this later - 完成后的信息，输出完成后就会退出初始化步骤。
◇ Dashboard ready ────────────────────────────────────────────────────────────────╮ │ │ │ Dashboard link (with token): │ │ http://127.0.0.1:18789/#token=5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d │ │ Opened in your browser. Keep that tab to control OpenClaw. │ │ │ ├──────────────────────────────────────────────────────────────────────────────────╯ │ ◇ Workspace backup ────────────────────────────────────────╮ │ │ │ Back up your agent workspace. │ │ Docs: https://docs.openclaw.ai/concepts/agent-workspace │ │ │ ├───────────────────────────────────────────────────────────╯ │ ◇ Security ──────────────────────────────────────────────────────╮ │ │ │ Running agents on your computer is risky — harden your setup: │ │ https://docs.openclaw.ai/security │ │ │ ├─────────────────────────────────────────────────────────────────╯ │ ◇ Shell completion ───────────────────────────────────────────────────────╮ │ │ │ Shell completion installed. Restart your shell or run: source ~/.zshrc │ │ │ ├──────────────────────────────────────────────────────────────────────────╯ │ ◇ Web search ───────────────────────────────────────╮ │ │ │ Web search was skipped. You can enable it later: │ │ openclaw configure --section web │ │ │ │ Docs: https://docs.openclaw.ai/tools/web │ │ │ ├────────────────────────────────────────────────────╯ │ ◇ What now ─────────────────────────────────────────────────────────────╮ │ │ │ What now: https://openclaw.ai/showcase ("What People Are Building"). │ │ │ ├────────────────────────────────────────────────────────────────────────╯ │ └ Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.
在Linux上安装时，如果没有图形界面，默认无法直接打开浏览器访问远程的Linux的Web页面的。
◇ Dashboard ready ────────────────────────────────────────────────────────────────╮
│ │
│ Dashboard link (with token): │
│ http://127.0.0.1:18789/#token=fcc68aaa7011034d4574b9b6d7c1572f90e603023e7bcebd │
│ Copy/paste this URL in a browser on this machine to control OpenClaw. │
│ No GUI detected. Open from your computer: │
│ ssh -N -L 18789:127.0.0.1:18789 root@172.25.47.255 │
│ Then open: │
│ http://localhost:18789/ │
│ http://localhost:18789/#token=fcc68aaa7011034d4574b9b6d7c1572f90e603023e7bcebd │
│ Docs: │
│ https://docs.openclaw.ai/gateway/remote │
│ https://docs.openclaw.ai/web/control-ui │
│ │
├──────────────────────────────────────────────────────────────────────────────────╯
但是在Linux最后的输出信息中有提示，其中命令 ssh -N -L 18789:127.0.0.1:18789 root@172.25.47.255 是用来配置本地端口转发的。这条命令的含义是：将本机的 18789 端口转发到 172.25.47.255:18789，这样访问本地的18789就是访问远程Linux机器的18789了。
可以新开一个终端执行该SSH命令，注意
- 是本地机器执行，不是远程安装OpenClaw的机器。
- 需要将
172.25.47.255替换成远程安装OpenClaw的机器的公网IP地址。不需要额外开放安全组，只要22端口可以访问即可。
然后就可以在本地的浏览器中访问 http://127.0.0.1:18789
安装完成后，打开浏览器提示连接网关需要 Token。
Token 可以从终端输出中获取，如 fcc68aaa7011034d4574b9b6d7c1572f90e603023e7bcebd。
在后续使用中如果忘记 Token，可以通过如下命令获取：
% cat ~/.openclaw/openclaw.json |grep token|grep -v mode
"token": "5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d"
并且，可能会提示需要设备审批，如果没有提示则忽略。这里的设备是指一个链接到OpenClaw的终端，比如用不同的电脑，不同浏览器访问OpenClaw时，就会生成不同的设备。
执行如下命令进行设备审批即可。
REQUEST_ID=`openclaw devices list --json | jq -r '.pending[].requestId'`
openclaw devices approve "$REQUEST_ID"