目录
1.安装 nvm（Node 版本管理器）
[root@VM-4-2-centos ~]# curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 16563 100 16563 0 0 71240 0 --:--:-- --:--:-- --:--:-- 71392
=> Downloading nvm as script to '/root/.nvm'
=> Appending nvm source string to /root/.bashrc
=> Appending bash_completion source string to /root/.bashrc
=> Close and reopen your terminal to start using nvm or run the following to use it now:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion" # This loads nvm bash_completion
[root@VM-4-2-centos ~]# source ~/.bashrc
2.安装 Node 24及git
[root@VM-4-2-centos ~]# nvm install 24
Downloading and installing node v24.15.0...
Downloading https://nodejs.org/dist/v24.15.0/node-v24.15.0-linux-x64.tar.xz...
########################################################################################################################################################################################### 100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v24.15.0 (npm v11.12.1)
Creating default alias: default -> 24 (-> v24.15.0)
[root@VM-4-2-centos ~]# node --version
v24.15.0
[root@VM-4-2-centos ~]# nvm use 24
Now using node v24.15.0 (npm v11.12.1)
[root@VM-4-2-centos ~]# yum install -y git
异常报错解决办法
--这个报错说明操作glibc版本太低了，建议使用高版本OS centos8 或 使用docker进行部署
[root@VM-4-2-centos ~]# node --version
node: /lib64/libstdc++.so.6: version `CXXABI_1.3.11' not found (required by node)
node: /lib64/libstdc++.so.6: version `CXXABI_1.3.8' not found (required by node)
node: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.20' not found (required by node)
node: /lib64/libstdc++.so.6: version `GLIBCXX_3.4.21' not found (required by node)
node: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found (required by node)
node: /lib64/libm.so.6: version `GLIBC_2.27' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.27' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.28' not found (required by node)
node: /lib64/libc.so.6: version `GLIBC_2.25' not found (required by node)
--这个报错说明git仓库没有安装
[root@VM-4-2-centos ~]# npm install -g openclaw@latest
⠧
npm error code ENOENT
npm error syscall spawn git
npm error path git
npm error errno -2
npm error enoent An unknown git error occurred
npm error enoent This is related to npm not being able to find a file.
npm error enoent
npm error A complete log of this run can be found in: /root/.npm/_logs/2026-04-21T06_47_22_667Z-debug-0.log3.安装openclaw
-- 全局安装，这个过程需要些时间，等待即可
[root@VM-4-2-centos ~]# npm install -g openclaw@latest
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead
npm warn deprecated gauge@3.0.2: This package is no longer supported.
npm warn deprecated are-we-there-yet@2.0.0: This package is no longer supported.
npm warn deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supported
npm warn deprecated npmlog@5.0.1: This package is no longer supported.
npm warn deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm warn deprecated tar@6.2.1: Old versions of tar are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
added 753 packages in 9m
130 packages are looking for funding
run `npm fund` for details
--# 安装时显示详细日志
npm install -g openclaw@latest --loglevel verbose
--# 或者查看最近一次安装的完整日志
cat ~/.npm/_logs/*-debug-0.log | tail -100
# 验证
[root@VM-4-2-centos ~]# openclaw --version
OpenClaw 2026.4.15 (041266a)
-- 说明已经安装成功查看安装过程日志
[root@VM-4-2-centos .npm]# cat ~/.npm/_logs/*-debug-0.log | tail -10
4462 silly REMOVE node_modules/array-back
4463 silly REMOVE node_modules/apache-arrow
4464 silly REMOVE node_modules/apache-arrow/node_modules/@types/node
4465 silly REMOVE node_modules/apache-arrow/node_modules/undici-types
4466 verbose cwd /root/.nvm/versions/node/v24.15.0/lib/node_modules/openclaw
4467 verbose os Linux 5.14.0-686.el9.x86_64
4468 verbose node v24.15.0
4469 verbose npm v11.12.1
4470 verbose exit 0
4471 info ok
-- 安装完成
4.检查是否加入linux后台进程中
[root@VM-4-2-centos ~]# systemctl --user status openclaw-gateway
● openclaw-gateway.service - OpenClaw Gateway (v2026.4.15)
Loaded: loaded (/root/.config/systemd/user/openclaw-gateway.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2026-04-21 16:05:25 CST; 24h ago
Main PID: 34178 (openclaw-gatewa)
Tasks: 11 (limit: 23568)
Memory: 396.9M
CPU: 2min 7.056s
CGroup: /user.slice/user-0.slice/user@0.service/app.slice/openclaw-gateway.service
└─34178 openclaw-gateway "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "">
Apr 21 21:59:17 VM-4-2-centos node[34178]: 2026-04-21T21:59:17.284+08:00 [ws] webchat disconnected code=1006 reason=n/a conn=e6d1fe59-bc09-45a5-9>
Apr 22 08:47:04 VM-4-2-centos node[34178]: 2026-04-22T08:47:04.264+08:00 [ws] webchat connected conn=3e343ed4-47ba-4228-b1b1-a17ffaade8c1 remote=>
Apr 22 08:47:17 VM-4-2-centos node[34178]: 2026-04-22T08:47:17.144+08:00 [ws] webchat disconnected code=1005 reason=n/a conn=3e343ed4-47ba-4228-b>
Apr 22 08:47:18 VM-4-2-centos node[34178]: 2026-04-22T08:47:18.422+08:00 [ws] webchat connected conn=4f18d310-52e3-4785-b93a-7e4c667488ca remote=>
Apr 22 16:04:06 VM-4-2-centos node[34178]: 2026-04-22T16:04:06.996+08:00 [ws] ⇄ res ✓ skills.status 295ms conn=4f18d310…88ca id=9301632b…aab4
Apr 22 16:04:07 VM-4-2-centos node[34178]: 2026-04-22T16:04:07.005+08:00 [ws] ⇄ res ✓ status 305ms conn=4f18d310…88ca id=01a8dd7f…0587
Apr 22 16:04:07 VM-4-2-centos node[34178]: 2026-04-22T16:04:07.009+08:00 [ws] ⇄ res ✓ models.list 308ms conn=4f18d310…88ca id=93edf241…b1b3
Apr 22 16:04:07 VM-4-2-centos node[34178]: 2026-04-22T16:04:07.010+08:00 [ws] ⇄ res ✓ cron.status 310ms conn=4f18d310…88ca id=4cc55437…cbd0
Apr 22 16:04:07 VM-4-2-centos node[34178]: 2026-04-22T16:04:07.012+08:00 [ws] ⇄ res ✓ cron.list 312ms conn=4f18d310…88ca id=673a0972…b1a5
Apr 22 16:05:41 VM-4-2-centos node[34178]: 2026-04-22T16:05:41.646+08:00 [gateway] update available (latest): v2026.4.21 (current v2026.4.15). Ru>
[root@VM-4-2-centos ~]#
[root@VM-4-2-centos ~]# ps -o pid,ppid,cmd -p 34178
PID PPID CMD
34178 5974 openclaw-gateway
[root@VM-4-2-centos ~]#
[root@VM-4-2-centos ~]#
[root@VM-4-2-centos ~]#
[root@VM-4-2-centos ~]# more /root/.config/systemd/user/openclaw-gateway.service
[Unit]
Description=OpenClaw Gateway (v2026.4.15)
After=network-online.target
Wants=network-online.target
StartLimitBurst=5
StartLimitIntervalSec=60
[Service]
ExecStart=/root/.nvm/versions/node/v24.15.0/bin/node /root/.nvm/versions/node/v24.15.0/lib/node_modules/openclaw/dist/index.js gateway --port 1878
9
Restart=always
RestartSec=5
RestartPreventExitStatus=78
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group
Environment=HOME=/root
Environment=TMPDIR=/tmp
Environment=NODE_EXTRA_CA_CERTS=/etc/pki/tls/certs/ca-bundle.crt
Environment=PATH=/root/.nvm/versions/node/v24.15.0/bin:/root/.nvm/current/bin:/root/.local/bin:/root/.npm-global/bin:/root/bin:/root/.volta/bin:/r
oot/.asdf/shims:/root/.bun/bin:/root/.fnm/current/bin:/root/.local/share/pnpm:/usr/local/bin:/usr/bin:/bin
Environment=OPENCLAW_GATEWAY_PORT=18789
Environment=OPENCLAW_SYSTEMD_UNIT=openclaw-gateway.service
Environment="OPENCLAW_WINDOWS_TASK_NAME=OpenClaw Gateway"
Environment=OPENCLAW_SERVICE_MARKER=openclaw
Environment=OPENCLAW_SERVICE_KIND=gateway
Environment=OPENCLAW_SERVICE_VERSION=2026.4.15
[Install]
WantedBy=default.target
5.配置openclaw
# 交互式引导安装，一步步配置 Gateway、工作区、频道和技能
openclaw onboard --install-daemon简易版安装配置
[root@VM-4-2-centos ~]# openclaw onboard --install-daemon
🦞 OpenClaw 2026.4.15 (041266a) — I'm not saying your workflow is chaotic... I'm just bringing a linter and a helmet.
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
🦞 OPENCLAW 🦞
┌ OpenClaw setup
│
◇ 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
^[[A│
◇ Setup 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
│ Skip for now
│
◇ Filter models by provider
│ All providers
│
◇ Default model
│ Keep current (default: openai/gpt-5.4)
│
◇ Model check ─────────────────────────────────────────────────────────────────────────────╮
│ │
│ No auth configured for provider "openai". The agent may fail until credentials are │
│ added. Run `openclaw models auth login --provider openai`, `openclaw configure`, or set │
│ an API key env var. │
│ │
├───────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ Channel status ──────────────────────────────────────╮
│ │
│ LINE: needs token + secret │
│ Accounts: 0 │
│ Discord: needs token │
│ iMessage: needs setup │
│ imsg: missing (imsg) │
│ Signal: needs setup │
│ signal-cli: missing (signal-cli) │
│ Slack: needs tokens │
│ Telegram: needs token │
│ WhatsApp: not linked │
│ QQ Bot: needs AppID + AppSecret │
│ Google Chat: needs service account │
│ MS Teams: needs app credentials │
│ Mattermost: needs token + url │
│ Nextcloud Talk: needs setup │
│ Feishu: needs app credentials │
│ Matrix: needs homeserver + access token or password │
│ BlueBubbles: needs setup │
│ IRC: needs host + nick │
│ Zalo: needs token │
│ Zalo Personal: needs QR login │
│ Synology Chat: needs token + incoming webhook │
│ Accounts: 0 │
│ Tlon: needs setup │
│ Nostr: needs private key │
│ Relays: 2 │
│ Twitch: not configured │
│ Twitch: installed │
│ │
├───────────────────────────────────────────────────────╯
│
◇ How channels work ─────────────────────────────────────────────────────────────────────╮
│ │
│ DM security: default is pairing; unknown DMs get a pairing code. │
│ Approve with: openclaw pairing approve <channel> <code> │
│ Public DMs require dmPolicy="open" + allowFrom=["*"]. │
│ Multi-user DMs: run: openclaw config set session.dmScope "per-channel-peer" (or │
│ "per-account-channel-peer" for multi-account channels) to isolate sessions. │
│ Docs: channels/pairing │
│ │
│ Feishu: 飞书/Lark enterprise messaging. │
│ Google Chat: Google Workspace Chat app with HTTP webhook. │
│ Nostr: Decentralized DMs via Nostr relays (NIP-04) │
│ Microsoft Teams: Teams SDK; enterprise support. │
│ Mattermost: self-hosted Slack-style chat; install the plugin to enable. │
│ Nextcloud Talk: Self-hosted chat via Nextcloud Talk webhook bots. │
│ Matrix: open protocol; configure a homeserver + access token. │
│ BlueBubbles: iMessage via the BlueBubbles mac app + REST API. │
│ LINE: LINE Messaging API bot for Japan/Taiwan/Thailand markets. │
│ Zalo: Vietnam-focused messaging platform with Bot API. │
│ Zalo Personal: Zalo personal account via QR code login. │
│ Synology Chat: Connect your Synology NAS Chat to OpenClaw │
│ Tlon: Decentralized messaging on Urbit │
│ Discord: very well supported right now. │
│ iMessage: this is still a work in progress. │
│ IRC: classic IRC networks; host, nick, channels. │
│ QQ Bot: Connect to QQ via official QQ Bot API │
│ Signal: signal-cli linked device; more setup (David Reagans: "Hop on Discord."). │
│ Slack: supports bot + app tokens, channels, threads, and interactive replies. │
│ Telegram: simplest way to get started — register a bot with @BotFather and get going. │
│ Twitch: Twitch chat integration │
│ WhatsApp: works with your own number; recommend a separate phone + eSIM. │
│ │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ 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. Some providers need an API key, and some work key-free. │
│ Docs: https://docs.openclaw.ai/tools/web │
│ │
├──────────────────────────────────────────────────────────────────────────────╯
│
◇ Search provider
│ Skip for now
│
◇ Skills status ─────────────╮
│ │
│ Eligible: 6 │
│ Missing requirements: 39 │
│ 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
Config overwrite: /root/.openclaw/openclaw.json (sha256 d006d90c63ebdbc333a132807ff62e8e1769ccc1dea7e280307d832a884ae0f3 -> 3efecc3b3902025cf4c1746f37471bac78818fc5dc3c55c90cb8a6bf15607b9e, backup=/root/.openclaw/openclaw.json.bak)
│
◇ Systemd ────────────────────────────────────────────────────────────────────────────────╮
│ │
│ Linux installs use a systemd user service by default. Without lingering, systemd stops │
│ the user session on logout/idle and kills the Gateway. │
│ Enabling lingering now (may require sudo; writes /var/lib/systemd/linger). │
│ │
├──────────────────────────────────────────────────────────────────────────────────────────╯
│
◇ Systemd ─────────────────────────────╮
│ │
│ Enabled systemd lingering for root. │
│ │
├───────────────────────────────────────╯
│
◇ Gateway service runtime ────────────────────────────────────────────╮
│ │
│ QuickStart uses Node for the Gateway service (stable + supported). │
│ │
├──────────────────────────────────────────────────────────────────────╯
│
◓ Installing Gateway service…
Installed systemd service: /root/.config/systemd/user/openclaw-gateway.service
◇ Gateway service installed.
Health check failed: gateway closed (1006):
│
◇ Health check help ────────────────────────────────╮
│ │
│ Docs: │
│ https://docs.openclaw.ai/gateway/health │
│ https://docs.openclaw.ai/gateway/troubleshooting │
│ │
├────────────────────────────────────────────────────╯
│
◇ Optional apps ────────────────────────╮
│ │
│ Add nodes for extra features: │
│ - macOS app (system + notifications) │
│ - iOS app (camera/canvas) │
│ - Android app (camera/canvas) │
│ │
├────────────────────────────────────────╯
│
◇ Control UI ─────────────────────────────────────────────────────────────────────╮
│ │
│ Web UI: http://127.0.0.1:18789/ │
│ Web UI (with token): │
│ http://127.0.0.1:18789/#token=a54f4e97fc38bfed0491f12007a9ea3825b51145a7c6c885 │
│ Gateway WS: ws://127.0.0.1:18789 │
│ Gateway: not detected (gateway closed (1006): ) │
│ 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 │
│ │
├───────────────────────────────────────────────────────────────────────────╯
│
◇ 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.
6.常用运维管理命令
# 查看状态
systemctl --user status openclaw-gateway
# 启动 / 停止 / 重启
systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway
systemctl --user restart openclaw-gateway
# 开机自启
systemctl --user enable openclaw-gateway
loginctl enable-linger $(whoami) # 允许未登录时运行
# 查看实时日志
journalctl --user -u openclaw-gateway -f
CLI 常用命令
# 首次安装和初始化
npm install -g openclaw@latest
openclaw onboard # 交互式初始化
openclaw onboard --install-daemon # 初始化并安装 systemd 服务
# Gateway 管理
openclaw gateway run # 前台运行 Gateway
openclaw gateway status # 查看 Gateway 状态
# 配置管理
openclaw config # 查看/编辑配置
# 会话管理
openclaw sessions list # 列出所有会话
openclaw sessions clear # 清理会话
进程监控
# 查看 OpenClaw 进程
ps aux | grep openclaw
# 查看线程详情
ps -T -p $(pgrep -f "openclaw-gatewa")
# 实时资源监控
top -p $(pgrep -f "openclaw gateway" -d,)
# 文件描述符数量（反映连接数）
ls /proc/$(pgrep -f "openclaw gateway")/fd | wc -l
故障排查
# 清理 Chromium 僵尸进程
pkill -f "chromium.*--remote-debugging"
pkill -f "chrome.*--headless"
# 检查端口占用（默认 18789）
ss -tlnp | grep 18789
# 检查配置健康状态
cat ~/.openclaw/logs/config-health.json
# 查看配置审计日志
tail -f ~/.openclaw/logs/config-audit.jsonl
# 关键配置文件路径
主配置文件（JSON5）
~/.openclaw/openclaw.json
AI 模型和 API Key 配置
~/.openclaw/agents/main/agent/models.json
Agent 人格设定
~/.openclaw/workspace/SOUL.md
用户信息
~/.openclaw/workspace/USER.md
Agent 操作指令和长期记忆
~/.openclaw/workspace/AGENTS.md
心跳/定时任务指令
~/.openclaw/workspace/HEARTBEAT.md
扫一扫
1506
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
