OpenClaw手动安装

前言

• 使用 网盘🚀 在 系统镜像/ 这个目录中下载我们提供的 .img 镜像文件。
• 此文档使用的 Ubuntu24 镜像为：TaishanPi-3M-RK3576_Ubuntu24-GNOME_AP6256.img

🦞 OpenClaw 安装演示版本为：v2026.3.28 (f9b1079)

烧录镜像到开发板

参考 成品镜像烧录 将下载好的镜像文件烧录到开发板中。

运行安装脚本

OpenClaw 官方提供了一种安装脚本的方式来安装 OpenClaw：

注意：

1. 此步骤需要开发板能够访问互联网。
2. 推荐使用 SSH 连接到开发板的终端来执行安装命令，避免串口数据干扰安装过程中的交互。

如果国内的网络环境连Node.js的官方源都访问不了，可以先运行下面的命令安装Node.js和npm：

NODE_VERSION=24.14.1
curl -#fL https://npmmirror.com/mirrors/node/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-arm64.tar.xz \
  -o /tmp/node.tar.xz && \
  sudo tar -xJ -C /usr/local --strip-components=1 -f /tmp/node.tar.xz

效果【点击展开】

lckfb@localhost:~$ NODE_VERSION=24.14.1
curl -#fL https://npmmirror.com/mirrors/node/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-arm64.tar.xz \
  -o /tmp/node.tar.xz && \
  sudo tar -xJ -C /usr/local --strip-components=1 -f /tmp/node.tar.xz
################################### 100.0%
################################### 100.0%
lckfb@localhost:~$ node -v
v24.14.1
lckfb@localhost:~$ npm -v
11.11.0

执行 OpenClaw 安装脚本:

这里通过 npm config set registry 来指定使用国内的 npm 镜像源来安装 OpenClaw，以加速安装过程。

npm config set registry https://registry.npmmirror.com/ && \
  curl -fsSL https://openclaw.ai/install.sh | bash

效果【点击展开】

lckfb@localhost:~$ npm config set registry https://registry.npmmirror.com/ && \
  curl -fsSL https://openclaw.ai/install.sh | bash

  🦞 OpenClaw Installer
  I'll do the boring stuff while you dramatically stare at the logs like it's cinema.

✓ Detected: linux

Install plan
OS: linux
Install method: npm
Requested version: latest

[1/3] Preparing environment
✓ Node.js v24.14.1 found
· Active Node.js: v24.14.1 (/usr/local/bin/node)
· Active npm: 11.11.0 (/usr/local/bin/npm)

[2/3] Installing OpenClaw
✓ Git already installed
· Installing OpenClaw v2026.3.28

✓ OpenClaw npm package installed
✓ OpenClaw installed

[3/3] Finalizing setup

! PATH missing npm global bin dir: /home/lckfb/.npm-global/bin
  This can make openclaw show as "command not found" in new terminals.
  Fix (zsh: ~/.zshrc, bash: ~/.bashrc):
    export PATH="/home/lckfb/.npm-global/bin:$PATH"

🦞 OpenClaw installed successfully (OpenClaw 2026.3.28 (f9b1079))!
Finally unpacked. Now point me at your problems.

安装完成之后，就会进入新手引导界面：

基础配置

在新手引导界面种，我们需要进行一些基础的配置来让 OpenClaw 能够正常使用，其他的都可以后续再进行更改。

操作说明

在引导页面操作主要依靠键盘的上下左右键来进行选择，空格选中，回车键来确认选择。

同意风险

选择 Yes，回车确认。

◆  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ● Yes / ○ No
└

选择快速开始

选择 QuickStart，回车确认。

◆  Onboarding mode
│  ● QuickStart (Configure details later via openclaw configure.)
│  ○ Manual
└

选择模型

这里我们可以直接跳过模型的配置，后续通过 OpenClaw模型API配置 这个文档来进行配置，所以选择 Skip for now，回车确认。

◆  Model/auth provider
.....
│  ● Skip for now
└

模型供应商选择所有供应商：

