0. 本文目標(biāo)與讀者

本文面向“想把 OpenClaw 當(dāng)作個人 AI 助手 + 多渠道 IM 機(jī)器人”的用戶，覆蓋：

• macOS / Linux / Windows(WSL2) 安裝部署與常見運(yùn)行方式
• 配置 模型 Provider（OpenAI / Anthropic / LiteLLM / 本地 Ollama 等）
• 配置 IM 渠道機(jī)器人（Telegram/Discord/Slack/WhatsApp/WebChat…）的基本思路
• 最常用的 Skills 安裝與使用、插件/擴(kuò)展（OpenClaw plugins）管理
• 瀏覽器控制（OpenClaw-managed Chromium + Chrome 擴(kuò)展 relay）
• 搜索引擎 API（Brave / Perplexity / Firecrawl）
• Obsidian skills（基于 obsidian-cli 操作 vault）

說明：本文內(nèi)容基于 OpenClaw 官方倉庫與文檔。

• 倉庫：https://github.com/openclaw/openclaw
• 文檔導(dǎo)航（建議收藏）：https://docs.openclaw.ai

1. OpenClaw 是什么？核心組成

OpenClaw 是一個運(yùn)行在你自己設(shè)備上的個人 AI 助手。

它的關(guān)鍵點：

• Gateway（網(wǎng)關(guān)/控制平面）：常駐進(jìn)程，連接消息渠道、管理會話、工具、事件與 Web UI。
• Agent（智能體）：在 Gateway 的調(diào)度下運(yùn)行，調(diào)用模型、調(diào)用工具、讀寫 workspace。
• Tools（內(nèi)置工具）：瀏覽器控制、web_fetch/web_search、exec、消息發(fā)送等。
• Skills（技能包）：更像“可復(fù)用的操作手冊 + 可選的外部二進(jìn)制依賴”，在系統(tǒng)提示詞里以“可用技能清單”形式出現(xiàn)，模型需要時會去讀取對應(yīng) SKILL.md。
• Plugins（插件/擴(kuò)展）：以 in-process 的方式擴(kuò)展 Gateway：新增渠道、工具、OAuth 登錄流、技能包等。

2. 安裝部署（macOS / Linux / Windows）

OpenClaw 推薦用 CLI 向?qū)瓿沙跏蓟簅penclaw onboard（安裝 daemon、配置 workspace、channels、skills、models）。

2.1 前置要求

• Node 版本：Node ≥ 22（官方 README 明確要求）

檢查：

node -v

2.2 方式 A：官方推薦（npm 全局安裝）

npm install -g openclaw@latest
# 或 pnpm add -g openclaw@latest
openclaw onboard --install-daemon

--install-daemon 會把 Gateway 安裝成后臺服務(wù)（macOS 上是 launchd；Linux 上通常是 systemd user service；Windows 推薦 WSL2 跑 Linux 流程）。

2.3 Windows：強(qiáng)烈推薦 WSL2

根據(jù)官方 README：Windows 通過 WSL2 使用（strongly recommended）。

基本思路：

• 安裝 WSL2 + Ubuntu
• 在 WSL2 里安裝 Node ≥ 22
• 按 Linux 流程安裝 openclaw 并 openclaw onboard --install-daemon

提示：如果你要跑瀏覽器控制或某些依賴系統(tǒng) GUI 的能力，建議把 Gateway 放在真正有桌面環(huán)境的機(jī)器上（例如本機(jī) macOS / Linux 桌面）。

2.4 方式 B：從源碼（適合開發(fā)/深度定制）

（來自官方 README 的“From source”段落）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
# 開發(fā)熱更新
pnpm gateway:watch

3. 初次上手：onboard 向?qū)鍪裁?/h2>

openclaw onboard 會引導(dǎo)你完成：

• Gateway 基本配置（端口、綁定方式、鑒權(quán)、daemon）
• Workspace 初始化（默認(rèn)在 ~/.openclaw/workspace，可改）
• Model/Auth（API Key / OAuth / setup-token）
• Channels（Telegram/Discord/WhatsApp/Google Chat/Signal/iMessage/…）
• Skills（挑選/安裝）

如果你不想一步到位：

• 跑向?qū)r可以跳過某些步驟（例如 --skip-channels / --skip-skills）。

4. 配置大模型 Provider（核心能力來源）

OpenClaw 的模型引用格式是 provider/model（例如 anthropic/claude-opus-4-6）。

你可以通過：

• CLI：openclaw models set <provider/model>
• 配置文件：~/.openclaw/openclaw.json（以及 openclaw config set ...）

4.1 常見 Provider：OpenAI / Anthropic

• OpenAI：設(shè)置 OPENAI_API_KEY，選 openai/* 模型
• Anthropic：設(shè)置 ANTHROPIC_API_KEY，選 anthropic/* 模型

實踐建議：用“主模型 + fallback”

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5.1-codex"],
      },
    },
  },
}

4.2 用 LiteLLM 作為統(tǒng)一網(wǎng)關(guān)（多模型路由/成本統(tǒng)計）

OpenClaw 有專門的 LiteLLM 文檔：docs/providers/litellm.md。

核心思路：

• 先啟動 LiteLLM Proxy（例：本機(jī) :4000）
• OpenClaw 配置 models.providers.litellm.baseUrl 指向它
• 在 OpenClaw 里用 litellm/<model> 引用模型

5. 使用本地 Ollama 大語言模型（重點）

OpenClaw 對 Ollama 有官方文檔：docs/providers/ollama.md 與 docs/concepts/model-providers.md。

5.1 快速啟用（隱式發(fā)現(xiàn)：推薦）

特點：不用手寫 models.providers.ollama 的 models 列表；OpenClaw 會去本機(jī) Ollama 發(fā)現(xiàn)“支持 tools 的模型”。

• 安裝并啟動 Ollama
• 拉取一個模型（示例來自官方文檔）：

ollama pull llama3.3
# 或
ollama pull qwen2.5-coder:32b

• 讓 OpenClaw “認(rèn)為 Ollama 可用”（任意值即可）：

export OLLAMA_API_KEY="ollama-local"

• 配置 OpenClaw 默認(rèn)模型：

json5

{
  agents: {
    defaults: {
      model: { primary: "ollama/llama3.3" },
    },
  },
}

驗證：

ollama list
openclaw models list
openclaw agent --message "用 TypeScript 寫一個 debounce" --thinking high

5.2 顯式配置（手寫 provider，適合遠(yuǎn)程 Ollama / 強(qiáng)制參數(shù)）

當(dāng) Ollama 在另一臺機(jī)器、或你要手動指定 contextWindow/model 列表時，用 models.providers.ollama：

json5

{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
        api: "ollama",
        apiKey: "ollama-local",
        models: [
          {
            id: "llama3.3",
            name: "Llama 3.3",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 8192,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

6. 配置 IM 機(jī)器人渠道（Telegram / Discord / Slack / WhatsApp / WebChat…）

OpenClaw 的定位是“你自己的個人助手”，它可以把回復(fù)投遞到你常用的渠道。

建議策略：

• 先用 WebChat / CLI 跑通
• 再接 1 個 IM 渠道（最常見是 Telegram 或 Discord）
• 最后再接 WhatsApp / Signal / iMessage 等更重的渠道

6.1 重要安全設(shè)置：DM pairing / allowlist

官方 README 強(qiáng)調(diào)：外部消息面是 不可信輸入。

默認(rèn)策略通常是“配對”：

• 陌生人 DM 只會收到配對碼，不會觸發(fā)模型處理
• 你用命令批準(zhǔn)：

openclaw pairing approve <channel> <code>

如果你把 dmPolicy 改成 open，一定要配合 allowlist，且不要暴露 Gateway 到公網(wǎng)。

7. Skills：安裝、啟用、覆蓋與最佳實踐

7.1 Skills 的來源與優(yōu)先級

OpenClaw 會從三個位置加載 skills（同名時前者覆蓋后者）：

• <workspace>/skills（工作區(qū)私有技能）
• ~/.openclaw/skills（managed skills，共享）
• bundled（隨安裝自帶）

（對應(yīng)概念文檔：docs/concepts/agent.md）

7.2 常用命令

openclaw skills list
openclaw skills list --eligible
openclaw skills info <name>
openclaw skills check

7.3 ClawHub：最受歡迎 Skills 的安裝來源

官方提供技能倉庫/市場：ClawHub。

• 網(wǎng)站：https://clawhub.com
• 文檔：docs/tools/clawhub.md

常見工作流：

• 搜索技能
• 安裝到當(dāng)前目錄的 ./skills（或指定 workspace）
• 重新開啟會話讓技能列表刷新

8. Plugins（插件/擴(kuò)展）：渠道、工具與 OAuth 登錄流

OpenClaw plugins 是 in-process 擴(kuò)展，可能新增：

• 新的渠道（例如 Matrix / Zalo / Teams 等）
• 新的工具（tool）
• 某些 provider 的 OAuth 登錄（例如 qwen-portal-auth、google-gemini-cli-auth）

常用命令（來自 CLI docs）：

openclaw plugins list
openclaw plugins info <id>
openclaw plugins install <path|.tgz|npm-spec>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor

注意：多數(shù)插件變更需要重啟 gateway。

9. 瀏覽器控制（Browser tool）：自動化/登錄/抓取 JS 站點

OpenClaw 有一套“openclaw-managed”瀏覽器控制能力（文檔：docs/tools/browser.md）。

9.1 兩種模式

• openclaw profile：隔離的、OpenClaw 管理的瀏覽器配置文件（推薦）
• chrome profile：通過 Chrome 擴(kuò)展 relay 控制你現(xiàn)有瀏覽器標(biāo)簽頁

9.2 快速開始

openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

9.3 常見配置項（示例）

json5

{
  browser: {
    enabled: true,
    defaultProfile: "openclaw",
    headless: false,
    executablePath: "/usr/bin/google-chrome",
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: { cdpPort: 18801, color: "#0066CC" }
    }
  }
}

9.4 遠(yuǎn)程 Gateway 時怎么做瀏覽器控制

如果 Gateway 跑在服務(wù)器，而瀏覽器在你的桌面機(jī)：

• 在桌面機(jī)運(yùn)行 node host
• Gateway 會把瀏覽器動作代理過去（文檔里稱 node browser proxy）

10. 搜索引擎與網(wǎng)頁抓?。築rave / Perplexity / Firecrawl

OpenClaw 內(nèi)置兩個輕量工具（文檔：docs/tools/web.md）：

• web_search：Brave Search API（默認(rèn)）或 Perplexity
• web_fetch：HTTP 抓取 + Readability 抽取（可選 Firecrawl 兜底）

10.1 Brave Search API（推薦免費 tier）

配置方式 1：運(yùn)行交互式配置向?qū)Вㄍ扑]）

openclaw configure --section web

配置方式 2：環(huán)境變量（daemon 運(yùn)行時也要能讀到）

export BRAVE_API_KEY="..."

10.2 Firecrawl（可選）

如果你經(jīng)常遇到反爬/動態(tài)站點、想提升 web_fetch 成功率，可配置：

• FIRECRAWL_API_KEY 或 tools.web.fetch.firecrawl.apiKey

11. Obsidian Skills：讓 OpenClaw 操作你的知識庫

OpenClaw 倉庫內(nèi)置了 obsidian skill：skills/obsidian/SKILL.md。

它的核心依賴是 obsidian-cli。

11.1 安裝 obsidian-cli（macOS brew 示例）

根據(jù)該技能的 metadata：

brew install yakitrak/yakitrak/obsidian-cli

11.2 基本用法（vault = 一個文件夾）

設(shè)置默認(rèn) vault：

obsidian-cli set-default "<vault-folder-name>"

查看默認(rèn) vault 路徑：

obsidian-cli print-default --path-only

搜索筆記：

obsidian-cli search "LLM"
obsidian-cli search-content "prompt injection"

創(chuàng)建筆記：

obsidian-cli create "Inbox/OpenClaw 使用記錄" --content "..." --open

移動/重命名（會更新 wikilinks，這是亮點）：

obsidian-cli move "old/path/note" "new/path/note"

11.3 適合的自動化場景

• 把 IM 對話中的“待辦/靈感”沉淀進(jìn) vault
• 每日總結(jié)：把當(dāng)天多渠道消息總結(jié)到 Daily Note
• 項目日志：把 OpenClaw 的執(zhí)行記錄歸檔到固定目錄

12. 推薦的一套“從零到穩(wěn)定”的落地路徑

• npm install -g openclaw + openclaw onboard --install-daemon
• 先用 WebChat/CLI 跑通（不開 IM 渠道）
• 配好模型：先云端主力 + fallback
• 再啟用本地 Ollama（用于便宜/隱私任務(wù)）
• 接一個 IM 渠道（Telegram 或 Discord）并保持默認(rèn) pairing
• 啟用 web_search/web_fetch（Brave key）
• 開啟 Browser tool（需要時才用；注意安全）
• 用 ClawHub 裝你需要的 skills；Obsidian skill 用于沉淀知識庫

13. 參考鏈接

• OpenClaw Repo：https://github.com/openclaw/openclaw
• Docs 首頁：https://docs.openclaw.ai
• Providers 概覽：https://docs.openclaw.ai/concepts/model-providers
• Ollama provider：https://docs.openclaw.ai/providers/ollama
• Web tools：https://docs.openclaw.ai/tools/web
• Browser tool：https://docs.openclaw.ai/tools/browser
• Skills：https://docs.openclaw.ai/tools/skills
• Plugins：https://docs.openclaw.ai/cli/plugins
• ClawHub：https://clawhub.com

到此這篇關(guān)于OpenClaw 是什么 OpenClaw 使用教程的文章就介紹到這了,更多相關(guān)OpenClaw 使用教程內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論