跳转到内容

最近更新 · 2026-01-30

OpenClaw 本地安装（Mac / Linux）

⚠️ 重要安全提醒（请认真看）
OpenClaw 可能具备执行命令的能力（shell 权限级别风险）。
强烈建议：先用旧电脑 / 虚拟机 / 新建系统账号测试，不要在含重要资料的主力工作机“裸奔运行”。

你将完成什么

  • 在 Mac / Linux 安装 OpenClaw
  • 完成首次初始化（onboarding）
  • 启动并验证 OpenClaw 正常工作
  • 学会处理最常见的安装/启动问题（命令找不到、权限、代理、旧版冲突）

开始前准备（小白必看）

需要的东西

  • 一个终端：Mac 用 Terminal；Linux 用系统自带终端
  • 网络可访问安装源（如果你在网络受限环境，请看“代理设置”）
  • 一个可用的模型 API Key（例如 Anthropic/Claude）

推荐环境

  • ✅ 仅体验：本地也可以，但最好是 虚拟机/旧电脑
  • ✅ 长期运行：建议走 Docker/VPS（更安全）→ /docs/vps-setup

Step 0：检查系统基础（可选但推荐）

bash
uname -awhoami

Step 1：安装 OpenClaw（两种方式）

你提供的“curl | bash”是最快方式，但对小白来说存在争议：你是在执行远程脚本。
我建议在教程里同时提供更安全方式 A 和快速方式 B。

方式 A（推荐，更安全）：下载脚本再执行

bash
curl -fsSL https://openclaw.bot/install.sh -o install.sh# 可选：先快速看一眼脚本内容（至少确认不是乱七八糟的）sed -n '1,120p' install.shbash install.sh

方式 B（最快，但风险更高）

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

✅ 验证（必须做）
安装完成后执行：

bash
openclaw --version || truewhich openclaw || true

你应该看到版本号，并且 which openclaw 输出路径（例如 /usr/local/bin/openclaw 或某个用户目录下）。

Step 2：如果提示 “openclaw 命令找不到”

这是最常见问题之一。按顺序排查：

2.1 重新打开终端

很多安装脚本会修改 PATH，重新打开终端可让配置生效。

2.2 手动加载 shell 配置

bash
# zsh 用户（Mac 默认多数）source ~/.zshrc 2>/dev/null || true# bash 用户source ~/.bashrc 2>/dev/null || true

2.3 检查 PATH 与安装位置

bash
echo $PATHwhich openclaw || true

Step 3：处理“旧版 moltbot / clawdbot 与新版 openclaw 冲突”（强烈建议做）

近期项目从 Moltbot 更名为 OpenClaw（此前为 Clawdbot），用户机器上可能残留旧包/旧命令。

现象

  • 你输入 openclaw 报错 / 找不到
  • 或能执行但行为奇怪、命令参数不一致

建议处理

bash
npm uninstall -g clawdbot || truenpm uninstall -g moltbot || truenpm uninstall -g openclaw || true

然后重新执行 Step 1 安装。

✅ 验证

bash
which moltbot || truewhich clawdbot || truewhich openclaw || trueopenclaw --version

Step 4：首次初始化（onboarding）

bash
openclaw onboard --flow quickstart

它通常会问你这些（你可以按下面建议选）：

  • 是否理解高风险能力：输入 yes
  • 选择通信通道：新手建议先选 Telegram（最稳定、最容易验证）
  • 输入模型 API Key（例如 Anthropic/Claude）
  • 选择默认模型（按你账户可用情况）

✅ 验证

  • onboarding 结束没有报错
  • 提示配置已保存（通常会写入 ~/.openclaw 之类目录）

Step 5：启动 OpenClaw

前台启动（推荐先用这个，方便看到报错）：

bash
openclaw start

后台启动（可选）：

bash
openclaw start --detach

✅ 验证方式（至少做一个）

  1. 日志无持续报错（推荐）
  2. 你选的通道里发送测试消息，能收到响应（最直观）

Step 6：网络/代理问题（国内或受限网络常见）

现象

  • onboarding 卡住
  • 下载技能/依赖失败
  • 通道无响应

解决：先设置代理再启动

bash
export https_proxy=http://127.0.0.1:7890export http_proxy=http://127.0.0.1:7890# 重新启动openclaw start

Step 7：权限错误（EACCES / Permission denied）

现象

  • npm 全局安装时报 EACCES
  • 写入目录失败

推荐解决方案（更稳）

  • 使用 nvm 管理 Node（避免全局安装权限乱）
  • 或把运行目录放在你的用户目录下

如果你不想折腾权限问题，建议直接用 Docker/VPS 部署：/docs/vps-setup

常见问题（小白高频）

Q1：启动后通道不响应？

  • 先排查网络是否可访问（代理/防火墙）
  • 先用 Telegram 做最小闭环验证
  • 看日志定位错误（通常在启动输出中）

Q2：技能下载失败（GitHub 限速/网络不稳）？

  • 先确保网络稳定
  • 受限网络可先配置代理
  • 必要时手动下载再放入数据目录（见 troubleshooting）

安全提醒（再次强调）

  • 不要在有重要资料的电脑上直接跑
  • API Key 不要写进 git，不要截图泄露
  • 有长期需求请走 VPS/Docker（权限隔离）→ /docs/vps-setup
  • 建议阅读安全加固指南 → /docs/advanced-config

下一步推荐

  • 更安全的部署方式：/docs/vps-setup
  • 常见报错与截图排查：/docs/troubleshooting
  • VPS 选择建议：/vps
  • 真实用户案例/教程索引：/use-cases

TweetEmbed 示例（如你站点支持 MDX 组件）