OpenClaw 是什么？

OpenClaw 是一個(gè)開源的、終端優(yōu)先的個(gè)人 AI 助手框架，支持多模型接入（Claude、GPT 等）、技能擴(kuò)展（聯(lián)網(wǎng)、文件操作、提醒、Notion、GitHub 等）、多渠道聊天（WhatsApp、飛書、Telegram 等）。它不像 Cursor 是 IDE 插件，而是更像一個(gè)“AI 秘書”，可以本地運(yùn)行、完全自定義、國內(nèi)模型友好。

一、安裝 OpenClaw（Mac 推薦方式）

步驟 1：一鍵安裝

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

• 安裝過程會(huì)下載最新 CLI、安裝到 ~/.local/bin/openclaw
• 可能會(huì)提示添加 PATH，已自動(dòng)加到 ~/.zshrc（如果沒有，手動(dòng)加）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

步驟 2：驗(yàn)證安裝

openclaw --version
# 應(yīng)該輸出類似：OpenClaw 2026.3.2 (85377a2)

如果 command not found → 重新 source ~/.zshrc 或重開終端。

步驟 3：第一次啟動(dòng)（onboarding）

openclaw

• 會(huì)進(jìn)入 onboarding 向?qū)Вㄎ淖纸换ィ?/li>
• Security warning → 選 Yes（個(gè)人使用默認(rèn)安全）
• Onboarding mode → 選 QuickStart（最快）
• Gateway port → 默認(rèn) 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 → 手動(dòng)輸入：ark/doubao-seed-2-0-pro-260215（或 code-preview 版）
• Select channel → 可以先 Skip for now（后面再加 WhatsApp/飛書）
• Configure skills now? → 選 Yes，逐個(gè)看提示（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 后會(huì)進(jìn)入 TUI 界面，如果看到模型是 ark/doubao-seed-2-0-pro-260215，恭喜第一步成功！

二、優(yōu)化配置（避免 unknown model / timeout）

很多人在 onboarding 后會(huì)遇到 Unknown model: volcengine/… 或 timeout，原因是對(duì)內(nèi)建 volcengine provider 的殘留。

步驟：手動(dòng)修正配置

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 相關(guān)（auth.profiles、舊 models）。
• 保存后重啟：

openclaw doctor --fix
openclaw gateway restart
openclaw tui

5. 進(jìn) TUI 后輸入：

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

再問“你好，用繁體中文回我”，如果正常回復(fù) → 配置成功！

三、安裝 skills（重點(diǎn)：用 npx clawhub install）

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

• 會(huì)自動(dòng)下載技能到 ~/.openclaw/workspace/skills/tavily-search
• 如果提示權(quán)限問題，加 sudo 或檢查目錄權(quán)限

3. 配置 Tavily API Key（最穩(wěn)用 export）：

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

（或?qū)戇M(jìn) ~/.openclaw/.env）

4. 重啟：

openclaw gateway restart
openclaw tui

5. 測(cè)試：

/new
用 Tavily 搜索 2026 年多模態(tài)推理最新論文

其他常用技能安裝命令（直接復(fù)制跑）：

• 學(xué)術(shù)論文搜索（OpenAlex，無需 key）：

npx clawhub install academic-research

• arXiv 專用：

npx clawhub install arxiv-search-collector

• Hugging Face 數(shù)據(jù)集/模型搜索：

npx clawhub install hugging-face-datasets

• 安裝后都重啟 gateway + tui 測(cè)試。

四、常見問題速查

• Unknown model: volcengine/… → 刪 auth.profiles.volcengine:default + doctor --fix
• LLM request timed out → 換翻墻節(jié)點(diǎn)（香港/臺(tái)灣）+ 檢查 key
• 技能沒載入 → ls ~/.openclaw/workspace/skills 確認(rèn)文件夾存在
• TUI 界面亂碼 → 終端字體換成 Nerd Font

到此這篇關(guān)于【2026 最新】Mac 上手 OpenClaw 超詳細(xì)保姆級(jí)教程（附 skills 安裝）的文章就介紹到這了,更多相關(guān)mac openclaw安裝內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論