openclaw

关注公众号 jb51net

关闭
AI > openclaw >

OpenClaw 是什么 OpenClaw 使用教程

脚本之家

0. 本文目标与读者

本文面向“想把 OpenClaw 当作个人 AI 助手 + 多渠道 IM 机器人”的用户，覆盖：

说明：本文内容基于 OpenClaw 官方仓库与文档。

1. OpenClaw 是什么？核心组成

OpenClaw 是一个运行在你自己设备上的个人 AI 助手。

它的关键点：

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

OpenClaw 推荐用 CLI 向导完成初始化：openclaw onboard（安装 daemon、配置 workspace、channels、skills、models）。

2.1 前置要求

检查：

node -v

2.2 方式 A：官方推荐（npm 全局安装）

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

--install-daemon 会把 Gateway 安装成后台服务（macOS 上是 launchd；Linux 上通常是 systemd user service；Windows 推荐 WSL2 跑 Linux 流程）。

2.3 Windows：强烈推荐 WSL2

根据官方 README：Windows 通过 WSL2 使用（strongly recommended）。

基本思路：

提示：如果你要跑浏览器控制或某些依赖系统 GUI 的能力，建议把 Gateway 放在真正有桌面环境的机器上（例如本机 macOS / Linux 桌面）。

2.4 方式 B：从源码（适合开发/深度定制）

（来自官方 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
# 开发热更新
pnpm gateway:watch

3. 初次上手：onboard 向导会做什么

openclaw onboard 会引导你完成：

如果你不想一步到位：

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

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

你可以通过：

4.1 常见 Provider：OpenAI / Anthropic

实践建议：用“主模型 + fallback”

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

4.2 用 LiteLLM 作为统一网关（多模型路由/成本统计）

OpenClaw 有专门的 LiteLLM 文档：docs/providers/litellm.md。

核心思路：

5. 使用本地 Ollama 大语言模型（重点）

OpenClaw 对 Ollama 有官方文档：docs/providers/ollama.md 与 docs/concepts/model-providers.md。

5.1 快速启用（隐式发现：推荐）

特点：不用手写 models.providers.ollama 的 models 列表；OpenClaw 会去本机 Ollama 发现“支持 tools 的模型”。

ollama pull llama3.3
# 或
ollama pull qwen2.5-coder:32b
export OLLAMA_API_KEY="ollama-local"

json5

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

验证：

ollama list
openclaw models list
openclaw agent --message "用 TypeScript 写一个 debounce" --thinking high

5.2 显式配置（手写 provider，适合远程 Ollama / 强制参数）

当 Ollama 在另一台机器、或你要手动指定 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 机器人渠道（Telegram / Discord / Slack / WhatsApp / WebChat…）

OpenClaw 的定位是“你自己的个人助手”，它可以把回复投递到你常用的渠道。

建议策略：

6.1 重要安全设置：DM pairing / allowlist

官方 README 强调：外部消息面是 不可信输入。

默认策略通常是“配对”：

openclaw pairing approve <channel> <code>

如果你把 dmPolicy 改成 open，一定要配合 allowlist，且不要暴露 Gateway 到公网。

7. Skills：安装、启用、覆盖与最佳实践

7.1 Skills 的来源与优先级

OpenClaw 会从三个位置加载 skills（同名时前者覆盖后者）：

（对应概念文档：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。

常见工作流：

8. Plugins（插件/扩展）：渠道、工具与 OAuth 登录流

OpenClaw plugins 是 in-process 扩展，可能新增：

常用命令（来自 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

注意：多数插件变更需要重启 gateway。

9. 浏览器控制（Browser tool）：自动化/登录/抓取 JS 站点

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

9.1 两种模式

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 远程 Gateway 时怎么做浏览器控制

如果 Gateway 跑在服务器，而浏览器在你的桌面机：

10. 搜索引擎与网页抓取：Brave / Perplexity / Firecrawl

OpenClaw 内置两个轻量工具（文档：docs/tools/web.md）：

10.1 Brave Search API（推荐免费 tier）

配置方式 1：运行交互式配置向导（推荐）

openclaw configure --section web

配置方式 2：环境变量（daemon 运行时也要能读到）

export BRAVE_API_KEY="..."

10.2 Firecrawl（可选）

如果你经常遇到反爬/动态站点、想提升 web_fetch 成功率，可配置：

11. Obsidian Skills：让 OpenClaw 操作你的知识库

OpenClaw 仓库内置了 obsidian skill：skills/obsidian/SKILL.md。

它的核心依赖是 obsidian-cli。

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

根据该技能的 metadata：

brew install yakitrak/yakitrak/obsidian-cli

11.2 基本用法（vault = 一个文件夹）

设置默认 vault：

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

查看默认 vault 路径：

obsidian-cli print-default --path-only

搜索笔记：

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

创建笔记：

obsidian-cli create "Inbox/OpenClaw 使用记录" --content "..." --open

移动/重命名（会更新 wikilinks，这是亮点）：

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

11.3 适合的自动化场景

12. 推荐的一套“从零到稳定”的落地路径

13. 参考链接

到此这篇关于OpenClaw 是什么 OpenClaw 使用教程的文章就介绍到这了,更多相关OpenClaw 使用教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！