◆  Filter models by provider
│  ● All providers
.....
└

默认模型，我们选择保持不动即可，后面详细配置里面会进行修改：

◆  Default model
│  ● Keep current (default: anthropic/claude-opus-4-6)
......
└

通道配置

在 OpenClaw 中通道（Channel）是连接用户与 AI 助手的桥梁，配置通道可以让用户通过熟悉的通讯平台与 OpenClaw 进行交互（发送消息）。

这里我们可以直接跳过配置，后续通过 OpenClaw飞书通道配置 这个文档来进行配置，所以选择 Skip for now，回车确认。

◆  Select channel (QuickStart)
......
│  ● Skip for now (You can add channels later via `openclaw channels add`)
└

配置搜索提供商

这个我们暂时先跳过，选择 Skip for now，后面我们可以通过命令添加。

◆  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)
└

配置Skills

选择 No 跳过配置，我们之后可以通过对话的方式，让 OpenClaw 自己配置自己的 Skills 不需要我们自己动手：

◆  Configure skills now? (recommended)
│  ○ Yes / ● No
└

hook配置

将所有的配置全部使用空格选中，然后回车确认：

◆  Enable hooks?
│  ◻ Skip for now
│  ◼ 🚀 boot-md (Run BOOT.md on gateway startup)
│  ◼ 📎 bootstrap-extra-files (Inject additional workspace bootstrap files via glob/path patterns)
│  ◼ 📝 command-logger (Log all command events to a centralized audit file)
│  ◼ 💾 session-memory (Save session context to memory when /new or /reset command is issued)
└

hatch 配置

我们选择 Do this later 来跳过此配置，我们先不打开和机器人的聊天框，后续再说。

• Hatch in TUI (recommended)：直接在终端里开聊
• Open the Web UI：打开浏览器网页版
• Do this later：先退出来，以后再说

◆  How do you want to hatch your bot?
│  ○ Hatch in TUI (recommended)
│  ○ Open the Web UI
│  ● Do this later
└

完成安装

后续配置

完成安装之后我们首次需要运行 source ~/.bashrc 来加载环境变量，这样才能使用 openclaw 这个命令：

source ~/.bashrc

访问UI界面

想要访问 OpenClaw 的UI界面，我们需要设置配置参数，才能在局域网内进行访问:

可以使用 openclaw help 来查看 openclaw 命令的使用说明.

# 1. 设定网络访问模式为 LAN
openclaw config set gateway.bind lan

# 2. 设定HTTP访问降级为 true，允许不安全的HTTP访问（如果不设置这个参数，默认是禁止HTTP访问的）
openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 3. 重启 OpenClaw gateway 使配置生效
openclaw gateway restart

使用以下命令查看局域网内查看 OpenClaw 的 UI 访问地址 Dashboard URL：

这个命令会自动打开板子中的默认浏览器来访问 OpenClaw 的UI界面，所以我们看到相关的地址之后就可以使用 Ctrl + C 来终止这个命令了。

openclaw dashboard --no-open

访问地址一般是 http://<开发板IP地址>:18789/#token=<token>，在浏览器中输入这个地址就可以访问 OpenClaw 的UI界面了：

• 使用 ifconfig 命令可以查看<开发板IP地址>，替换掉原本的 127.0.0.1 就可以在局域网内访问了。
• <token> 是一个访问令牌，用于验证用户的访问权限，确保只有授权用户才能访问 OpenClaw 的UI界面。每次安装或者重置 OpenClaw 之后，这个 token 都会发生变化，所以需要使用最新的 token 来访问UI界面。我们使用 openclaw dashboard 命令获取的访问地址就是包含了最新 token 的地址，可以直接使用这个地址来访问UI界面。

# 替换之前的地址：
http://127.0.0.1:18789/#token=65e93827a9dc220819dca1324ef14fe4616ba3e94aa68d7c

# 替换之后的地址：
http://192.168.137.60:18789/#token=65e93827a9dc220819dca1324ef14fe4616ba3e94aa68d7c