【第4篇】OpenClaw 安装指南:从零开始的完整教程

作者：Mac | OpenClaw 实操系列

前置要求

在安装 OpenClaw 之前，确保你的设备满足以下要求：

macOS 安装

方法一：Homebrew（推荐）

# 安装 Homebrew（如果没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 OpenClaw
brew install openclaw

方法二：npm 全局安装

# 安装 Node.js（如果没有）
brew install node

# 安装 OpenClaw
npm install -g openclaw

验证安装

openclaw --version
# 应该显示：openclaw/版本号

Windows 安装

方法一：官方安装包

1. 1. 访问 openclaw.ai^[1]
2. 2. 下载 Windows 安装包（.exe）
3. 3. 双击运行，一路下一步

方法二：npm 安装

# 1. 安装 Node.js
# 下载地址：https://nodejs.org/

# 2. 打开 PowerShell（管理员）
npm install -g openclaw

方法三：WSL（Linux 子系统）

# 1. 启用 WSL
wsl --install

# 2. 进入 Linux 环境
wsl

# 3. 按 Linux 安装步骤操作

Linux 安装

Ubuntu / Debian

# 1. 安装 Node.js 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 安装 OpenClaw
sudo npm install -g openclaw

# 3. 安装可选依赖
sudo apt-get install -y libsecret-1-dev

CentOS / RHEL

# 1. 安装 Node.js
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo yum install -y nodejs

# 2. 安装 OpenClaw
sudo npm install -g openclaw

Arch Linux

# 使用 yay 或其他 AUR 助手
yay -S openclaw

初始化配置

启动引导程序

openclaw init

你会看到以下交互式配置：

┌─────────────────────────────────────────┐
│       OpenClaw 初始化向导               │
└─────────────────────────────────────────┘

1. AI 模型配置
   [1] Anthropic Claude（推荐）
   [2] OpenAI GPT
   [3] 阿里百炼
   [4] 其他/自定义

   请选择：1

2. 输入你的 API Key：sk-ant-xxxxx

3. 渠道配置
   是否启用飞书？[Y/n] y
   是否启用微信？[y/N] n

4. 管理后台
   设置管理员密码：********

5. 确认配置
   保存到 ~/.openclaw/config.yaml [Y]

✓ 配置完成！

手动配置（可选）

如果想手动编辑配置：

# 打开配置文件
openclaw config edit

# 或者直接编辑文件
nano ~/.openclaw/openclaw.json

启动服务

方式一：命令行启动

openclaw gateway start

# 输出示例：
# ✓ Gateway 启动中...
# ✓ HTTP 服务: http://127.0.0.1:18789
# ✓ WebSocket: ws://127.0.0.1:18789
# ✓ Dashboard: http://127.0.0.1:18789/dashboard
# ✓ 状态: 运行中

方式二：后台运行

# 使用 nohup 后台运行
nohup openclaw gateway start > /tmp/openclaw.log 2>&1 &

# 查看日志
tail -f /tmp/openclaw.log

方式三：systemd 服务（Linux）

# 创建服务文件
sudo nano /etc/systemd/system/openclaw.service

写入以下内容：

[Unit]
Description=OpenClaw AI Assistant
After=network.target

[Service]
Type=simple
User=你的用户名
ExecStart=/usr/local/bin/openclaw gateway start
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

验证安装

访问 Dashboard

打开浏览器访问：

http://127.0.0.1:18789/dashboard

用设置的密码登录。

发送第一条消息

openclaw chat "你好，测试一下"

# 预期输出：
# AI: 你好！我是 OpenClaw，有什么可以帮你的？

常见问题

Q: 提示 "command not found"

解决：

# 检查是否安装成功
npm list -g openclaw

# 如果没有，尝试重新安装
sudo npm install -g openclaw

# 确保 PATH 包含 npm 全局目录
export PATH="$PATH:$(npm bin -g)"

Q: 端口被占用

解决：

# 查看占用端口的进程
lsof -i :18789

# 杀死进程或修改端口
openclaw gateway start --port 18790

Q: API Key 无效

解决：

# 检查 API Key 配置
openclaw config get models.providers.anthropic.apiKey

# 重新配置
openclaw config set models.providers.anthropic.apiKey "你的新Key"

下一步

• • 上一篇：自托管 AI 的安全优势^[2]
• • 下一篇：OpenClaw 配置详解：让 AI 更懂你^[2]

关注公众号，获取更多 OpenClaw 实操教程！

作者：Mac | OpenClaw 实操系列第4篇

引用链接

[1] openclaw.ai: https://openclaw.ai/download
[2] 自托管 AI 的安全优势: