OpenClaw真正“保姆级”的环境配置 + 使用教程

真正“保姆级”的环境配置 + 使用教程,从 0 → 安装 → Skills → 多 Agent的完整流程。
（你照着做基本30–60 分钟就能跑起来）

一、OpenClaw 是什么（先理解）

OpenClaw = 本地运行的 AI Agent 框架

它可以：

• 控制浏览器

• 执行 shell 命令

• 自动完成任务

• 调用插件（Skills）

• 多 Agent 协作

支持模型：

• OpenAI GPT

• Claude

• 本地模型（Ollama / LM Studio）

而且本地运行，数据在自己机器。 (OpenClaw Guide)

二、环境准备（最重要）

1 必备环境

下载 Node：

👉 https://nodejs.org

验证：

node -v npm -v

如果成功：

v22.x.x

三、安装 OpenClaw（最简单）

方法1：一键安装

macOS / Linux

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

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

这个脚本会：

• 自动安装 Node

• 安装 OpenClaw

• 初始化环境 (OpenClaw Guide)

方法2：npm安装,平台支持（推荐）

# 使用 npm

npm install -g openclaw@latest

# 或使用 pnpm

pnpm add -g openclaw@latest

运行引导向导：

# 完整安装向导 + 安装系统服务 (推荐)

openclaw onboard --install-daemon

# 仅运行配置向导

openclaw onboard

检查安装：

# 查看 Gateway 状态

openclaw gateway status

# 打开控制面板

openclaw dashboard

四、启动 OpenClaw

启动：

openclaw start

浏览器打开：

http://localhost:3000

进入后台界面。

五、配置 AI 模型

打开

Settings → Models

添加模型：

OpenAI

provider: openai model: gpt-4o apiKey: sk-xxxxx

Claude

provider: anthropic model: claude-3-sonnet apiKey: sk-xxxxx

本地模型（Ollama）

provider: ollama model: llama3 endpoint: http://localhost:11434

六、项目结构（理解很重要）

OpenClaw 项目目录：

openclaw/ │ ├── agents/ │ └── main.agent │ ├── skills/ │ └── browser │ ├── memory/ │ ├── config/ │ └── logs/

核心概念：

七、Skills 插件系统

OpenClaw 的核心是Skills（技能）

类似：

ChatGPT Plugin LangChain Tools

官方市场：

• ClawHub

• GitHub Skills库 (小林的博客-AI学长)

安装 Skill 示例

例如：

browser automation

安装：

openclaw skill install browser

安装后：

skills/ browser/ SKILL.md tool.js

Skill 工作机制

Skill包含：

SKILL.md

定义：

• 能做什么

• 调用方法

• 输入输出

Agent 自动调用。

八、Skills 实战案例

自动浏览网页

Prompt：

Search latest AI news summarize

Agent执行：

1 搜索网页
2 抓取内容
3 总结

自动写日报

Prompt：

read my git commits generate daily report

Agent：

1 读取 repo
2 生成报告
3 保存文件

九、多 Agent 协作（最强功能）

OpenClaw支持：

Manager Agent Worker Agent

例如：

Research Agent Writing Agent Review Agent

流程：

任务 ↓ Manager ↓ Research ↓ Writer ↓ Reviewer

示例配置

agent.yml

agents: manager: role: manager researcher: role: research writer: role: writing

十、SubAgent（子代理）

子代理 = 专门干一件事

例子：

MainAgent ├ ResearchAgent ├ CodeAgent └ BrowserAgent

好处：

• 分工明确

• 更稳定

• 更强推理

十一、实战场景

OpenClaw可以做：

1 自动写内容

Research Write article Publish blog

2 自动运营

monitor twitter generate reply auto post

3 自动编程

read repo fix bug submit PR

4 自动化工作流

结合：

OpenClaw + n8n + Notion + Slack

十二、常见问题

1 Agent像聊天机器人

原因：

tool权限没开

解决：

enable tools

2 Skills 不生效

检查：

SKILL.md tool.js

3 Token消耗高

原因：

Agent循环调用工具

十三、生产部署建议

如果要长期运行：

推荐：

Docker + VPS + Ollama

架构：

Server ├ OpenClaw ├ Ollama └ Redis

十四、注意安全

OpenClaw 可以：

执行 shell 读写文件 控制浏览器

所以：

• 不要随便装 skills

• 不要开放 root

• 最好 sandbox

一些研究指出Agent可能被 prompt 攻击利用执行恶意命令。 (arXiv)

十五、学习路线（我推荐）

顺序：

1 安装OpenClaw 2 跑一个Agent 3 安装Skills 4 写自己的Skill 5 多Agent协作 6 接入自动化

基本1小时能入门。