OpenClaw使用常见问题（一）

admin
admin
admin
0
文章
0
评论
2026-03-03 09:32:25 网络安全文章 来源：ZONE.CI 全球网 0 阅读模式

文章总结： 本文是一篇关于OpenClaw个人AI助手安装配置的实用指南，面向希望将其作为多渠道IM机器人的用户。核心内容包括：在macOS/Linux/Windows(WSL2)上的部署方法、配置OpenAI/Anthropic/Ollama等模型提供商、设置Telegram/Discord等IM渠道机器人、安装使用Skills技能包、管理插件、以及浏览器控制、搜索引擎API和Obsidian技能等高级功能。文章基于官方文档，提供了从零到稳定落地的清晰路径和具体操作建议。 综合评分： 78 文章分类： AI安全,安全工具,产品介绍,安全运营,其他

cover_image

OpenClaw使用常见问题（一）

原创

糖果LUA 糖果LUA

AI安全运营

2026年2月15日 17:21 北京

0. 本文目标与读者

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

  • macOS / Linux / Windows(WSL2) 安装部署与常见运行方式
  • 配置 模型 Provider（OpenAI / Anthropic / LiteLLM / 本地 Ollama 等）
  • 配置 IM 渠道机器人（Telegram/Discord/Slack/WhatsApp/WebChat…）的基本思路
  • 最常用的 Skills 安装与使用、插件/扩展（OpenClaw plugins）管理
  • 浏览器控制（OpenClaw-managed Chromium + Chrome 扩展 relay）
  • 搜索引擎 API（Brave / Perplexity / Firecrawl）
  • Obsidian skills（基于 obsidian-cli 操作 vault）

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

  • 仓库：https://github.com/openclaw/openclaw
  • 文档导航（建议收藏）：https://docs.openclaw.ai

1. OpenClaw 是什么？核心组成

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

它的关键点：

  • Gateway（网关/控制平面）：常驻进程，连接消息渠道、管理会话、工具、事件与 Web UI。
  • Agent（智能体）：在 Gateway 的调度下运行，调用模型、调用工具、读写 workspace。
  • Tools（内置工具）：浏览器控制、web_fetch/web_search、exec、消息发送等。
  • Skills（技能包）：更像“可复用的操作手册 + 可选的外部二进制依赖”，在系统提示词里以“可用技能清单”形式出现，模型需要时会去读取对应 SKILL.md。
  • Plugins（插件/扩展）：以 in-process 的方式扩展 Gateway：新增渠道、工具、OAuth 登录流、技能包等。

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

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

2.1 前置要求

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

检查：

node-v

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

npminstall-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）。

基本思路：

  1. 安装 WSL2 + Ubuntu
  2. 在 WSL2 里安装 Node ≥ 22
  3. 按 Linux 流程安装 openclaw 并 openclaw onboard --install-daemon

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

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

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpminstall
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon

# 开发热更新
pnpm gateway:watch

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

openclaw onboard 会引导你完成：

  • Gateway 基本配置（端口、绑定方式、鉴权、daemon）
  • Workspace 初始化（默认在 ~/.openclaw/workspace，可改）
  • Model/Auth（API Key / OAuth / setup-token）
  • Channels（Telegram/Discord/WhatsApp/Google Chat/Signal/iMessage/…）
  • Skills（挑选/安装）

