简体中文

English

简体中文

English

外观

​

前言 ​

  • 使用 网盘🚀 在 系统镜像/Debian12/ 这个目录中下载我们提供的 .img 镜像文件。

  • 此文档使用的 Debian12 镜像为：debian12_desktop_hdmi_dp_ap6256_msata_update.img

🦞 OpenClaw 安装演示版本为：2026.2.22-2 (45febec)

烧录镜像到开发板 ​

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

运行安装脚本 ​

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

注意：此步骤需要开发板能够访问互联网。

bash
curl -fsSL https://openclaw.ai/install.sh | bash

效果：

bash
🦞 OpenClaw Installer
If it's repetitive, I'll automate it; if it's hard, I'll bring jokes and a rollback plan.

✓ Detected: linux

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

[1/3] Preparing environment
· Node.js not found, installing it now
· Installing Node.js via NodeSource
· Installing Linux build tools (make/g++/cmake/python3)
✓ Build tools installed
✓ Node.js v22 installed
· Active Node.js: v22.22.0 (/usr/bin/node)
· Active npm: 10.9.4 (/usr/bin/npm)

[2/3] Installing OpenClaw
✓ Git already installed
· Configuring npm for user-local installs
✓ npm configured for user installs
· Installing OpenClaw v2026.2.22-2
✓ 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 (2026.2.22-2)!
All done! I promise to only judge your code a little bit.

· Starting setup

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

基础配置 ​

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

操作说明

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

同意风险 ​

选择 Yes，回车确认。

bash
◆  I understand this is powerful and inherently risky. Continue?
│  ● Yes / ○ No
└

选择快速开始 ​

选择 QuickStart，回车确认。

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

选择模型 ​

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

bash

◆  Model/auth provider
│  ● Skip for now
└

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

bash
◆  Filter models by provider
│  ● All providers
└

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

bash

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

通道配置 ​

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

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

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

配置Skills ​

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

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

相关的KEY配置 ​

全部选择 No：

bash
◇  Set GOOGLE_PLACES_API_KEY for goplaces?
│  No
│
◇  Set GEMINI_API_KEY for nano-banana-pro?
│  No
│
◇  Set NOTION_API_KEY for notion?
│  No
│
◇  Set OPENAI_API_KEY for openai-image-gen?
│  No
│
◇  Set OPENAI_API_KEY for openai-whisper-api?
│  No
│
◇  Set ELEVENLABS_API_KEY for sag?
│  No

hook配置 ​

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

bash

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

完成安装 ​

访问UI界面 ​

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

如果没有 openclaw 命令，可以先执行 source ~/.bashrc 来加载环境变量。

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

bash
# 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

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

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

bash
openclaw dashboard

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

  • 使用 ifconfig 命令可以查看<开发板IP地址>，替换掉原本的 127.0.0.1 就可以在局域网内访问了。

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

bash
http://192.168.137.231:18789/#token=af94e258639978672caef32fd1366c4466b1c100eceae38e

本页面更新于: