OpenClaw满血版安装全流程
不用输入一行代码,复制粘贴就能打造多Agent军团
必要文件网盘:夸克网盘下载 → | 代理工具:乐连(推荐)→ | 空气糖果(备选,优惠码 26Q190)→
1.1 核心模型推荐
GPT-5.4 系列
Claude Opus 4.6
Gemini 3.1 系列
qwen3.5:9b
qwen3.5:27b(平替推荐)
qwen-coder:30B(平替推荐)
gemma4:31b
gemma4:26b
💡 Dense vs MoE:Dense 模型(如 gemma4:31b)所有参数全量激活,精度高但显存需求大;MoE 模型(如 qwen3.5 系列)每次只激活部分专家参数,在相近效果下显著降低显存占用。
1.1.1 Harness Engineering 工程
给 AI 野马套上”缰绳、马鞍和护栏”,让它想犯错都没机会。核心原则:别指望野马自己变乖,用工程系统让它想犯错都没机会。
1.2 基础安装流程
检测环境
检查操作系统、Node.js 22+、npm 是否就绪
安装 OpenClaw
从国内镜像源安装最新版 CLI
配置 + 启动 Gateway + 修复 device token
非交互式 onboard → 后台启动 Gateway → Token 轮换,一步到位
验证 + 打开 Dashboard + 开机自启
健康检查 → 打开控制面板 → VBS 开机自启(无需管理员权限)
1.3 安全加固
防止 API Key 泄露 · 隔离外网攻击(网关只监听本地)· 防止群聊滥用 · 防止提示注入
doctor / onboard / wizard 等命令会自动重写 openclaw.json,以下值最容易被改回默认值:
| 配置项 | 正确值 | 被改回的错误值 | 触发场景 |
|---|---|---|---|
gateway.auth.mode | token | none | 执行 doctor / onboard / wizard 后 |
agents.defaults.workspace | $PWD\workspace | %USERPROFILE%\.openclaw\workspace | 未执行迁移步骤 |
何时执行:安装完任何插件后 · 运行完 doctor --fix 后 · 重启网关后发现 Dashboard 连不上时
1.4 进阶性能与质量加固
OpenClaw 从”好玩”变到”好用”的关键步。通过质检监控和成本管控,让 AI 从”随缘完成”变为”严谨交付”。
飞书渠道
1. 访问链接自动创建专用机器人:创建飞书机器人 →
配对测试:从飞书向机器人发消息 → 查看网关日志中的 pairing code → openclaw pairing approve feishu <配对码>
微信渠道
确保微信已升级到最新版本,进入:我 → 设置 → 插件 → 微信ClawBot → 详情
配置完成后,使用微信「扫一扫」识别二维码绑定机器人
此指令创建的是子Agent,不是替换主Agent。子Agent独立运行在指定工作目录,通过 sessions_spawn 由主Agent调用。Agent间通信配置(Full Mesh)将在后续 J级指令中统一设置。
质检员就像工厂里的”QA检验员”——主Agent写完代码后,质检员专门负责”找茬”。它会用各种刁钻方法测试代码(并发请求、空数据、删不存在的文件),只有经得起考验的代码才能拿到 PASS。
MEMORY.md 是AI的”经验笔记本”。AI每次完成任务后,会把成功的经验记下来。下次遇到类似问题时,AI会先翻笔记本看看以前是怎么解决的。时间越长,AI就越聪明。
Full Profile 是给AI”解锁全部技能”。默认只开放”写代码”相关工具,开启后AI就能使用浏览器、执行命令行、读写任意文件等全部能力。测试方法:在 openclaw 对话框中输入”打开浏览器搜索【xxx内容】”
新安装后记忆系统是”残血版”——配置向量模型后,AI才能把”长期记忆”编入索引,实现按语义检索。
| 组件 | 路径 | 说明 |
|---|---|---|
| 向量数据库 | ~/.openclaw/memory/<agentId>.sqlite | 每 Agent 一个,支持语义搜索 |
| 核心记忆 | ~/.openclaw/workspace/MEMORY.md | 用户偏好、团队协作、项目进展 |
| 详细记忆 | ~/.openclaw/workspace/memory/ | 按话题分类的记忆文件 |
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)
每次新建 Agent 后的”一键开光”工具。无论后期新增了多少个 Agent,只需执行这一条 Prompt,AI自动包揽一切。
2.1.4 多 Agent 通信能力一键测试
| 报错信息 | 原因 | 一键修复 |
|---|---|---|
pairing required | auth.mode=token | openclaw config set gateway.auth.mode none && openclaw gateway restart |
agent not allowed | 白名单缺失 | 重新执行 J级指令(Full Mesh 同步) |
gateway connect failed | Gateway 未运行 | 先 openclaw gateway start 再测 |
| 子Agent 无 SOUL.md 行为 | Bootstrap 缺失 | 检查 Agent 目录下 6 个核心文件是否齐全 |
网盘地址:夸克网盘 → 解压到 %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 4 | AI摘要 | 手动/自动 | 最激进,自然语言摘要 |
3.2 核心 Skills 一览表(11个)
3.4 架构 Skills 一览表(6个参考文档)
| 编号 | 技能 | Harness 模块 | 一句话说明 |
|---|---|---|---|
| 01 | /agent-lifecycle-mgr | Agent Lifecycle Management | 新建Agent的入职→工作→离职 |
| 02 | /behavior-design | Behavior Institutionalization | 给Agent定员工守则 |
| 03 | /blast-radius-permission | Permission System | 权限分级,危险操作要审批 |
| 04 | /mcp-integration | MCP Integration Plane | AI装插件接外部工具 |
| 05 | /skill-packaging | Skill Packaging | 工作流打包成可复用Skill |
| 06 | /verification-agent | Verification Agent | AI质检员检查工作 |
3.7 架构师功能与团队协作
🏗️ 前置条件:必须先完成 3.6 架构Skills一键安装。架构师是 OpenClaw 的”总工程师”——它不写代码,而是指挥其他 Agent 按照工程化标准工作。
| 能力 | 说明 | 依赖的架构Skill |
|---|---|---|
| Agent 设计 | 新建 Agent 时自动参考生命周期模板 | agent-lifecycle-mgr |
| 规则制定 | 为 Agent 编写行为守则和约束 | behavior-design |
| 权限管控 | 分级授权,危险操作需审批 | blast-radius-permission |
| 工具集成 | 规划 MCP/外部工具接入方案 | mcp-integration |
| 技能封装 | 将工作流打包为可复用 Skill | skill-packaging |
| 质量把关 | 调度质检员进行对抗性测试 | verification-agent |
🌐 Browser 浏览器控制
给 AI 配一双”手和眼睛”——能读网页、点击按钮、填表单、截图。前置条件:Chrome/Edge/Brave 任一已安装。
| 功能 | 无 Playwright | 有 Playwright |
|---|---|---|
| 启动/停止/标签管理 | ✅ | ✅ |
| 页面读取/截图 | ✅ | ✅ |
| 点击/输入/拖拽/快照 | ❌ | ✅ |
| PDF 导出/表单填写 | ❌ | ✅ |
4.1 MCP 协议连接器
MCP(Model Context Protocol)= AI 插件系统,用于连接外部工具。
| 服务器 | 用途 | 难度 | 推荐原因 |
|---|---|---|---|
| filesystem | 文件系统操作 | ⭐ | 必装,AI 读写项目文件 |
| github | GitHub API 操作 | ⭐⭐ | 代码审查、PR 管理 |
| slack | Slack 消息推送 | ⭐⭐ | 定时任务通知、告警推送 |
| puppeteer | 浏览器自动化 | ⭐⭐⭐ | 网页抓取、表单自动填写 |
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 | 标签统计 |
4.3 Cron 定时轮询监控
定时任务功能,自动执行周期性任务。时间格式:分 时 日 月 周
*/5 * * * *每5分钟
0 9 * * *每天9点
0 9 * * 1-5工作日9点
*/30 9-18 * * *早9到晚6每30分钟
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 | 列出已安装技能 |
| Agent | openclaw agents list | 列出所有 Agent |
| MCP | openclaw 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 通用提示词模板
理解代码→定位根源→修复验证
/simplify + /verify → 改进建议
列出文件→确认类型→执行→验证
架构图→模块分析→改进建议
5.2 常见问题与诊断
openclaw gateway start --force 强制启动,或先 taskkill /F /PID <占用进程PID> 杀掉占用进程。openclaw gateway status/compact 压缩上下文,或重新开始会话。6.1 魔改版本与原始 OpenClaw 对比
| 功能 | 原始 OpenClaw | 魔改版 | 效果 |
|---|---|---|---|
| 多Agent支持 | 1个 | 6个专业Agent | ⭐⭐⭐⭐⭐ |
| 模型数量 | 1-2个 | 8个(云端+本地) | ⭐⭐⭐⭐⭐ |
| 多渠道 | 1个 | 4渠道(10+入口) | ⭐⭐⭐⭐⭐ |
| Skills | 基础 | 92个(含11个CC核心) | ⭐⭐⭐⭐⭐ |
| 任务协作 | 基础spawn | 四级执行策略+Task系统 | ⭐⭐⭐⭐⭐ |
| 记忆系统 | 基础session | elite-longterm-memory | ⭐⭐⭐⭐ |
| 图像生成 | 需配置 | ComfyUI+多种Skill | ⭐⭐⭐⭐⭐ |
| 内容创作 | 无 | content-writer多平台 | ⭐⭐⭐⭐⭐ |





