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

---

一、OpenClaw 是什么（先理解）

OpenClaw = 本地运行的 AI Agent 框架

它可以：

• 控制浏览器

• 执行 shell 命令

• 自动完成任务

• 调用插件（Skills）

• 多 Agent 协作

支持模型：

• OpenAI GPT

• Claude

• 本地模型（Ollama / LM Studio）

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

---

二、环境准备（最重要）

1 必备环境

软件	作用
Node.js 22+	运行 OpenClaw
Git	下载 skills
浏览器	Web UI
OpenAI / Claude API	AI模型

下载 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)

 修改安全策略允许脚本安装

1. 以管理员身份打开 PowerShell：

   • 点击电脑左下角的“开始”菜单，搜索 PowerShell。

   • 在搜索结果中，右键点击 Windows PowerShell，选择 “以管理员身份运行”。

2. 执行修改命令:

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 执行一键安装脚本(升级也可以使用此脚本):

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

这个脚本会：

• 自动安装 Node (如果使用NVM安装,请先卸载)

• 安装 OpenClaw

• 初始化环境 (OpenClaw Guide)

---

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

# 使用 npm

npm install -g openclaw@latest

# 或使用 pnpm

pnpm add -g openclaw@latest

运行引导向导：

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

openclaw onboard --install-daemon

Windows 11 完整推荐选择流程（对应交互提示, 紫色为二次安装重置）

Step	Prompt / Interaction	Explanation (中文解释)	Recommended Choice
1	Security confirmation	默认是 个人模式（personal-by-default），如果多人使用需要额外安全配置	Yes
2	Onboarding mode	选择安装引导模式	QuickStart（推荐，自动配置）
3	Existing config detected	检测到已有配置文件	继续并 Reset
4	Config handling	是否重置旧配置	Reset
5	Reset scope	重置范围	Full reset (config + creds + sessions + workspace)
6	Gateway port	OpenClaw Gateway 服务端口	18789 (默认即可)
7	Gateway bind	服务监听地址	Loopback (127.0.0.1)
8	Gateway auth	Gateway 认证方式	Token (default)
9	Tailscale exposure	是否通过 Tailscale 暴露服务	Off
10	Model/auth provider	选择模型提供商	Custom Provider
11	API Base URL	API 地址	http://127.0.0.1:11434/v1
12	How do you want to provide this API key?	选项提供API秘钥的方式	Paste API key now
12	API Key (leave blank if not required)	是否输入 API Key	ollama（或留空也可以）
13	Endpoint compatibility	API兼容类型	OpenAI-compatible
14	Model ID	模型名称	glm-4.7-flash:latest
14	Endpoint ID	路径编号	custom-127-0-0-1-11434
15	Model alias	模型别名	ollama
16	Channel setup	是否配置聊天渠道（Telegram/Discord等）	Skip for now
17	Search provider	是否配置联网搜索	Skip for now
18	Configure skills now? (recommended)	是否配置技能（插件能力）	Skip for now
19	Install skill dependencies	是否安装技能依赖	No
20	Google Places API	是否配置 Google Places	No
21	Gemini API	是否配置 Gemini	No
22	Notion API	是否配置 Notion	No
23	OpenAI image API	是否配置 OpenAI 图像	No
24	Whisper API	是否配置语音识别	No
25	ElevenLabs API	是否配置语音合成	No
26	Hooks setup	是否启用自动化 hooks	Skip for now
27	Gateway service install	安装 Gateway 后台服务	自动安装 Scheduled Task
28	Control UI	控制面板地址	http://127.0.0.1:18789
29	Hatch your bot	启动 Agent	Hatch in TUI (recommended)
30	Start command	启动命令	openclaw tui -ws://127.0.0.1:18789 -agent main -session main

如下:

# 仅运行配置向导

openclaw onboard

检查安装：

# 查看 Gateway 状态

openclaw gateway status

# 打开控制面板

openclaw dashboard

---

四、启动 OpenClaw

使用Token启动:

openclaw dashboard --no-open

显示如下:

Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxxxxxxxxx
Copied to clipboard.
Browser launch disabled (--no-open). Use the URL above.

粘贴到浏览器打开

或使用如下命令启动：

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/

核心概念：

目录	作用
agents	Agent配置
skills	插件
memory	长期记忆
logs	Agent日志

---

七、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小时能入门。