【2026 最新】Mac 上手 OpenClaw 超详细保姆级教程（附 skills 安装）
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 的残留。
步骤：手动修正配置
- 打开配置文件：
nano ~/.openclaw/openclaw.json - 确保 models 部分是下面这样（替换你的完整 key）：
"models":{"providers":{"ark":{"baseUrl":"https://ark.cn-beijing.volces.com/api/v3","apiKey":"你的完整 fb... key","api":"openai-completions","models":[{"id":"doubao-seed-2-0-pro-260215","name":"豆包 Seed 2.0 Pro","contextWindow":256000,"maxTokens":128000},{"id":"doubao-seed-2-0-code-preview-260215","name":"豆包 Seed 2.0 Code Preview","contextWindow":256000,"maxTokens":128000}]}}},"agents":{"defaults":{"model":{"primary":"ark/doubao-seed-2-0-pro-260215"},"models":{"ark/doubao-seed-2-0-pro-260215":{},"ark/doubao-seed-2-0-code-preview-260215":{}}}}- 删除任何残留的
volcengine相关（auth.profiles、旧 models）。 - 保存后重启：
openclaw doctor --fix openclaw gateway restart openclaw tui - 进 TUI 后输入：
/new /model ark/doubao-seed-2-0-pro-260215 再问“你好，用繁体中文回我”，如果正常回复 → 配置成功！
三、安装 skills（重点：用 npx clawhub install）
OpenClaw 的技能主要通过 ClawHub 安装，命令是 npx clawhub install <skill-name>（不是 openclaw skills install）。
步骤示例：安装 Tavily 搜索技能
- 确保 npx 可用（Node.js 自带）：
npx --version- 安装 tavily-search：
npx clawhub install tavily-search - 会自动下载技能到
~/.openclaw/workspace/skills/tavily-search - 如果提示权限问题，加 sudo 或检查目录权限
- 配置 Tavily API Key（最稳用 export）：
exportTAVILY_API_KEY="tvly-你的完整 key"（或写进 ~/.openclaw/.env）
- 重启：
openclaw gateway restart openclaw tui - 测试：
/new 用 Tavily 搜索 2026 年多模态推理最新论文 其他常用技能安装命令（直接复制跑）：
- 学术论文搜索（OpenAlex，无需 key）：
npx clawhub install academic-research - arXiv 专用：
npx clawhub install arxiv-search-collector - Hugging Face 数据集/模型搜索：
npx clawhub install hugging-face-datasets - 安装后都重启 gateway + tui 测试。
四、常见问题速查
- Unknown model: volcengine/… → 删 auth.profiles.volcengine:default + doctor --fix
- LLM request timed out → 换翻墙节点（香港/台湾）+ 检查 key
- 技能没载入 → ls ~/.openclaw/workspace/skills 确认文件夹存在
- TUI 界面乱码 → 终端字体换成 Nerd Font
