openEuler 24.03 部署 OpenClaw 完整指南
openEuler 24.03 部署 OpenClaw 完整指南
·
openEuler 24.03 部署 OpenClaw 完整指南
一、系统检查与准备
# 1. 确认系统版本
[root@localhost ~]# cat /etc/openEuler-release
openEuler release 24.03 (LTS-SP3)
[root@localhost ~]#
# 2. 更新系统（openEuler 使用 dnf，兼容 yum 命令）
sudo dnf update -y
# 3. 安装基础依赖
sudo dnf install -y git wget curl vim net-tools gcc gcc-c++ make cmake python3
# 4. 设置主机名
[root@localhost ~]# hostnamectl set-hostname openclaw
[root@localhost ~]# bash # 让其生效
[root@openclaw ~]#
# 5. 查看 IP 信息
[root@localhost ~]# ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host noprefixroute
valid_lft forever preferred_lft forever
2: ens33: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 00:0c:29:9e:41:0f brd ff:ff:ff:ff:ff:ff
inet 192.168.100.165/24 brd 192.168.100.255 scope global dynamic noprefixroute ens33
valid_lft 1317sec preferred_lft 1317sec
inet6 fe80::20c:29ff:fe9e:410f/64 scope link proto kernel_ll
valid_lft forever preferred_lft forever
# 6. 查看当前主机名及系统信息
[root@openclaw ~]# hostnamectl
Static hostname: openclaw
Icon name: computer-vm
Chassis: vm 🖴
Machine ID: b8ba19cab51648ef8c1ec6ef04f8d8c3
Boot ID: 5576af55832b40a39ef8db1d3c6d485a
Virtualization: vmware
Operating System: openEuler 24.03 (LTS-SP3)
Kernel: Linux 6.6.0-132.0.0.111.oe2403sp3.x86_64
Architecture: x86-64
Hardware Vendor: VMware, Inc.
Hardware Model: VMware Virtual Platform
Firmware Version: 6.00
Firmware Date: Thu 2020-11-12
Firmware Age: 5y 3month 3w 6d
[root@openclaw ~]#
# 7. 创建 data 目录用来存在数据
[root@openclaw ~]# mkdir /data
# 8. 安装基础依赖
[root@openclaw ~]# yum install -y git wget curl vim net-tools gcc gcc-c++ make cmake python3 tar
# 9. 关闭防火墙跟Selinux
# 停止防火墙
systemctl stop firewalld
# 禁止开机自启
systemctl disable firewalld
# 查看状态（确认关闭）
systemctl status firewalld
# 临时关闭（当前生效，重启失效）
setenforce 0
# 永久关闭（重启也保持关闭）
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config
二、安装 Node.js 24.14.0
openEuler 官方源未提供 Node.js 24，推荐手动安装官方二进制包：
-
OpenClaw 需要 Node.js
- OpenClaw 是用 JavaScript/TypeScript 编写的 Node.js 应用程序，就像：
- Python 程序需要 Python 解释器
- Java 程序需要 JVM
- OpenClaw 需要 Node.js 运行时
-
下载 Node.js 24.14.0（Linux x64 版本）
# 1. 下载 Node.js 24.14.0（Linux x64 版本）
[root@openclaw ~]# cd /data/
[root@openclaw data]# wget https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz
--2026-03-11 14:19:10-- https://nodejs.org/dist/v24.14.0/node-v24.14.0-linux-x64.tar.xz
正在解析主机 nodejs.org (nodejs.org)... 172.66.128.70, 104.20.1.252, 2606:4700:10::6814:1fc, ...
正在连接 nodejs.org (nodejs.org)|172.66.128.70|:443... 已连接。
已发出 HTTP 请求，正在等待回应... 200 OK
长度：31039304 (30M) [application/x-xz]
正在保存至: “node-v24.14.0-linux-x64.tar.xz”
node-v24.14.0-linux-x64.tar.xz 100%[====================================================>] 29.60M 844KB/s 用时 61s
2026-03-11 14:20:12 (499 KB/s) - 已保存 “node-v24.14.0-linux-x64.tar.xz” [31039304/31039304])
[root@openclaw data]# ls -l
总计 30312
-rw-r--r--. 1 root root 31039304 2月24日 13:44 node-v24.14.0-linux-x64.tar.xz
[root@openclaw data]#
# 2. 解压
[root@openclaw data]# tar -xvf node-v24.14.0-linux-x64.tar.xz
# 3. 移动到 /usr/local
[root@openclaw data]# mv node-v24.14.0-linux-x64 /usr/local/node
# 4. 配置环境变量（永久生效）
cat >> /etc/profile << 'EOF'
export NODE_HOME=/usr/local/node
export PATH=$PATH:$NODE_HOME/bin
EOF
# 5. 使环境变量立即生效
source /etc/profile
# 6. 验证安装
[root@openclaw data]# node -v
v24.14.0
[root@openclaw data]# npm -v
11.9.0
[root@openclaw data]#
三、配置 npm 国内镜像
# 设置阿里云 npm 镜像（提升下载速度）
[root@openclaw ~]# npm config set registry https://registry.npmmirror.com
# 验证配置
[root@openclaw ~]# npm config get registry
https://registry.npmmirror.com
[root@openclaw ~]#
四、安装 pnpm（推荐）
# 使用 npm 全局安装 pnpm
[root@openclaw ~]# npm install -g pnpm
added 1 package in 2s
1 package is looking for funding
run `npm fund` for details
# 验证
[root@openclaw ~]# pnpm --version
10.32.1
[root@openclaw ~]#
# 设置 pnpm 镜像（可选）
[root@openclaw ~]# pnpm config set registry https://registry.npmmirror.com
五、安装 OpenClaw
方式一：直接全局安装
- 如使用方式一安装失败，使用方式二来安装
# 查询都有那些版本可用
[root@openclaw ~]# which npm
/usr/local/node/bin/npm
[root@openclaw ~]# /usr/local/node/bin/npm view openclaw versions
[
'0.0.1', '2026.1.29-beta.1', '2026.1.29-beta.2',
'2026.1.29-beta.3', '2026.1.29-beta.4', '2026.1.29-beta.5',
'2026.1.29-beta.7', '2026.1.29', '2026.1.30',
'2026.2.1', '2026.2.2-1', '2026.2.2-2',
'2026.2.2-3', '2026.2.2', '2026.2.3-1',
'2026.2.3', '2026.2.6-1', '2026.2.6-2',
'2026.2.6-3', '2026.2.6', '2026.2.9',
'2026.2.12', '2026.2.13', '2026.2.14',
'2026.2.15', '2026.2.17', '2026.2.19-1',
'2026.2.19-2', '2026.2.19', '2026.2.21-1',
'2026.2.21-2', '2026.2.21', '2026.2.22-1',
'2026.2.22-2', '2026.2.22', '2026.2.23-beta.1',
'2026.2.23', '2026.2.24', '2026.2.25-beta.1',
'2026.2.25', '2026.2.26', '2026.3.1-beta.1',
'2026.3.1', '2026.3.2-beta.1', '2026.3.2',
'2026.3.7-beta.1', '2026.3.7', '2026.3.8-beta.1',
'2026.3.8'
]
[root@openclaw ~]#
# 安装最新版本方式
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 或安装指定版本（例如 2026.3.8）
[root@openclaw ~]# npm install -g openclaw@2026.3.8 --registry=https://registry.npmmirror.com
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
added 673 packages in 53s
130 packages are looking for funding
run `npm fund` for details
[root@openclaw ~]# echo $? # 可以使用此命令来验证上一步执行的结果，非0则表示失败
0
[root@openclaw ~]#
# 验证安装
[root@openclaw ~]# openclaw --version
OpenClaw 2026.3.8 (3caab92)
[root@openclaw ~]#
方式二：源码安装（如方式一失败）
# 1. 下载源码
cd /data/
wget https://github.com/openclaw/openclaw/archive/refs/tags/v2026.3.8.tar.gz
tar -xzf v2026.3.8.tar.gz
cd openclaw-2026.3.8
# 2. 安装依赖（使用 pnpm）
rm -rf node_modules package-lock.json
pnpm install --registry=https://registry.npmmirror.com
# 3. 构建
pnpm run build
# 4. 全局安装
pnpm store prune
source ~/.bashrc
pnpm install -g .
# 5. 验证
openclaw --version
- 我上午的时候可以使用方式一来安装，下午就不行了，所以下午使用的是方式二来安装。
六、运行新手引导
# 运行新手引导并自动安装系统守护进程
[root@openclaw ~]# cd /data/openclaw-2026.3.8/
[root@openclaw openclaw-2026.3.8]# openclaw onboard --install-daemon
🦞 OpenClaw 2026.3.8 (unknown) — If it works, it's automation; if it breaks, it's a "learning opportunity."
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
🦞 OPENCLAW 🦞
┌ OpenClaw onboarding
│
◇ Security ─────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Security warning — please read. │
│ │
│ OpenClaw is a hobby project and still in beta. Expect sharp edges. │
│ By default, OpenClaw is a personal agent: one trusted operator boundary. │
│ This bot can read files and run actions if tools are enabled. │
│ A bad prompt can trick it into doing unsafe things. │
│ │
│ OpenClaw is not a hostile multi-tenant boundary by default. │
│ If multiple users can message one tool-enabled agent, they share that delegated tool │
│ authority. │
│ │
│ If you’re not comfortable with security hardening and access control, don’t run │
│ OpenClaw. │
│ Ask someone experienced to help before enabling tools or exposing it to the internet. │
│ │
│ Recommended baseline: │
│ - Pairing/allowlists + mention gating. │
│ - Multi-user/shared inbox: split trust boundaries (separate gateway/credentials, ideally │
│ separate OS users/hosts). │
│ - Sandbox + least-privilege tools. │
│ - Shared inboxes: isolate DM sessions (`session.dmScope: per-channel-peer`) and keep │
│ tool access minimal. │
│ - Keep secrets out of the agent’s reachable filesystem. │
│ - Use the strongest available model for any bot with tools or untrusted inboxes. │
│ │
│ Run regularly: │
│ openclaw security audit --deep │
│ openclaw security audit --fix │
│ │
│ Must read: https://docs.openclaw.ai/gateway/security │
│ │
├────────────────────────────────────────────────────────────────────────────────────────────╯
│
◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ ○ Yes / ● No # 选 yes 按回车健
└
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ Yes
│
◆ Onboarding mode
│ ● QuickStart (Configure details later via openclaw configure.)
│ ○ Manual
└
# 选 QuickStart 按回车健。
# QuickStart 就是最简、最快的安装方式。它不纠结选哪个具体模型，先把环境、服务、框架装好。模型等安装完、系统跑起来之后，再单独配置、下载、更换。
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ Yes
│
◇ Onboarding mode
│ QuickStart
│
◇ QuickStart ─────────────────────────?
│ │
│ Gateway port: 18789 │
│ Gateway bind: Loopback (127.0.0.1) │
│ Gateway auth: Token (default) │
│ Tailscale exposure: Off │
│ Direct to chat channels. │
│ │
├──────────────────────────────────────?
│
◆ Model/auth provider
│ ● OpenAI (Codex OAuth + API key)
│ ○ Anthropic
│ ○ Chutes
│ ○ vLLM
│ ○ MiniMax
│ ○ Moonshot AI (Kimi K2.5)
│ ○ Google
│ ○ xAI (Grok)
│ ○ Mistral AI
│ ○ Volcano Engine
│ ○ BytePlus
│ ○ OpenRouter
│ ○ Kilo Gateway
│ ○ Qwen
│ ○ Z.AI
│ ○ Qianfan
│ ○ Copilot
│ ○ Vercel AI Gateway
│ ○ OpenCode Zen
│ ○ Xiaomi
│ ○ Synthetic
│ ○ Together AI
│ ○ Hugging Face
│ ○ Venice AI
│ ○ LiteLLM
│ ○ Cloudflare AI Gateway
│ ○ Custom Provider
│ ○ Skip for now # 暂且先跳过
◇ Model/auth provider
│ Skip for now
│
◆ 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
│ ○ openai
│ ○ openai-codex
│ ○ opencode
│ ○ opencode-go
│ ○ openrouter
│ ○ vercel-ai-gateway
│ ○ xai
│ ○ zai
◇ Model/auth provider
│ Skip for now
│
◇ Filter models by provider
│ All providers
│
◆ 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-3-opus-20240229-v1:0
│ ○ amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0
│ ○ amazon-bedrock/us.anthropic.claude-opus-4-20250514-v1:0
│ ○ amazon-bedrock/anthropic.claude-opus-4-1-20250805-v1:0
│ ○ amazon-bedrock/us.anthropic.claude-opus-4-1-20250805-v1:0
│ ○ amazon-bedrock/anthropic.claude-opus-4-5-20251101-v1:0
│ ○ amazon-bedrock/eu.anthropic.claude-opus-4-5-20251101-v1:0
│ ○ amazon-bedrock/global.anthropic.claude-opus-4-5-20251101-v1:0
│ ○ amazon-bedrock/us.anthropic.claude-opus-4-5-20251101-v1:0
│ ○ amazon-bedrock/anthropic.claude-opus-4-6-v1
│ ○ amazon-bedrock/eu.anthropic.claude-opus-4-6-v1
│ ○ amazon-bedrock/global.anthropic.claude-opus-4-6-v1
│ ○ amazon-bedrock/us.anthropic.claude-opus-4-6-v1
│ ○ amazon-bedrock/anthropic.claude-3-sonnet-20240229-v1:0
│ ○ amazon-bedrock/anthropic.claude-3-5-sonnet-20240620-v1:0
│ ○ amazon-bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0
│ ○ amazon-bedrock/anthropic.claude-3-7-sonnet-20250219-v1:0
│ ○ amazon-bedrock/anthropic.claude-sonnet-4-20250514-v1:0
│ ○ amazon-bedrock/eu.anthropic.claude-sonnet-4-20250514-v1:0
│ ○ amazon-bedrock/global.anthropic.claude-sonnet-4-20250514-v1:0
│ ...
◆ 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 (Bot Framework)
│ ○ Mattermost (plugin)
│ ○ Nextcloud Talk (self-hosted)
│ ○ Matrix (plugin)
│ ○ BlueBubbles (macOS app)
│ ○ Zalo (Bot API)
│ ○ Zalo (Personal Account)
│ ○ Synology Chat (Webhook)
│ ○ Tlon (Urbit)
│ ● Skip for now (You can add channels later via `openclaw channels add`)
# 暂且先跳过。不绑定任何聊天软件
◇ Select channel (QuickStart)
│ Skip for now
Updated ~/.openclaw/openclaw.json
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions
│
◇ Web search ────────────────────────────────────────?
│ │
│ Web search lets your agent look things up online. │
│ Choose a provider and paste your API key. │
│ Docs: https://docs.openclaw.ai/tools/web │
│ │
├─────────────────────────────────────────────────────?
│
◆ Search provider
│ ○ Brave Search
│ ○ Gemini (Google Search)
│ ○ Grok (xAI)
│ ○ Kimi (Moonshot)
│ ○ Perplexity Search
│ ● Skip for now (Configure later with openclaw configure --section web)
# 暂且先跳过。AI 智能搜索的服务商
◇ Select channel (QuickStart)
│ Skip for now
Updated ~/.openclaw/openclaw.json
Workspace OK: ~/.openclaw/workspace
Sessions OK: ~/.openclaw/agents/main/sessions
│
◇ Web search ────────────────────────────────────────?
│ │
│ Web search lets your agent look things up online. │
│ Choose a provider and paste your API key. │
│ Docs: https://docs.openclaw.ai/tools/web │
│ │
├─────────────────────────────────────────────────────?
│
◇ Search provider
│ Skip for now
│
◇ Skills status ─────────────?
│ │
│ Eligible: 3 │
│ Missing requirements: 41 │
│ Unsupported on this OS: 7 │
│ Blocked by allowlist: 0 │
│ │
├─────────────────────────────?
│
◆ Configure skills now? (recommended)
│ ○ Yes / ● No # 选择 No
└
◇ Search provider
│ Skip for now
│
◇ Skills status ─────────────?
│ │
│ Eligible: 3 │
│ Missing requirements: 41 │
│ Unsupported on this OS: 7 │
│ Blocked by allowlist: 0 │
│ │
├─────────────────────────────?
│
◇ Configure skills now? (recommended)
│ No
│
◇ Hooks ──────────────────────────────────────────────────────────────────?
│ │
│ Hooks let you automate actions when agent commands are issued. │
│ Example: Save session context to memory when you issue /new or /reset. │
│ │
│ Learn more: https://docs.openclaw.ai/automation/hooks │
│ │
├──────────────────────────────────────────────────────────────────────────?
│
◆ 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)
└
# 空格表示选择，然后回车键
# 安装完成，保存信息。token 记录。
◇ Control UI ───────────────────────────────────────────────────────────────────────────────?
│ │
│ Web UI: http://127.0.0.1:18789/ │
│ Web UI (with token): │
│ http://127.0.0.1:18789/#token=dd8b74aec96d24fb1b6d6542bc28794a793a016816c2b725 │
│ Gateway WS: ws://127.0.0.1:18789 │
│ Gateway: not detected (gateway closed (1006 abnormal closure (no close frame)): no close │
│ reason) │
│ Docs: https://docs.openclaw.ai/web/control-ui │
│ │
├────────────────────────────────────────────────────────────────────────────────────────────?
│
◇ 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 ~/.bashrc │
│ │
├───────────────────────────────────────────────────────────────────────────?
│
◇ Dashboard ready ────────────────────────────────────────────────────────────────?
│ │
│ Dashboard link (with token): │
│ http://127.0.0.1:18789/#token=dd8b74aec96d24fb1b6d6542bc28794a793a016816c2b725 │
│ 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@192.168.100.165 │
│ Then open: │
│ http://localhost:18789/ │
│ http://localhost:18789/#token=dd8b74aec96d24fb1b6d6542bc28794a793a016816c2b725 │
│ Docs: │
│ https://docs.openclaw.ai/gateway/remote │
│ https://docs.openclaw.ai/web/control-ui │
│ │
├──────────────────────────────────────────────────────────────────────────────────?
│
◇ 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. Use the dashboard link above to control OpenClaw.
# 查看服务端口，没有启动，手动给它启动。
[root@openclaw openclaw-2026.3.8]# ss -antl
State Recv-Q Send-Q Local Address:Port Peer Address:Port Process
LISTEN 0 128 0.0.0.0:22 0.0.0.0:*
LISTEN 0 128 [::]:22 [::]:*
[root@openclaw openclaw-2026.3.8]#
# 进入项目根目录（手动启动，CentOS Stream8 或者Rocky Linux安装完成后会自动启动）
cd /data/openclaw-2026.3.8
# 关键：直接运行 gateway 命令（不带 start），启动前台进程
openclaw gateway
# 若想后台运行（不占终端），用 nohup + & 包裹：
# nohup openclaw gateway > /var/log/openclaw-gateway.log 2>&1 &
引导配置项说明：
| 步骤 | 配置内容 | 建议操作 |
|---|---|---|
| 1 | 选择模型提供商 | 可先跳过（按 Enter） |
| 2 | 授权提供商 | 可先跳过 |
| 3 | 绑定聊天软件 | 可先跳过 |
| 4 | AI 搜索服务 | 可先跳过 |
| 5 | 启用自动化扩展 | 建议输入 y 启用 |
⚠️ 重要：引导完成后会显示一个包含 token 的访问 URL，请立即复制保存！
例如：http://127.0.0.1:18789/#token=dd8b74aec96d24fb1b6d6542bc28794a793a016816c2b725
七、访问 Web 控制台
方式一：SSH 隧道（推荐，更安全）
在本地电脑（你的个人电脑）执行：
# Windows PowerShell / macOS / Linux
ssh -N -L 18789:127.0.0.1:18789 root@你的服务器IP
例如你的服务器 IP 为 192.168.100.165：
ssh -N -L 18789:127.0.0.1:18789 root@192.168.100.165
Windows打开谷歌浏览器访问：
- http://127.0.0.1:18789/#token=dd8b74aec96d24fb1b6d6542bc28794a793a016816c2b725
方式二：直接访问（需开放防火墙）
- 如已经关闭防火墙忽略此步
# 开放 18789 端口（openEuler 默认使用 firewalld）
sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload
# 检查端口监听状态
sudo netstat -nultp | grep 18789
浏览器直接访问：
http://你的服务器IP:18789/#token=你的token
⚠️ 若需从公网访问，请务必配置防火墙限制 IP 或使用更安全的认证方式。
八、配置 AI 模型
安装完成后，可通过 Web 控制台或命令行配置模型提供商：
# 配置模型提供商
openclaw configure --section models
# 配置 Web 搜索服务
openclaw configure --section web
# 查看当前所有配置
openclaw configure --list
常用模型提供商及 API 密钥配置项：
| 提供商 | 配置项 | 获取地址 |
|---|---|---|
| OpenAI | OPENAI_API_KEY |
https://platform.openai.com |
| Anthropic | ANTHROPIC_API_KEY |
https://console.anthropic.com |
| 智谱AI | ZHIPU_API_KEY |
https://open.bigmodel.cn |
| 月之暗面 | MOONSHOT_API_KEY |
https://platform.moonshot.cn |
| 通义千问 | DASHSCOPE_API_KEY |
https://dashscope.console.aliyun.com |
九、常用命令速查
| 命令 | 说明 |
|---|---|
openclaw --version |
查看当前版本 |
openclaw --help |
查看帮助 |
openclaw |
启动 OpenClaw（前台运行） |
openclaw onboard |
重新运行新手引导 |
openclaw configure |
配置各项设置 |
openclaw status |
查看运行状态 |
openclaw logs |
查看日志 |
openclaw stop |
停止服务 |
openclaw restart |
重启服务 |
十、守护进程管理（systemd）
安装时若使用了 --install-daemon，OpenClaw 会注册为系统服务。
# 配置 systemd 服务，可能是 openEuler 系统所以没有生成系统服务
# 1. 创建日志目录（可选，若需文件日志可保留）
mkdir -p /var/log/openclaw && chown root:root /var/log/openclaw && chmod 755 /var/log/openclaw
# 2. 写入最终服务配置
cat > /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw AI Gateway Service
After=network.target network-online.target
Wants=network-online.target
[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/data/openclaw-2026.3.8
ExecStart=/bin/bash /root/.local/share/pnpm/openclaw gateway
Environment="BASH_ENV=/root/.bashrc"
Environment="HOME=/root"
Environment="NODE_PATH=/usr/local/node/lib/node_modules"
Environment="PATH=/usr/local/node/bin:/root/.local/share/pnpm:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin"
ExecStartPre=/bin/bash -c "source /root/.bashrc"
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
RestartSec=5s
StandardOutput=journal+console
StandardError=journal+console
SyslogIdentifier=openclaw-gateway
KillMode=process
RemainAfterExit=no
LimitNOFILE=65535
PassEnvironment=PATH HOME NODE_PATH
[Install]
WantedBy=multi-user.target
EOF
# 3. 重新加载systemd配置
systemctl daemon-reload
# 4. 清理残留进程（避免冲突）
pkill -f "openclaw gateway" && pkill -f "/root/.local/share/pnpm/openclaw"
# 5. 启动服务
systemctl start openclaw.service
# 6. 验证服务状态（核心：Active: active (running)）
[root@openclaw ~]# systemctl status openclaw.service
● openclaw.service - OpenClaw AI Gateway Service
Loaded: loaded (/etc/systemd/system/openclaw.service; disabled; preset: disabled)
Active: active (running) since Wed 2026-03-11 18:07:10 CST; 9s ago
Process: 4231 ExecStartPre=/bin/bash -c source /root/.bashrc (code=exited, status=0/SUCCESS)
Main PID: 4285 (openclaw)
Tasks: 18 (limit: 47125)
Memory: 485.5M ()
CGroup: /system.slice/openclaw.service
├─4285 openclaw
└─4350 openclaw-gateway
...省略N
# 7. 验证端口监听（核心：127.0.0.1:18789 LISTEN）
[root@openclaw ~]# ss -antl | grep 18789
LISTEN 0 511 127.0.0.1:18789 0.0.0.0:*
LISTEN 0 511 [::1]:18789 [::]:*
# 8. 设置开机自启（永久生效）
systemctl enable openclaw.service
# 查看服务状态
systemctl status openclaw
# 启动服务
sudo systemctl start openclaw
# 停止服务
sudo systemctl stop openclaw
# 重启服务
sudo systemctl restart openclaw
# 设置开机自启
sudo systemctl enable openclaw
# 实时查看日志
journalctl -u openclaw -f
十一、故障排查
问题1：openclaw: command not found
# 检查 PATH 环境变量
echo $PATH
# 重新加载配置文件
source /etc/profile
source ~/.bashrc
# 查找 openclaw 安装位置
which openclaw
# 若未找到，尝试重新安装
问题2：网络访问失败（如 npm 安装慢）
# 测试镜像连通性
ping -c 3 registry.npmmirror.com
# 配置代理（如需要）
export http_proxy="http://代理IP:端口"
export https_proxy="http://代理IP:端口"
问题3：端口无法访问
# 检查防火墙规则
sudo firewall-cmd --list-all
# 检查端口监听
sudo netstat -nultp | grep 18789
# 检查 SELinux 状态（openEuler 可能启用）
getenforce
# 若为 Enforcing，可临时关闭测试
sudo setenforce 0
问题4： 错误 channel open failed: administratively prohibited
- SSH 服务器端禁止了端口转发功能。虽然你成功登录了 SSH，但
-L参数创建的本地端口转发被服务器拒绝了。 - 在 服务器端（192.168.100.165）执行
# 修改服务器端 SSH 配置
# 1. 编辑 SSH 配置文件
vi /etc/ssh/sshd_config
# 2. 找到或添加以下配置项，确保设置为 "yes"
AllowTcpForwarding yes
AllowAgentForwarding yes
PermitTunnel yes
# 3. 保存退出后，重启 SSH 服务
systemctl restart sshd
十一、安全建议
- 避免将 18789 端口直接暴露到公网，优先使用 SSH 隧道访问。
- 妥善保管 token，一旦泄露应立即在 Web 控制台重置。
- 定期更新 OpenClaw：
npm install -g openclaw@latest - 备份工作空间：
~/.openclaw/workspace目录。 - 配置防火墙，仅允许可信 IP 访问（如使用直接访问方式）。
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
10
0- 0
已为社区贡献1条内容
所有评论(0)