任务目标
在当前 Ubuntu 24.04.3 LTS 系统上安装 OpenClaw AI 助手工具。
环境检查
- 操作系统: Ubuntu 24.04.3 LTS (Linux 6.6.110-42.4.tl4.x86_64)
- Node.js: v22.13.1 (已安装，满足要求)
- npm: 11.9.0 (已安装，满足要求)
- Git: 2.43.0 (已安装，可选但推荐)
安装过程
1. 初始尝试：npm 全局安装
bash
复制
npm install -g @openclaw/cli
结果: 失败，返回 404 错误，表明包名可能不正确或已变更。
2. 成功安装：官方一键安装脚本
bash
复制
curl -fsSL https://openclaw.ai/install.sh | bash
安装输出:
�� OpenClaw Installer
✓ Detected: linux
✓ Node.js v22.13.1 found
✓ Git already installed
✓ OpenClaw npm package installed
✓ OpenClaw installed
�� OpenClaw installed successfully (OpenClaw 2026.3.8 (3caab92))!
注意: 安装脚本在最后阶段因 /dev/tty 设备缺失而报错，这可能是由于在非交互式环境中运行所致。但核心安装已成功完成。
安装验证
命令位置
bash
复制
which openclaw# 输出: /root/.nvm/versions/node/v22.13.1/bin/openclaw
版本确认
bash
复制
openclaw –version# 输出: OpenClaw 2026.3.8 (3caab92)
帮助菜单
openclaw –help 成功显示完整的命令列表，包括：
- onboard: 交互式入门向导
- configure: 交互式设置向导
- gateway: 运行 WebSocket 网关
- agent: 通过网关运行代理
- 以及其他管理命令
后续配置建议
OpenClaw 已成功安装，但需要进行初始配置才能使用完整功能：
推荐配置步骤
运行配置向导 (可能需要交互式终端):
bash
openclaw onboard
或
bash
openclaw configure
配置内容可能包括:
-
- 大模型 API 密钥 (如阿里云百炼、OpenAI 等)
- 聊天通道集成 (Telegram、Discord、WhatsApp 等)
- 工作区设置
- 技能和插件配置
启动网关服务 (基础运行环境):
bash
openclaw gateway
非交互式环境配置
如果无法进行交互式配置，可考虑使用环境变量或配置文件手动设置。参考官方文档：https://docs.openclaw.ai/cli
已知问题与解决方案
问题：/dev/tty: No such device or address
原因: 安装脚本尝试启动交互式向导，但当前环境缺乏终端设备。 解决方案:
- 在具有完整终端的交互式会话中运行 openclaw onboard
- 或使用非交互式配置方法（如环境变量）
问题：claw 命令不可用
现状: 仅 openclaw 命令可用，claw 可能为别名或旧版本命令。 解决方案: 可创建别名 alias claw=openclaw
文件位置
- OpenClaw CLI: /root/.nvm/versions/node/v22.13.1/bin/openclaw
- npm 全局包目录: /root/.nvm/versions/node/v22.13.1/lib/node_modules
- OpenClaw 状态目录: ~/.openclaw/ (配置后生成)
结论
OpenClaw 2026.3.8 已成功安装在系统中，核心 CLI 工具可正常运行。用户需要根据具体使用场景进行后续配置，特别是 API 密钥和通道集成设置。
