环境信息

  • 操作系统：Ubuntu 24.04 LTS
  • 运行时：Node.js 22.x
  • 硬件平台：国产海光处理器
  • AI 服务：火山引擎方舟 Coding Plan API

前置说明

OpenClaw 的架构设计决定了其安装配置过程对权限要求较高，建议全程使用 root 或 sudo 执行。虽然这在生产环境中确实存在安全隐患，但考虑到本次部署仅用于研究实验目的，风险可控。

💡 网络建议：以下步骤涉及大量资源下载，建议全程开启magic工具。

一、环境准备

1.1 安装网络代理工具（可选但推荐）

# 下载 FlClash（以 v0.8.92 为例）
wget https://hub.wgen.top/https://github.com/chen08209/FlClash/releases/download/v0.8.92/FlClash-0.8.92-linux-amd64.deb

# 安装
sudo apt install ./FlClash-0.8.92-linux-amd64.deb

1.2 安装基础依赖

sudo apt update && sudo apt install -y wget curl git

1.3 获得apikey

二、Node.js 环境配置

OpenClaw 依赖 Node.js 22+，而 Ubuntu 官方源默认版本仍为 18.x，需通过 NodeSource 脚本升级：

# 添加 NodeSource 22.x 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js 与 npm
sudo apt install -y nodejs

验证安装结果：

node -v   # 预期输出：v22.x.x
npm -v    # 预期输出：10.x.x

三、OpenClaw 安装

3.1 全局安装

sudo npm install -g openclaw@latest

3.2 版本确认

openclaw -V

正常应返回版本号，如 2026.3.11。

四、初始化配置与服务部署

重要：npm 全局安装路径需要 root 权限，否则 systemd 服务无法写入。

sudo openclaw onboard --install-daemon

向导配置选项说明

配置项选择建议
Gateway 模式本地（Loopback）或远程，按需选择
认证方式OpenAI Code (Codex) OAuth 或 API Key；Anthropic 推荐 API Key，也支持 claude setup-token
通讯渠道WhatsApp（QR 登录）、Telegram/Discord（Bot Token）、Mattermost（Plugin Token）等
守护进程后台安装（systemd/launchd）；WSL2 使用 systemd
运行时Node（强烈推荐），WhatsApp/Telegram 必需；不建议使用 Bun
Gateway Token向导自动生成，存储于 gateway.auth.token，即使 Loopback 模式也建议保留

📖 详细文档参考：官方向导指南

五、部署结果概览

5.1 环境信息

项目详情
运行用户root
版本号OpenClaw 2026.3.11 (commit: 29dc654)
配置文件/root/.openclaw/openclaw.json
工作目录/root/.openclaw/workspace
会话存储/root/.openclaw/agents/main/sessions

5.2 核心配置

安全确认

  • ✅ 已确认个人代理模式（Personal Agent Mode）安全警告

引导模式：QuickStart

参数配置值
监听端口18789
绑定地址127.0.0.1（Loopback）
认证方式Token
Tailscale关闭

模型配置

配置项详情
提供商火山引擎方舟 Coding Plan（性价比方案：¥40/月，首月 ¥9）
API Key<your_token>
模型volcengine-plan/glm-4.7

通讯渠道

  • 当前状态：全部跳过（计划后续手动配置）
  • DM 安全策略：默认配对模式，需执行 openclaw pairing approve 批准私聊

技能与扩展

类别配置
Node 管理器npm
已安装技能clawhub
第三方 API全部跳过（Google Places、Gemini、Notion、OpenAI、ElevenLabs 等）

已启用 Hooks（跨会话记忆支持）：

Hook功能说明
boot-md启动时自动加载用户配置文件，确保个性化设置即时生效
command-logger自动记录执行命令与交互日志，便于审计与调试
session-memory持久化会话记忆，实现上下文连贯的对话体验

六、服务状态检查

组件状态备注
Systemd 服务✅ 正常Root 用户下安装成功
网关服务✅ 运行中Node 运行时
健康检查✅ 通过ws://127.0.0.1:18789 可连接
Shell 补全✅ 已安装执行 source ~/.bashrc 生效

七、访问方式

用途地址
Web 控制台http://127.0.0.1:18789/
带 Token 控制台（完整功能）http://127.0.0.1:18789/#token=<your_token>
WebSocket 端点ws://127.0.0.1:18789

部署完成 🎉

如需调整配置或排查问题，可查看日志：

sudo journalctl -u openclaw -f