如果你不想一步到位：

  • 跑向导时可以跳过某些步骤（例如 --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：设置 OPENAI_API_KEY，选 openai/* 模型
  • Anthropic：设置 ANTHROPIC_API_KEY，选 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。

核心思路：

  1. 先启动 LiteLLM Proxy（例：本机 :4000）
  2. OpenClaw 配置 models.providers.litellm.baseUrl 指向它
  3. 在 OpenClaw 里用 litellm/<model> 引用模型

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

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

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

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

  1. 安装并启动 Ollama
  2. 拉取一个模型（示例来自官方文档）：
ollama pull llama3.3
# 或
ollama pull qwen2.5-coder:32b
  1. 让 OpenClaw “认为 Ollama 可用”（任意值即可）：
exportOLLAMA_API_KEY="ollama-local"
  1. 配置 OpenClaw 默认模型：
{
agents:{
defaults:{
model:{primary:"ollama/llama3.3"},
},
},
}

验证：

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

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

当 Ollama 在另一台机器、或你要手动指定 contextWindow/model 列表时，用 models.providers.ollama：

{
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 的定位是“你自己的个人助手”，它可以把回复投递到你常用的渠道。

建议策略：

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

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

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

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

  • 陌生人 DM 只会收到配对码，不会触发模型处理
  • 你用命令批准：
openclaw pairing approve&nbsp;<channel><code>

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

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

7.1 Skills 的来源与优先级

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

  1. <workspace>/skills（工作区私有技能）
  2. ~/.openclaw/skills（managed skills，共享）
  3. bundled（随安装自带）

（对应概念文档：docs/concepts/agent.md）

7.2 常用命令

openclaw skills list
openclaw skills list&nbsp;--eligible
openclaw skills info&nbsp;<name>
openclaw skills check

7.3 ClawHub：最受欢迎 Skills 的安装来源

官方提供技能仓库/市场：ClawHub。

  • 网站：https://clawhub.com
  • 文档：docs/tools/clawhub.md

常见工作流：

  • 搜索技能
  • 安装到当前目录的 ./skills（或指定 workspace）
  • 重新开启会话让技能列表刷新

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

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

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

常用命令（来自 CLI docs）：

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

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

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

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

9.1 两种模式

  • openclaw profile：隔离的、OpenClaw 管理的浏览器配置文件（推荐）
  • chrome profile：通过 Chrome 扩展 relay 控制你现有浏览器标签页

9.2 快速开始

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

9.3 常见配置项（示例）

{
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 跑在服务器，而浏览器在你的桌面机：

  • 在桌面机运行 node host
  • Gateway 会把浏览器动作代理过去（文档里称 node browser proxy）

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

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

  • web_search：Brave Search API（默认）或 Perplexity
  • web_fetch：HTTP 抓取 + Readability 抽取（可选 Firecrawl 兜底）

10.1 Brave Search API（推荐免费 tier）

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

openclaw configure&nbsp;--section&nbsp;web

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

exportBRAVE_API_KEY="..."

10.2 Firecrawl（可选）

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

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

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

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

它的核心依赖是 obsidian-cli。

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

根据该技能的 metadata：

brew&nbsp;install&nbsp;yakitrak/yakitrak/obsidian-cli

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

设置默认 vault：

obsidian-cli set-default&nbsp;"<vault-folder-name>"

查看默认 vault 路径：

obsidian-cli print-default --path-only

搜索笔记：

obsidian-cli search&nbsp;"LLM"
obsidian-cli search-content&nbsp;"prompt injection"

创建笔记：

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

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

obsidian-cli move&nbsp;"old/path/note""new/path/note"

11.3 适合的自动化场景

  • 把 IM 对话中的“待办/灵感”沉淀进 vault
  • 每日总结：把当天多渠道消息总结到 Daily Note
  • 项目日志：把 OpenClaw 的执行记录归档到固定目录

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

  1. npm install -g openclaw + openclaw onboard --install-daemon
  2. 先用 WebChat/CLI 跑通（不开 IM 渠道）
  3. 配好模型：先云端主力 + fallback
  4. 再启用本地 Ollama（用于便宜/隐私任务）
  5. 接一个 IM 渠道（Telegram 或 Discord）并保持默认 pairing
  6. 启用 web_search/web_fetch（Brave key）
  7. 开启 Browser tool（需要时才用；注意安全）
  8. 用 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

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：AI安全运营 糖果LUA 糖果LUA《OpenClaw使用常见问题（一）》

版权声明

本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。

ZONE.CI 全球网 | 安全领域涉猎者-乌云独行地带
ZONE.CI 全球网
安全领域涉猎者-乌云独行地带
7-Zip钓鱼网站 网络安全文章

7-Zip钓鱼网站

文章总结： 文档揭露了一个伪造的7-Zip官网长期传播木马安装程序的事件。攻击者利用吊销证书签名恶意软件，在用户安装正常软件的同时部署恶意组件。该木马将受害者机
03-030 评论
ZONE.CI 全球网 | 安全领域涉猎者-乌云独行地带
安全领域涉猎者-乌云独行地带
ZONE.CI 全球网
评论：0   参与：  0