OpenClaw 是什么？
OpenClaw 是一个开源的、终端优先的个人 AI 助手框架，支持多模型接入（Claude、GPT 等）、技能扩展（联网、文件操作、提醒、Notion、GitHub 等）、多渠道聊天（WhatsApp、飞书、Telegram 等）。它不像 Cursor 是 IDE 插件，而是更像一个'AI 秘书'，可以本地运行、完全自定义、国内模型友好。
一、安装 OpenClaw（Mac 推荐方式）
步骤 1：一键安装
curl -fsSL https://openclaw.ai/install.sh | bash
- 安装过程会下载最新 CLI、安装到
~/.local/bin/openclaw - 可能会提示添加 PATH，已自动加到 ~/.zshrc（如果没有，手动加）：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
步骤 2：验证安装
openclaw --version
# 应该输出类似：OpenClaw 2026.3.2 (85377a2)
如果 command not found → 重新 source ~/.zshrc 或重开终端。
步骤 3：第一次启动（onboarding）
openclaw
- 会进入 onboarding 向导（文字交互）
- Security warning → 选 Yes（个人使用默认安全）
- Onboarding mode → 选 QuickStart（最快）
- Gateway port → 默认 18789，回车
- Model/auth provider → 选 Volcano Engine（火山引擎）
- How do you want to provide this API key? → 选 Paste API key now
- Enter Volcano Engine API key → 粘贴你的火山 Ark key（fb…开头的完整字符串）
- Default model → 手动输入：
ark/doubao-seed-2-0-pro-260215（或 code-preview 版） - Select channel → 可以先 Skip for now（后面再加 WhatsApp/飞书）
- Configure skills now? → 选 Yes，逐个看提示（apple-reminders、apple-notes、github 建议开，其他看需求）
- Set XXX_API_KEY for YYY? → 除了你需要的（如 Notion），其他都选 No
- Enable hooks? → 全选（boot-md、session-memory 等）
- How do you want to hatch your bot? → 选 Hatch in TUI（推荐）
完成 onboarding 后会进入 TUI 界面，如果看到模型是 ark/doubao-seed-2-0-pro-260215，恭喜第一步成功！
二、优化配置（避免 unknown model / timeout）
很多人在 onboarding 后会遇到 Unknown model: volcengine/… 或 timeout，原因是对内建 volcengine provider 的残留。
