大模型使用费token 强烈推荐使用minimax 按钮 290 点击我的链接有优惠券大概270？划算，如果是u用调用频率不高非常可以用，不用担心欠费问题（deepseek也耗钱但还可以看个人能不能接受 尤其是 阿里的qwq 太烧钱了一晚上花了几十块 我大爷的）

🚀 MiniMax Token Plan 惊喜上线！新增语音、音乐、视频和图片生成权益。邀请好友享双重好礼，助力开发体验！
好友立享 9折 专属优惠 + Builder 权益，你赢返利 + 社区特权！
👉 立即参与：https://platform.minimaxi.com/subscribe/token-plan?code=2NMAwoNLlZ&source=link

前言

最近在研究自动化工作流工具，发现了OpenClaw这个宝藏项目。本文将详细介绍在Linux系统上安装部署OpenClaw的完整过程，包含踩坑记录和解决方案，希望对大家有所帮助。

什么是OpenClaw？

OpenClaw是一个开源的工作流自动化工具，可以帮助我们轻松构建和管理自动化任务。具体特性这里就不展开介绍了，感兴趣的朋友可以访问官方文档了解。

系统要求

在开始安装之前，确保你的Linux系统满足以下要求：

1.Node.js 22+（安装脚本会自动处理，也可以手动安装）
2.支持的主流Linux发行版（Ubuntu/CentOS/Debian等）
3.网络连接正常

安装方式对比

OpenClaw提供了三种安装方式，我们来简单对比一下：

本文主要介绍官方脚本安装这种方式，最适合新手。
详细安装步骤

方法一：官方脚本安装（推荐）

这是最简单的安装方式，一条命令搞定：

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

这个脚本会自动：

1.检测系统Node环境
2.如需安装Node 22+
3.全局安装OpenClaw CLI
4.启动初始化向导

如果你只想安装CLI工具，暂时跳过初始化配置，可以使用：

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

方法二：npm手动安装

如果你已经安装了Node.js 22+，也可以使用npm进行安装：

# 全局安装openclaw
npm install -g openclaw@latest

# 安装守护进程并初始化
openclaw onboard --install-daemon

方法三：源码编译安装

对于想参与开发或自定义编译的朋友，可以尝试源码安装：

# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖并构建
pnpm install
pnpm ui:build
pnpm build

# 3. 全局链接CLI
pnpm link --global

# 4. 运行初始化
openclaw onboard --install-daemon

安装后验证
安装完成后，可以通过以下命令验证安装是否成功：

# 检查配置问题
openclaw doctor

# 查看网关状态
openclaw status

# 打开Web管理界面
openclaw dashboard

如果一切正常，你应该能看到服务正常运行的状态信息，并且openclaw dashboard会在浏览器中打开管理界面。

常见问题与解决方案

问题1：command not found: openclaw
现象：安装成功后，输入openclaw提示命令未找到。

解决方案：

# 1. 检查Node和npm是否正常
node -v
npm -v

# 2. 查看npm全局安装路径
npm prefix -g

# 3. 将npm全局bin目录添加到PATH
export PATH="$(npm prefix -g)/bin:$PATH"

# 4. 永久生效（添加到bashrc或zshrc）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
# 如果使用zsh
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc

# 5. 重新加载配置
source ~/.bashrc  # 或 source ~/.zshrc

问题2：Node版本过低
现象：安装过程中提示Node版本需要22+。

解决方案：
使用nvm安装指定版本的Node：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装Node 22+
nvm install 22
nvm use 22

问题3：权限不足
现象：安装时出现EACCES权限错误。

解决方案：

# 方法1：使用sudo（不推荐）
sudo npm install -g openclaw@latest

# 方法2：修复npm权限（推荐）
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

环境变量配置
OpenClaw支持以下环境变量来自定义路径：

可以在~/.bashrc中配置：

export OPENCLAW_HOME="$HOME/.openclaw"
export OPENCLAW_STATE_DIR="$HOME/.local/state/openclaw"
export OPENCLAW_CONFIG_PATH="$HOME/.config/openclaw/config.json"

卸载方法
如果需要卸载OpenClaw，可以执行：

# 卸载全局包
npm uninstall -g openclaw

# 删除配置文件（可选）
rm -rf ~/.openclaw
rm -rf ~/.config/openclaw
rm -rf ~/.local/state/openclaw

总结

通过本文，我们详细介绍了在Linux系统上安装OpenClaw的三种方式，并提供了常见问题的解决方案。官方脚本安装最为简单，适合大多数用户；npm安装适合已有Node环境的用户；源码编译则适合开发者和贡献者。

安装过程中遇到最多的就是PATH问题，只要按照文中方案配置好环境变量，一般都能顺利解决。如果还有其他问题，欢迎在评论区留言交流！

参考资料
OpenClaw官方安装文档
OpenClaw GitHub仓库