夜雨聆风作者：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. 访问 openclaw.ai[1] 2. 下载 Windows 安装包（.exe） 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-devCentOS / 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 openclawArch 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 18790Q: 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 的安全优势:
