Openclaw安装完整指南

Openclaw安装完整指南
OpenClaw满血版安装全流程
基于 Claude Code 架构重构

OpenClaw满血版安装全流程

不用输入一行代码,复制粘贴就能打造多Agent军团

📅 更新:2026-04-08 🖥️ Windows 11 / Mac / Linux npm 最新版
第一章
🚀 起步与核心安装
此阶段包含大模型挑选、主程序一键装配、安全加固及底层记忆架构的全面初始化。

1.1 核心模型推荐

智谱AI

GLM-5

深度集成原生智能体(Agent)模式,国产化适配与政企安全首选底座
获取 API →
月之暗面

Kimi K2.5

智能体集群(Swarm)协作与长文本深度解析,擅长科研与代码逆向
获取 API →
MiniMax

MiniMax M2.7

混合注意力实现超长文本极低延迟与极致性价比的逻辑推理
获取 API →
OpenAI

GPT-5.4 系列

系统级动态推理路由与持久化记忆,深度思考全能数字大脑
Anthropic

Claude Opus 4.6

成熟 Computer Use 与自适应思考深度,任务执行最高可靠性
Google

Gemini 3.1 系列

2M+ 超大上下文,多模态数据无缝融合与全自动化协作
🖥️ 本地模型(Ollama)
Ollama

qwen3.5:9b

~16.5GB 显存占用 · 128K上下文 · MoE模型,激活3B参数,速度快,支持多Agent并行
Ollama

qwen3.5:27b(平替推荐)

~28GB · 32-64K上下文 · 稠密模型,代码/指令能力强,工程实用度高
Ollama

qwen-coder:30B(平替推荐)

~31GB · 128K上下文 · MoE模型,激活3B参数,速度快,代码编辑能力强
Ollama

gemma4:31b

~31GB · 32K上下文 · Dense模型,310亿全参数激活,支持文本与图像
Ollama

gemma4:26b

~28GB · 128K上下文 · MoE模型,激活3B参数,速度快,多模态能力优秀

下载 Ollama →

💡 Dense vs MoE:Dense 模型(如 gemma4:31b)所有参数全量激活,精度高但显存需求大;MoE 模型(如 qwen3.5 系列)每次只激活部分专家参数,在相近效果下显著降低显存占用。

1.1.1 Harness Engineering 工程

🐴 一句话理解

给 AI 野马套上”缰绳、马鞍和护栏”,让它想犯错都没机会。核心原则:别指望野马自己变乖,用工程系统让它想犯错都没机会。

Tool Runtime Pipeline
看门狗(watchdog)- 工具调用管道、熔断机制
Permission System
隐私脱敏规则、blast-radius-permission – 权限分级
Context Hygiene
Context Compact – 上下文压缩与生命周期管理
Agent Lifecycle
Agent 创建/交接/离职机制
Multi-Agent Orchestration
sessions_spawn/send、Full Mesh 全网状互联
Verification Agent
质检员 Agent – 对抗性测试与 VERDICT 输出

1.2 基础安装流程

1

检测环境

检查操作系统、Node.js 22+、npm 是否就绪

2

安装 OpenClaw

从国内镜像源安装最新版 CLI

3

配置 + 启动 Gateway + 修复 device token

非交互式 onboard → 后台启动 Gateway → Token 轮换,一步到位

4

验证 + 打开 Dashboard + 开机自启

健康检查 → 打开控制面板 → VBS 开机自启(无需管理员权限)

Markdown Prompt — 一键安装
请帮我安装并配置 OpenClaw,每步完成后告诉我结果,报错就停。 【第一步】检测环境 node -v; npm -v 【第二步】安装 npm config set registry https://registry.npmmirror.com npm i -g openclaw@latest openclaw –version 【第三步】配置 + 启动 Gateway + 修复 device token openclaw onboard –non-interactive –mode local –auth-choice minimax-cn-api –minimax-api-key “你的API Key” –gateway-auth token –gateway-bind loopback –accept-risk –skip-channels –skip-search –skip-skills –skip-health openclaw config set agents.defaults.workspace “$PWD\workspace” New-Item -ItemType Directory -Force -Path “$PWD\workspace” | Out-Null Start-Process -FilePath “powershell” -ArgumentList “-WindowStyle”,”Hidden”,”-Command”,”openclaw gateway run” -WindowStyle Minimized Start-Sleep -Seconds 15 $DEVICE_ID = (openclaw devices list –json | ConvertFrom-Json).paired[0].deviceId openclaw devices rotate –device $DEVICE_ID –role operator –json 【第四步】验证 + 打开 Dashboard + 设置开机自启 openclaw health $configDir = if (Test-Path “.openclaw\openclaw.json”) { “$PWD\.openclaw” } elseif (Test-Path “$HOME\.openclaw\openclaw.json”) { “$HOME\.openclaw” } else { “$PWD\.openclaw” } $config = Get-Content “$configDir\openclaw.json” -Raw | ConvertFrom-Json Start-Process “http://127.0.0.1:$($config.gateway.port)/#token=$($config.gateway.auth.token)” $vbsContent = ‘Set WshShell = CreateObject(“WScript.Shell”)’ + “`r`n” + ‘WshShell.Run “powershell -WindowStyle Hidden -Command openclaw gateway run”, 0, False’ Set-Content -Path “$PWD\openclaw-gateway.vbs” -Value $vbsContent -Force Start-Process powershell -ArgumentList “-NoProfile”,”-Command”,”Copy-Item ‘$PWD\openclaw-gateway.vbs’ ‘$([Environment]::GetFolderPath(”Startup”))’ -Force” -Wait

1.3 安全加固

🔒 为什么要做安全加固?

防止 API Key 泄露 · 隔离外网攻击(网关只监听本地)· 防止群聊滥用 · 防止提示注入

1.3.1 一键安全加固
Markdown Prompt
请为我的 OpenClaw 执行安全加固,工作目录: {填写你的目录} 【步骤1】网关安全配置 openclaw config set gateway.bind loopback openclaw config set gateway.auth.mode token openclaw config get gateway.auth.token # 确认 token 已生成 【步骤2】群聊安全(如已安装渠道) openclaw config set channels.feishu.groupPolicy allowlist 【步骤3】安全审计 openclaw security audit # 确认:0 个严重问题、gateway.bind=loopback、auth.mode=token 【步骤4】验证 openclaw health openclaw config get gateway.auth.mode # 应为 token openclaw config get gateway.bind # 应为 loopback
⚠️ 1.3.2 防回滚验证

doctor / onboard / wizard 等命令会自动重写 openclaw.json,以下值最容易被改回默认值:

配置项正确值被改回的错误值触发场景
gateway.auth.modetokennone执行 doctor / onboard / wizard 后
agents.defaults.workspace$PWD\workspace%USERPROFILE%\.openclaw\workspace未执行迁移步骤
Bash — 一键修复+验证
# 1. 修复 auth.mode(如被改回 none) openclaw config set gateway.auth.mode token # 2. 修复 workspace(如被改回默认路径) openclaw config set agents.defaults.workspace “$PWD\workspace” # 3. 验证关键配置 openclaw config get gateway.auth.mode # → 期望输出: token openclaw config get agents.defaults.workspace # → 期望输出: 当前目录\workspace openclaw health

何时执行:安装完任何插件后 · 运行完 doctor --fix 后 · 重启网关后发现 Dashboard 连不上时

1.4 进阶性能与质量加固

OpenClaw 从”好玩”变到”好用”的关键步。通过质检监控和成本管控,让 AI 从”随缘完成”变为”严谨交付”。

D级指令:渠道接入(飞书/微信)

飞书渠道

1. 访问链接自动创建专用机器人:创建飞书机器人 →

Markdown Prompt — 飞书安装
请帮我安装并配置 OpenClaw 渠道接入,按以下步骤执行: 安装飞书插件并配置 执行命令:openclaw plugins install @openclaw/feishu 写入配置 读取 ~/.openclaw/openclaw.json,在 channels 下新增 feishu 配置(不要覆盖其他已有配置): { “enabled”: true, “domain”: “feishu”, “connectionMode”: “websocket”, “appId”: “你的appId”, “appSecret”: “你的appSecret”, “dmPolicy”: “pairing”, “groupPolicy”: “allowlist” } 重启网关使配置生效 openclaw gateway restart

配对测试:从飞书向机器人发消息 → 查看网关日志中的 pairing code → openclaw pairing approve feishu <配对码>

微信渠道

确保微信已升级到最新版本,进入:我 → 设置 → 插件 → 微信ClawBot → 详情

Markdown Prompt — 微信安装
请帮我并执行安装命令配置微信插件(请到外部终端执行,不要在沙箱执行): npx -y @tencent-weixin/openclaw-weixin-cli@latest install 重启网关 openclaw gateway restart

配置完成后,使用微信「扫一扫」识别二维码绑定机器人

E级指令:安装”全能质检员”(子Agent)
⚠️ 重要区别

此指令创建的是子Agent,不是替换主Agent。子Agent独立运行在指定工作目录,通过 sessions_spawn 由主Agent调用。Agent间通信配置(Full Mesh)将在后续 J级指令中统一设置。

Markdown Prompt — 质检员安装
请帮我安装并配置”Verification Agent”(质检员)作为子Agent。 在 {安装磁盘}:\OpenClaw\workspace\agent\质检员\ 路径下创建子Agent 【第一步:创建子Agent目录与核心文件】 1. 创建目录:{安装磁盘}:\OpenClaw\workspace\agent\质检员\ 和 memory\ 子目录 (注意:这是子Agent独立工作区,与主Agent的 workspace 分开) 2. 写入 IDENTITY.md: — Name: 🛡️质检员 Role: Verification Specialist Mission: 寻找系统中隐藏的问题,证明实现是错误的。 — 3. 写入 SOUL.md: — ### 🎯 角色定义 你是一个质检专家。你的工作不是确认实现能跑,而是通过”对抗性测试”试着搞坏它。 ### 🚫 CRITICAL – 严禁修改任何项目源代码或配置文件 – 只有在控制台看到 Command Output 证据后才能给出 PASS ### 🛠️ 质检策略 – **通用检查**: Run Build → Test Suite → Linter/Type-checker – **对抗性探测**(至少一项): – Concurrency(并发)/ Boundary(边界:0,-1,空字符串,MAX_INT) – Idempotency(幂等)/ Orphan(孤儿:删除不存在的ID) ### 📝 汇报格式 每个 Check 包含:Command run / Output observed / Result: PASS或FAIL 结尾唯一一行:VERDICT: PASS 或 VERDICT: FAIL — 4. 写入 AGENTS.md: — # AGENTS.md – 质检员 你是 Verification Agent。不写代码不改配置,使命是通过对抗性测试证明实现错误。 ## 红线:严禁修改源码/配置;无证据不得PASS;不得跳过测试。 — 5. 写入 USER.md: — # USER.md – **Name:** 星爷(按实际情况填写) – **Timezone:** Asia/Shanghai — 6. 写入 TOOLS.md: — # TOOLS.md 记录常用检查命令模板和对抗性测试脚本。 — 【第二步:使用CLI注册子Agent】 使用 openclaw agents add 命令注册子Agent: openclaw agents add verifier –workspace “{安装磁盘}:\OpenClaw\workspace\agent\质检员” –non-interactive > ⚠️ **注意**:OpenClaw 不支持中文作为 Agent ID,需使用英文ID(如 `verifier`),显示名称可在 IDENTITY.md 中设置为中文。 【第三步:验证】 1. 文件验证: – {安装磁盘}:\OpenClaw\workspace\agent\质检员\IDENTITY.md ✓ – {安装磁盘}:\OpenClaw\workspace\agent\质检员\SOUL.md ✓ – {安装磁盘}:\OpenClaw\workspace\agent\质检员\AGENTS.md ✓ – {安装磁盘}:\OpenClaw\workspace\agent\质检员\USER.md ✓ – {安装磁盘}:\OpenClaw\workspace\agent\质检员\TOOLS.md ✓ – {安装磁盘}:\OpenClaw\workspace\agent\质检员\memory\ ✓ – 无 agent/ 子文件夹 ✓ 2. 注册验证: – openclaw agents list 显示”质检员” – openclaw.json 中 agents.list 包含质检员,且 workspace 指向 {安装磁盘}:\OpenClaw\workspace\agent\质检员 3. 主Agent workspace 保护验证(关键!): – 执行 `openclaw config get agents.defaults.workspace` – 确认输出仍为原始值(如 C:\Users\用户名\.openclaw\workspace),未被修改为子Agent路径 – 如被修改,立即执行回滚:openclaw config set agents.defaults.workspace “原始路径”
💡 这是什么?

质检员就像工厂里的”QA检验员”——主Agent写完代码后,质检员专门负责”找茬”。它会用各种刁钻方法测试代码(并发请求、空数据、删不存在的文件),只有经得起考验的代码才能拿到 PASS。

G级指令:结构化”成功经验”提取
Markdown Prompt
请完善我的长效反馈闭环(MEMORY.md),要求按照严格的 JSON-like 格式提取经验: 1. 提取规则:仅当【质检员】判定为 VERDICT: PASS 时,提取本次成功的核心逻辑。 2. 存储模版:将以下条目追加到 ~/.openclaw/workspace/MEMORY.md: — – [Topic]: [任务名称] – [Success Logic]: [核心解决思路,禁止废话] – [Tool Chain]: [成功的工具调用顺序, 如: grep -> sed -> test] – [Evidence]: [关键的一行测试通过日志] – [Timestamp]: [当前日期] — 3. 检索强制:每次新任务 /plan 阶段,必须读取 MEMORY.md 寻找同类模式。
💡 这是什么?

MEMORY.md 是AI的”经验笔记本”。AI每次完成任务后,会把成功的经验记下来。下次遇到类似问题时,AI会先翻笔记本看看以前是怎么解决的。时间越长,AI就越聪明。

H级指令:系统能力解封 (Full Profile)
Markdown Prompt
帮我把 OpenClaw [所有agent] 的工具权限从默认的 coding profile 改为 full profile # 执行命令 openclaw config set tools.profile full openclaw gateway restart # 说明 第一条设置 tools.profile 为 full,第二条重启网关使配置生效。 执行完后,运行 openclaw config get tools.profile 确认输出是 full
💡 这是什么?

Full Profile 是给AI”解锁全部技能”。默认只开放”写代码”相关工具,开启后AI就能使用浏览器、执行命令行、读写任意文件等全部能力。测试方法:在 openclaw 对话框中输入”打开浏览器搜索【xxx内容】”

I级指令:一键安装记忆系统

新安装后记忆系统是”残血版”——配置向量模型后,AI才能把”长期记忆”编入索引,实现按语义检索。

组件路径说明
向量数据库~/.openclaw/memory/<agentId>.sqlite每 Agent 一个,支持语义搜索
核心记忆~/.openclaw/workspace/MEMORY.md用户偏好、团队协作、项目进展
详细记忆~/.openclaw/workspace/memory/按话题分类的记忆文件
Markdown Prompt — 记忆系统安装
请帮我检查并配置 OpenClaw 的记忆系统。 【任务】 1. 检查记忆系统状态和向量模型是否已安装 2. 如未安装或配置不完整,自动完成安装和配置 3. 验证安装结果 【记忆系统架构】 – 工作区:~/.openclaw/workspace/ – 核心记忆:~/.openclaw/workspace/MEMORY.md – 每日记忆:~/.openclaw/workspace/memory/YYYY-MM-DD.md – 向量数据库:~/.openclaw/memory/.sqlite – 向量模型:nomic-embed-text 【检查项】 1. Node 版本 ≥22 2. openclaw 命令可用 3. Gateway 运行中 4. Ollama 已安装 5. nomic-embed-text 模型已拉取 6. openclaw.json 中 memory 相关配置完整 7. 向量搜索参数已配置 【自动配置任务】 如上述检查项有缺失,自动执行: 1. 安装 Ollama(如未安装) 2. 拉取向量模型:ollama pull nomic-embed-text 3. 配置 openclaw.json: – memory.backend = “builtin” – memorySearch.provider = “ollama” – memorySearch.model = “nomic-embed-text” 4. 创建记忆目录结构 5. 重启 Gateway 使配置生效 【验证】 – 运行 openclaw memory status –deep – 确认向量数据库已创建 – 确认记忆系统可正常检索
第二章
🤝 多 Agent 协作网络

2.1.1 四级执行策略

简单 — 主Agent直答

快速问答

⭐⭐

中等 — 单子Agent

专项调研

⭐⭐⭐

复杂 — Explore+Plan+General

项目分析

⭐⭐⭐⭐

超大 — /batch并行30单元

代码迁移

2.1.2 Agent 通信机制

📡 通信原理

用户发消息 → 主Agent接收 → 分析任务类型 → sessions_spawn() 启动子Agent异步执行 / sessions_send() 向指定Agent发送消息

🔄 串联模式 — 像接力赛

A查资料 → B写文章 → C翻译,最后一个Agent汇报总成绩

⚡ 并联模式 — 像各司其职

A写代码、B画图标、C写说明书,同时开工效率翻倍

🔼 自动升级 — 像找领导

Agent1权限不够时自动呼叫高级Agent2来帮忙解决

2.1.3 灵魂注入与全网状通信 (Full Mesh)

J级指令:Full Mesh 自动化同步

每次新建 Agent 后的”一键开光”工具。无论后期新增了多少个 Agent,只需执行这一条 Prompt,AI自动包揽一切。

Markdown Prompt — Full Mesh
请为我的 OpenClaw 执行”灵魂注入与全网状通信 (Full Mesh)”的自动化检查和同步: 【第一步:全量资产扫描与灵魂注入】 1. 自动扫描 ~/.openclaw/agents/ 目录下所有的子文件夹。 2. 提取所有文件夹名称作为【Agent ID 列表】。 3. 遍历列表,检查每个 Agent 目录下的 agent/IDENTITY.md 和 agent/SOUL.md: – 如果文件不存在:请根据该 Agent 的文件夹名称,聪明地推测其岗位角色,参考最严苛的高管标准,自动为它编写一份专业的 IDENTITY.md(必须包含 Name, Role, Avatar, Mission)以及一份极具约束力的 SOUL.md(必须包含 🎯核心愿景、🚫CRITICAL严禁事项、🛠️强制流程)。要求 SOUL.md 结尾必须强制规范 Agent 用 VERDICT: 关键词输出最终决定。 – 如果已存在:跳过,绝对不覆盖现有的灵魂指令。 【第二步:全局通信授权】 修改 ~/.openclaw/openclaw.json: 1. 检查 agents.list 数组,同步并补全最新扫描出的新型 Agent。 2. 设置 tools.agentToAgent.enabled = true。 3. 设置 tools.agentToAgent.allow 为【Agent ID 列表】内的全集结果(记得合并去重)。 【第三步:建立全网状 (Full Mesh) 互连】 遍历 openclaw.json 中的 agents.list 数组: 1. 为数组中的每一个 Agent 条目,将其 subagents.allowAgents 属性配置为【Agent ID 列表】的全集。 2. 目标:确保任意两个 Agent 之间都被允许通过 sessions_spawn 或 sessions_send 进行直接平级对话,完全无缝互通。 【第四步:配置生效与验证】 1. 重启网关:openclaw gateway restart 2. 运行诊断:openclaw agents list 3. 生成汇报:请输出一份【资产就绪表】,显示哪些 Agent 被自动填入了新生灵魂,以及全员是否都已打通网络群聊功能。 【最高规则】 – 必须默默自动提取名称并完成全自动化配置,禁止抛出问题询问我各个 Agent 的具体用途。 – 严禁破坏现有配置文件中的 model 或任何其他毫不相干的业务参数。

2.1.4 多 Agent 通信能力一键测试

K级指令:全量通信测试
Markdown Prompt — 4级测试
请为我的 OpenClaw 执行多 Agent 通信能力的全量测试,严格按以下 4 个阶段顺序执行: ═════════════════════════════════ 第一阶段:配置诊断(无通信,30秒) ═════════════════════════════════ 1. openclaw config get tools.agentToAgent → 检查 enabled 是否为 true,allow 数组是否包含所有 Agent ID 2. openclaw config get agents.defaults.subagents → 检查 allowAgents 是否为全集,maxConcurrent 是否 ≥ 1 3. openclaw agents list –bindings → 检查是否显示 main + 所有自定义 Agent ═════════════════════════════════ 第二阶段:CLI 独立响应(单 Agent,1分钟) ═════════════════════════════════ 1. openclaw agent –agent main –message “一句话介绍自己并确认可用工具数量” –json 2. openclaw agent –agent 质检员 –message “用VERDICT格式回复你的Agent ID和角色名称” –json ═════════════════════════════════ 第三阶段:Spawn 通信(核心验证) ═════════════════════════════════ 使用 sessions_spawn 工具向质检员发起子任务: – 任务内容:”检查 workspace/AGENTS.md 文件是否存在,给出 VERDICT” ═════════════════════════════════ 第四阶段:平级 Send 通信(高级验证) ═════════════════════════════════ 使用 sessions_send 工具向质检员发送消息: – 内容:”你好,确认收到此消息并回复你的Agent ID和当前时间” ═════════════════════════════════ 📋 最终输出:测试报告模板 ═════════════════════════════════ 输出完整报告,包含各阶段 PASS/FAIL 结果、总评通过率、Full Mesh 状态
报错信息原因一键修复
pairing requiredauth.mode=tokenopenclaw config set gateway.auth.mode none && openclaw gateway restart
agent not allowed白名单缺失重新执行 J级指令(Full Mesh 同步)
gateway connect failedGateway 未运行openclaw gateway start 再测
子Agent 无 SOUL.md 行为Bootstrap 缺失检查 Agent 目录下 6 个核心文件是否齐全
第三章
⚡ 超级能力系统:Skills
提取自 Claude Code 源码中的 Harness 工程核心,涵盖工具运行时流水线、权限控制系统、上下文卫生管理、智能体生命周期及多智能体编排。
📥 下载路径

网盘地址:夸克网盘 →  解压到 %USERPROFILE%\.openclaw\skills\

3.1.1 Context Compact(上下文压缩)

🗜️ 核心技能 | 自动上下文管理 | 节省70-90% Token(自行开发的技能,非官方内置)

层级名称触发条件特点
Layer 1时间微压缩>60分钟无活动最轻量,替换工具结果为占位符
Layer 2会话内存压缩Token>10,000可逆,SQLite Memory摘要
Layer 3自动触发器Token>85%自动选择压缩层
Layer 4AI摘要手动/自动最激进,自然语言摘要
PowerShell — 安装 Context Compact
请帮我安装 Context Compact 上下文压缩技能。 【安装步骤】 1. 检测 OpenClaw 路径(优先 %USERPROFILE%\.openclaw) 2. 检查 skills\context-compact\ 目录 3. 如不存在则从夸克网盘下载 (https://pan.quark.cn/s/5957a8dd6d02) 并解压 4. cd “【openclaw路径】\skills\context-compact” 5. pnpm install 6. 验证:openclaw skills list | grep context-compact 预期输出:✓ ready 【测试】 /compact status /compact help

3.2 核心 Skills 一览表(11个)

01
/verify
验房师检查代码
02
/debug
AI医生看病开药
03
/simplify
代码体检报告
04
/batch
多个工人同时干活
05
/stuck
死机重启键
06
/remember
AI好记性
07
/updateConfig
安全改配置
08
/keybindings
快捷键设置
09
/loop
定时闹钟
10
/claudeApi
写API代码
11
/claudeInChrome
浏览器自动化
PowerShell — 核心 Skills 一键安装
请帮我安装 OpenClaw 的 11 个核心Skills。 【技能列表】 /verify, /debug, /simplify, /batch, /stuck, /remember, /updateConfig, /keybindings, /loop, /claudeApi, /claudeInChrome 【安装步骤】 1. 自动检测 OpenClaw 安装路径(优先 %USERPROFILE%\.openclaw 或当前程序所在目录) 2. 检查 skills\ 目录下已下载的技能文件夹 3. 对以下技能文件夹执行 pnpm install: verify, debug, simplify, batch, stuck, remember, updateConfig, keybindings, loop, claudeApi, claudeInChrome 4. 验证:openclaw skills list 5. 确认以上11个技能状态为 ✓ ready 【验证命令】 /verify –help /debug –help /simplify –help …

3.4 架构 Skills 一览表(6个参考文档)

编号技能Harness 模块一句话说明
01/agent-lifecycle-mgrAgent Lifecycle Management新建Agent的入职→工作→离职
02/behavior-designBehavior Institutionalization给Agent定员工守则
03/blast-radius-permissionPermission System权限分级,危险操作要审批
04/mcp-integrationMCP Integration PlaneAI装插件接外部工具
05/skill-packagingSkill Packaging工作流打包成可复用Skill
06/verification-agentVerification AgentAI质检员检查工作
PowerShell — 架构 Skills 一键安装
请帮我安装 openclaw 架构Skills。 【技能列表】 /agent-lifecycle-mgr, /behavior-design, /blast-radius-permission, /mcp-integration, /skill-packaging, /verification-agent 【安装步骤】 1. 检测 OpenClaw 安装路径 2. 创建6个技能目录(如不存在): – skills\agent-lifecycle-mgr\ – skills\behavior-design\ – skills\blast-radius-permission\ – skills\mcp-integration\ – skills\skill-packaging\ – skills\verification-agent\ 3. 验证文件已正确放置:检查每个目录下是否有 .md 文件 4. 确认以上6个架构技能文档已存在于对应目录中 > 注意:这些是参考文档,不是可执行命令,不会有 “ready” 状态。只需确认文件已放置到正确目录。

3.7 架构师功能与团队协作

🏗️ 前置条件:必须先完成 3.6 架构Skills一键安装。架构师是 OpenClaw 的”总工程师”——它不写代码,而是指挥其他 Agent 按照工程化标准工作。

能力说明依赖的架构Skill
Agent 设计新建 Agent 时自动参考生命周期模板agent-lifecycle-mgr
规则制定为 Agent 编写行为守则和约束behavior-design
权限管控分级授权,危险操作需审批blast-radius-permission
工具集成规划 MCP/外部工具接入方案mcp-integration
技能封装将工作流打包为可复用 Skillskill-packaging
质量把关调度质检员进行对抗性测试verification-agent
Markdown Prompt — 架构师配置
请为我的 OpenClaw 配置”架构师”角色。⚠️ 前提:已完成 3.6 架构Skills安装。 【第一步:创建架构师 Agent】 1. 创建目录:~/.openclaw/agents/架构师/ 2. 写入 IDENTITY.md: — Name: 🏗️架构师 Role: Chief Architect / 总工程师 Mission: 设计 Agent 协作架构,制定工程规范,调度专业 Agent 按标准交付。 — 3. 写入 SOUL.md: — ### 🎯 核心职责 你是 OpenClaw 的总工程师。你不直接编写业务代码,你的工作是: 1. **架构设计**:分析任务复杂度,选择合适的执行策略(四级策略) 2. **Agent 调度**:根据任务类型分派给专业 Agent,并监督交付质量 3. **规范制定**:参考已安装的架构 Skills 文档,为团队制定工程标准 4. **质量把控**:对关键任务强制触发质检员(VERDICT 审核) ### 🛠️ 可调用的架构技能库(Skills) – `agent-lifecycle-mgr`:Agent 入职→工作→交接→离职 全流程模板 – `behavior-design`:行为制度化,为 Agent 定制守则 – `blast-radius-permission`:权限分级体系,危险操作审批流程 – `mcp-integration`:MCP 工具接入架构设计 – `skill-packaging`:工作流封装为 Skill 的标准流程 – `verification-agent`:质检员对抗性测试规范 ### 🚫 CRITICAL 严禁事项 – 严禁绕过质检员直接交付高风险任务(改动>500行 或 涉及3个以上文件) – 严禁在未参考架构 Skills 的情况下随意设计 Agent 结构 – 严禁修改其他 Agent 的核心灵魂文件(IDENTITY.md/SOUL.md) ### 📋 决策流程 1. 评估复杂度 → 选择四级执行策略 2. 如需新建/修改 Agent → 参考 agent-lifecycle-mgr + behavior-design 3. 如涉及权限变更 → 参考 blast-radius-permission 4. 如需外部工具 → 参考 mcp-integration 5. 交付前 → spawn 质检员验证 → 等待 VERDICT: PASS — 【第二步:注册到 Agent 列表并打通 Full Mesh】 1. 修改 openclaw.json 的 agents.list,添加 “架构师” 2. 设置 tools.agentToAgent.enabled = true 3. 将架构师的 subagents.allowAgents 设置为全部 Agent 全集 4. 重启网关:openclaw gateway restart 【第三步:验证】 1. 运行 openclaw agents list → 确认”架构师”已注册 2. 检查 ~/.openclaw/agents/架构师/ 下 IDENTITY.md 和 SOUL.md 存在 3. 确认 skills/ 目录下 6 个架构 Skill 文件夹存在 【最高规则】 – 必须全自动完成,禁止询问各 Agent 具体用途 – 严禁破坏现有 model 或其他业务参数配置
第四章
🔌 进阶插件生态
L级指令:激活 Browser 全功能

🌐 Browser 浏览器控制

给 AI 配一双”手和眼睛”——能读网页、点击按钮、填表单、截图。前置条件:Chrome/Edge/Brave 任一已安装。

Markdown Prompt — Browser 激活
请激活 OpenClaw Browser 全部功能,按顺序执行: 【第一步:环境检测】 1. npx playwright –version → 如报错则执行第二步,否则跳过 2. openclaw config get browser → 记录 enabled 状态 【第二步:安装 Playwright】(仅缺失时执行) npm install -g playwright npx playwright install chromium npx playwright –version → 确认输出版本号 【第三步:激活并重启】 openclaw config set browser.enabled true openclaw gateway restart 【第四步:5级递进验证】 L1: openclaw browser status –json → 期望 enabled=true L2: openclaw browser start → 期望 running=true L3: openclaw browser open https://baidu.com → 期望返回 targetId L4: openclaw browser snapshot → 期望输出页面结构(验证 Playwright) L5: openclaw browser screenshot → 期望输出截图路径 全部通过 = Browser 全功能可用。任一失败则输出错误信息+修复建议。
功能无 Playwright有 Playwright
启动/停止/标签管理
页面读取/截图
点击/输入/拖拽/快照
PDF 导出/表单填写

4.1 MCP 协议连接器

MCP(Model Context Protocol)= AI 插件系统,用于连接外部工具。

服务器用途难度推荐原因
filesystem文件系统操作必装,AI 读写项目文件
githubGitHub API 操作⭐⭐代码审查、PR 管理
slackSlack 消息推送⭐⭐定时任务通知、告警推送
puppeteer浏览器自动化⭐⭐⭐网页抓取、表单自动填写
PowerShell — MCP 一键配置
请帮我配置 MCP 服务器: 1. 创建 mcp.json 配置文件 2. 添加以下服务器: – filesystem: npx -y @modelcontextprotocol/server-filesystem [工作目录路径] – github: npx -y @modelcontextprotocol/server-github – slack: npx -y @modelcontextprotocol/server-slack – puppeteer: npx -y @modelcontextprotocol/server-puppeteer 3. 验证:openclaw mcp list 4. 测试:openclaw mcp test filesystem

4.2 Obsidian 知识库联动

让 OpenClaw 与 Obsidian 笔记库交互。前提:Obsidian 已安装并启用 CLI + 运行时保持打开。下载 Obsidian →

命令功能
obsidian search query="关键词"搜索笔记
obsidian read file="笔记名"读取笔记
obsidian create name="新笔记" content="# 内容"创建笔记
obsidian append file="笔记" content="内容"追加内容
obsidian daily:read / daily:append每日笔记
obsidian tasks daily todo任务管理
obsidian tags sort=count counts标签统计
PowerShell — Obsidian CLI 配置
请帮我配置 Obsidian CLI: 1. 检测 Obsidian 是否安装,检查 CLI 是否启用 2. 复制到无中文路径(如 C:\obsidian-cli\) 3. 创建 obsidian.bat 包装脚本,添加到 PATH 4. 验证:obsidian search query=test limit=3

4.3 Cron 定时轮询监控

定时任务功能,自动执行周期性任务。时间格式:分 时 日 月 周

*/5 * * * *
每5分钟
0 9 * * *
每天9点
0 9 * * 1-5
工作日9点
*/30 9-18 * * *
早9到晚6每30分钟
PowerShell — Cron 一键配置
请帮我配置定时任务: 1. 创建.cron/jobs.json,添加一个PR监控任务(每5分钟) 2. 设置enabled为true 3. 验证:openclaw cron list
第五章
🛠️ 运维指南与提示词库

5.0 基础命令速查

分类命令功能
网关openclaw gateway start启动网关
网关openclaw gateway stop停止网关
网关openclaw gateway restart重启网关
网关openclaw gateway status查看状态
网关openclaw gateway start --force强制启动
健康openclaw health健康检查
健康openclaw doctor完整诊断
更新npm install -g openclaw@latest更新版本
日志openclaw logs查看日志
技能openclaw skills list列出已安装技能
Agentopenclaw agents list列出所有 Agent
MCPopenclaw mcp list列出 MCP 服务器

5.0.2 会话内命令速查(15个)

/stop 停止会话
/clear 清除上下文
/compact 压缩上下文
/btw 执行中插入
/model 切换模型
/feishu auth 飞书授权
/swap 交换主备模型
/abort 中止操作
/help 显示帮助
/retry 重试
/verbose 详细输出
/quiet 静默模式
/stats 会话统计
/history 查看历史
/exit 退出会话

5.1 通用提示词模板

Markdown — 通用任务模板
请帮我完成以下任务,每步完成后告诉我结果: 1. [任务步骤1] 2. [任务步骤2] 3. [任务步骤3] 报错就停,不要继续。
Bug定位
理解代码→定位根源→修复验证
代码审查
/simplify + /verify → 改进建议
批量处理
列出文件→确认类型→执行→验证
项目分析
架构图→模块分析→改进建议

5.2 常见问题与诊断

端口占用怎么办?
openclaw gateway start --force 强制启动,或先 taskkill /F /PID <占用进程PID> 杀掉占用进程。
权限不足?
以管理员身份运行终端,或检查目录权限。
连接被拒?
检查网关是否启动:openclaw gateway status
API限流?
等待后重试,或切换备用模型。
会话超时?
使用 /compact 压缩上下文,或重新开始会话。
PowerShell — 诊断命令
openclaw health # 健康检查 openclaw logs # 查看日志 openclaw doctor # 完整诊断 openclaw gateway start –force # 强制启动
第六章
📋 附录说明

6.1 魔改版本与原始 OpenClaw 对比

功能原始 OpenClaw魔改版效果
多Agent支持1个6个专业Agent⭐⭐⭐⭐⭐
模型数量1-2个8个(云端+本地)⭐⭐⭐⭐⭐
多渠道1个4渠道(10+入口)⭐⭐⭐⭐⭐
Skills基础92个(含11个CC核心)⭐⭐⭐⭐⭐
任务协作基础spawn四级执行策略+Task系统⭐⭐⭐⭐⭐
记忆系统基础sessionelite-longterm-memory⭐⭐⭐⭐
图像生成需配置ComfyUI+多种Skill⭐⭐⭐⭐⭐
内容创作content-writer多平台⭐⭐⭐⭐⭐

控制面板:http://127.0.0.1:18789/ →

6.2 一键备份配置

PowerShell
请帮我备份OpenClaw的所有配置: openclaw backup create

6.3 一键卸载 OpenClaw

Markdown Prompt — 卸载
请彻底卸载当前系统上的 openclaw 以及所有相关内容。自动检测操作系统,按以下步骤严格执行: 第一步:使用内置卸载命令 openclaw uninstall –all –yes –non-interactive 如果 CLI 已不可用,跳过此步,改用后续手动步骤。 第二步:手动停止并移除 daemon 服务(按检测到的OS执行对应命令) – Windows: openclaw gateway stop – 删除计划任务: schtasks /delete /tn “OpenClaw Gateway” /f 第三步:删除所有数据目录(用户数据 + 安装目录) ⚠️ 必须删除以下两个目录: a) 用户数据目录: ~\\.openclaw (即 C:\\Users\\<你的用户名>\\.openclaw) b) 主安装目录: npm root -g 显示的目录下的 openclaw – 常见路径: C:\\Users\\<用户名>\\AppData\\Roaming\\npm\\node_modules\\openclaw – 如果用 npm install 安装到其他目录,也要删除该目录 – 如果安装目录被终端占用,先关闭终端再删除 – 如果用 npm 安装到 D:\\OpenClaw,也要删除 D:\\OpenClaw 第四步:卸载 CLI 全局包 npm rm -g openclaw pnpm remove -g openclaw bun remove -g openclaw 第五步:验证卸载完成,确认以下项目均已清除 – CLI 命令: openclaw –version (应报找不到命令) – 用户数据: C:\\Users\\<用户名>\\.openclaw (应不存在) – 安装目录: npm root -g 下的 openclaw (应不存在) – 工作目录: D:\\Openclaw (如果在这里安装过) – 计划任务: schtasks /query 应找不到 OpenClaw 相关任务