早早集市

OpenClaw 安装入门（macOS）

OpenClaw 安装入门（macOS）

这篇只讲一件事。 把 OpenClaw 在 macOS 上装起来。

如果你用的是 Windows，去看另一篇。

这篇基于 OpenClaw 2026.3.2。

  • 一台 macOS
  • 能开的终端
  • 网络能访问 GitHub、npm
  • 如果你平时靠代理上网，那就先把代理配好

先别急着装。 先确认网络是不是通的。

curl -I https://google.com

如果这里不通，后面大概率也会卡。

如果你需要手动给终端加代理，可以先执行：

export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
export all_proxy=socks5://127.0.0.1:7890

端口按你自己的代理工具改。

如果你还没装 Homebrew，先跑：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

装完先确认：

brew --version

如果这里就报错，先别往下走。 先把 brew 这一步处理干净。

brew install node bun

装完马上检查：

node -v
npm -v
bun --version

这里有个小坑。

刚装完如果命令找不到，很多时候不是没装上。 只是当前终端还没刷新环境变量。 先关掉终端，再开一个新的。

npm install -g openclaw

装完确认：

openclaw --version

如果这里报权限问题，不要上来就 sudo。 先看你自己的 npm 全局目录配置是不是正常。

第一次装，推荐先走这条：

openclaw setup --wizard

如果你想一次把更多东西配掉，也可以试：

openclaw onboard

但第一次上手，我还是建议 setup --wizard。 简单一点。

openclaw gateway start

然后检查：

openclaw gateway status

如果这里没起来，后面的 Agent、飞书、消息路由都不用谈。

至少跑这几条：

openclaw status
openclaw gateway status
openclaw config file
openclaw config validate

主配置通常在：

~/.openclaw/openclaw.json

OpenClaw 本质上就是： CLI + workspace + 一堆配置文件。

先认这几个：

  • SOUL.md：Agent 的人格、语气、角色定位
  • USER.md：你是谁、偏好什么
  • MEMORY.md：长期稳定记忆
  • memory/*.md：每天的短期记录
  • AGENTS.md：分工和工作规则

默认主 Agent 的 workspace 通常在：

~/.openclaw/agents/main/workspace

先看当前模型：

openclaw models status --plain

再看可用模型：

openclaw models list

如果你要切默认模型：

openclaw models set github-copilot/gpt-5.2

这里先提醒一句。

先配认证，再切模型。 不然你切过去也可能不能用。

先看：

openclaw models auth --help

先看现有 Agent：

openclaw agents list

如果你要新建一个：

openclaw agents add writer

如果你想顺手指定模型和目录：

openclaw agents add writer --workspace ~/.openclaw/agents/writer/workspace --model github-copilot/claude-sonnet-4.6

建完之后，重点不是命令。 是去它自己的 workspace 里改：

  • SOUL.md
  • USER.md
  • MEMORY.md

完整教程在这里：

给 OpenClaw 新增一个 Agent（以飞书机器人为例）

这里只说最关键的。

这里不要按我给你列几个权限名就机械地搜。 因为 im:message 在飞书后台是一整组消息权限，不是一个点。

更稳的做法是：

在飞书开放平台里，围绕这几类能力去开：

  • 机器人收消息
  • 机器人发消息
  • 单聊消息
  • 群聊消息 / 被 @ 消息
  • 用户 ID 读取

也就是你在权限后台里，至少要把和下面这些关键词相关的消息权限开出来：

  • im:message
  • im:message:send_as_bot
  • contact:user.id:readonly

然后把 im:message 下面那组和收消息相关的权限一起确认一遍。 别只开一个名字最短的就以为结束了。

在飞书开放平台里：

  • 进入你的 App
  • 打开「事件与回调」
  • 选择 长连接
  • 开启它
  • 订阅事件：im.message.receive_v1

这里有个顺序坑。

先启动 Gateway，再去飞书后台开长连接。 顺序反了，飞书那边经常会报没检测到连接。

你至少要配两块。

channels.feishu.accounts

"writer": {
  "appId": "cli_xxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxx",
  "domain": "feishu",
  "enabled": true,
  "dmPolicy": "open",
  "groupPolicy": "open",
  "allowFrom": ["*"]
}

顶层 bindings

{
  "agentId": "writer",
  "match": {
    "channel": "feishu",
    "accountId": "writer"
  }
}

这里不要漏。

很多人只加了账号，或者只加了 Agent。 结果就是飞书消息根本路由不过去。

openclaw gateway restart
openclaw channels status --probe

如果状态正常，你应该能看到类似：

  • enabled
  • configured
  • running
  • works
  1. 先装 Homebrew
  2. 再装 Node 和 bun
  3. 安装 OpenClaw
  4. 跑 openclaw setup --wizard
  5. 启动 Gateway
  6. 跑 status / config validate
  7. 再改 SOUL.md 和模型
  8. 最后再接飞书

别一上来就飞书。 先把本地跑通。 这样后面会省很多事。