🍎 OpenClaw 本地 MacBook 配置说明（简明版）

适用对象：不懂电脑的朋友。目标：你帮他 10-15 分钟完成本地安装，之后他自己能用。

本地运行你提供 API Key 一次配置长期使用

你提前准备（不要发错）

OpenAI/Codex API Key（给模型用）
Brave Search API Key（给网页搜索用）
提醒朋友：不要把 Key 发群里，不要截图外传。

你现场操作（照着粘贴）

步骤 1：安装 OpenClaw

让朋友打开「终端 Terminal」，粘贴下面命令：

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

步骤 2：配置 OpenAI/Codex Key + 安装后台服务

把下面命令里的 YOUR_OPENAI_KEY 替换成你准备好的 key：

openclaw onboard --install-daemon --openai-api-key "YOUR_OPENAI_KEY"

这一步会完成基础初始化，并把 Gateway 作为服务安装。

步骤 3：配置 Brave Search Key（推荐交互式）

openclaw configure --section web

按提示把 Brave Key 填进去即可（这一步最不容易输错）。

步骤 4：启动服务并自检

openclaw gateway start
openclaw gateway status
openclaw models status --probe
openclaw status

步骤 5：打开网页控制台

open http://127.0.0.1:18789/

如果打不开，先执行：openclaw gateway restart 再试。

步骤 6（可选）：后续配置 Telegram Channel

如果后续要接 Telegram，按下面做：

先在 Telegram 里找 @BotFather，创建 bot，拿到 bot token。
再在终端执行：

openclaw channels add --channel telegram --token "YOUR_TELEGRAM_BOT_TOKEN"
openclaw channels list
openclaw channels status --probe

测试发送（有 Telegram 用户名时最方便）：

openclaw message send --channel telegram --target @your_username --message "OpenClaw Telegram 已连接 ✅"

如果没有用户名，就用 chat_id 发送；可用下面命令解析：

openclaw channels resolve --channel telegram --kind user @your_username --json

成功标准（让朋友看这个）

openclaw gateway status 显示服务在运行。
openclaw models status --probe 没有认证报错。
浏览器能打开 http://127.0.0.1:18789/。

给朋友的“日常使用”最短命令

openclaw gateway status
openclaw gateway restart
open http://127.0.0.1:18789/

💤 MacBook 休眠怎么处理（重点）

结论先说：Mac 进入系统睡眠后，OpenClaw 也会暂停。想稳定在线，需要“防睡眠”或换常在线设备。

方案 A（推荐，临时防睡眠）

需要保持在线时，在终端开一个防睡眠窗口：

caffeinate -dimsu

停止时按 Ctrl + C 即可。

方案 B（插电场景，减少自动睡眠）

# 查看当前电源策略
pmset -g

# 仅在接电源时，关闭系统睡眠（更适合值守）
sudo pmset -c sleep 0

# 恢复默认（示例：10分钟，可按需改）
sudo pmset -c sleep 10

建议：只在插电时使用，电池模式仍保留自动睡眠。

方案 C（长期稳定）

如果要 24x7 在线，建议把 OpenClaw 部署到 VPS / 小主机（如树莓派），不要依赖笔记本常亮。

常见问题（你帮他排）

命令找不到 openclaw：关闭终端重新打开，再执行 openclaw help。
模型连不上：多半是 OpenAI/Codex Key 输错，重新跑第 2 步。
网页搜索不可用：重新执行 openclaw configure --section web 填 Brave Key。
服务状态异常：执行 openclaw gateway restart，再 openclaw status --all 查看。
Telegram 发不出去：先确认 bot token 正确，再执行 openclaw channels status --probe 检查连通性。

可选：你一次性全自动（适合你自己操作，不给小白）

把两个 key 都填好后，一次执行：

openclaw onboard --install-daemon --openai-api-key "YOUR_OPENAI_KEY"
openclaw config set tools.web.search.enabled true
openclaw config set tools.web.search.apiKey "YOUR_BRAVE_KEY"
openclaw gateway restart

如果也要顺手接入 Telegram（可选）：

openclaw channels add --channel telegram --token "YOUR_TELEGRAM_BOT_TOKEN"
openclaw channels status --probe