Mac安装和配置OpenClaw的超详细保姆级教程(附 skills安装)

目录

• OpenClaw 是什么？
• 一、安装 OpenClaw（Mac 推荐方式）
• 二、优化配置（避免 unknown model / timeout）
• 三、安装 skills（重点：用 npx clawhub install）
• 四、常见问题速查

OpenClaw 是一个开源的、终端优先的个人 AI 助手框架，支持多模型接入（Claude、GPT 等）、技能扩展（联网、文件操作、提醒、Notion、GitHub 等）、多渠道聊天（WhatsApp、飞书、Telegram 等）。它不像 Cursor 是 IDE 插件，而是更像一个“AI 秘书”，可以本地运行、完全自定义、国内模型友好。

步骤 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，恭喜第一步成功！

很多人在 onboarding 后会遇到 Unknown model: volcengine/… 或 timeout，原因是对内建 volcengine provider 的残留。

步骤：手动修正配置

1. 打开配置文件：

nano ~/.openclaw/openclaw.json

2. 确保 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

5. 进 TUI 后输入：

/new
/model ark/doubao-seed-2-0-pro-260215

再问“你好，用繁体中文回我”，如果正常回复 → 配置成功！

OpenClaw 的技能主要通过 ClawHub 安装，命令是 npx clawhub install <skill-name>（不是 openclaw skills install）。

步骤示例：安装 Tavily 搜索技能

1. 确保 npx 可用（Node.js 自带）：

npx --version

2. 安装 tavily-search：

npx clawhub install tavily-search

• 会自动下载技能到 ~/.openclaw/workspace/skills/tavily-search
• 如果提示权限问题，加 sudo 或检查目录权限

3. 配置 Tavily API Key（最稳用 export）：

export TAVILY_API_KEY="tvly-你的完整 key"

（或写进 ~/.openclaw/.env）

4. 重启：

openclaw gateway restart
openclaw tui

5. 测试：

/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

到此这篇关于【2026 最新】Mac 上手 OpenClaw 超详细保姆级教程（附 skills 安装）的文章就介绍到这了,更多相关mac openclaw安装内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！