OpenClaw 本地安装

2026-05-05阅读 0热度 0

OpenClaw

说明

技术迭代的速度实在惊人。今天是2026年3月14日，特意记录下这个日期——因为再过两个月，这篇教程很可能就和你的界面版本对不上了。

安装

首先针对刚入门的朋友，这里使用的是M1芯片、8G内存、512G硬盘的配置。参考了技术博主Axela30W的安装指南，但实际操作中发现，号称新手首选的一键安装方案其实暗藏不少陷阱。

# 一键安装（号称新手首选其实坑也很多，新手大概率成功不了）
curl -fsSL https://openclaw.ai/install.sh | bash

在终端执行这个命令时，新手很大概率会遇到安装失败。最常见的问题是homebrew没有自动安装——理论上应该自动完成的步骤，实测多次都卡在了这里。这时候就需要先手动安装homebrew。

# 手动执行Homebrew官方安装命令（交互式，会提示输入密码）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

别以为执行就万事大吉了。安装过程中会与Xcode产生关联，同时需要访问GitHub。网络状况不佳时，这个步骤经常失败。幸运的是，经过几次重试后homebrew终于安装成功。接下来有个关键细节：一定要完全关闭终端窗口，否则执行brew --version会显示命令不存在。重新打开终端后，就能看到版本号了（当前是Homebrew 5.1.0）。

再次执行最初的一键安装命令，nodejs和npm都顺利安装完成，但在安装openclaw@latest时又出现了错误。最终通过豆包提供的这个命令解决了问题：

# 手动安装openclaw最新版
env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

使用openclaw -v查看安装版本，得到的是截至今天的最新版：OpenClaw 2026.3.12 (6472949)。需要说明的是，这里没有贴出具体截图，因为虽然安装成功了，但整个过程仅供参考。理解每个步骤的原理才可能成功安装，单纯按步骤操作很可能遇到不同的问题。

配置

按照教程应该使用openclaw init来初始化，但今天的版本这个命令已经失效，提示error: unknown command 'init'——这就是技术迭代速度的直观体现。下面直接基于官方发布的2026.3.12版本提供最准确的配置指引。

OpenClaw 2026.3.12官方标准配置流程

一、环境验证（官方要求）

# 检查Node.js版本（必须≥22.0.0）
node --version
# 检查Git版本
git --version
# 验证安装完整性
openclaw doctor

二、官方初始化流程

# 官方推荐初始化命令
openclaw onboard --install-daemon

交互式配置步骤：

Security Warning → 选择 Yes（个人使用默认安全）
Onboarding mode → 选择 QuickStart（最快配置）
Gateway port → 默认 18789，直接回车
Model/auth provider → 选择你的模型提供商（推荐国内厂商如阿里云百炼）
API Key配置 → 选择 Paste API key now 并粘贴你的API Key
Default model → 输入模型ID（如 qwen-plus）
Select channel → 可选择 Skip for now（后续配置）
Configure skills now? → 选择 Yes 配置技能
Enable hooks? → 全选（boot-md、session-memory等）
Hatch your bot → 选择 Hatch in TUI 进入终端界面

三、官方推荐配置优化

# 编辑官方配置文件
nano ~/.openclaw/openclaw.json

官方标准配置模板：

{
"gateway": {
"bind": "loopback",
"port": 18789,
"auth": {
"mode": "password"
}
},
"agent": {
"model": "anthropic/claude-opus-4-6",
"thinkingLevel": "high"
},
"dmPolicy": "pairing",
"agents": {
"defaults": {
"sandbox": {
"mode": "non-main",
"allowlist": ["bash", "read", "write", "edit"],
"denylist": ["浏览器", "cron", "system.run:elevated"]
}
}
}
}

四、官方启动与验证

# 启动服务
openclaw gateway start
# 验证服务状态
openclaw gateway status
# 功能测试
openclaw message send --target main --message "Hello from OpenClaw"

五、官方故障排查工具

# 诊断环境问题
openclaw doctor
# 查看日志
openclaw logs --tail 50
# 修复配置问题
openclaw doctor --fix

六、官方推荐的M系列芯片优化

# 启用MPS加速
export PYTORCH_ENABLE_MPS_FALLBACK=1
# 配置硬件加速
openclaw config set hardware.device mps

即使按照上面的配置操作，仍然可能遇到错误。这时候就需要重置后重新开始：

# 官方标准重置命令
openclaw onboard --reset
# 强制重置所有配置（彻底清理）
openclaw onboard --reset --force

访问

http://127.0.0.1:18789/#token=1f551a939210217ba5ef9847e83a884bd1e6675b

这个地址默认只能在本机MAC上访问，其他电脑无法连接。

# 查看当前绑定地址
openclaw config get gateway.bind

当前配置显示为loopback，这确实只允许本地访问。

# 修改为允许所有地址访问
openclaw config set gateway.bind lan
# 重启服务生效
openclaw gateway restart