夜雨聆风
🧠 什么是 OpenClaw？
OpenClaw 是一种能够“主动为你工作”的 AI 自动化工具。
和我们常见的 AI（比如 ChatGPT、Claude、Gemini）不同：
👉 传统 AI：你问 → 它答（被动）
👉 OpenClaw：无需你持续操作，它会主动帮你完成任务（主动）
⚖️ OpenClaw 和传统 AI 的区别
类型工作方式ChatGPT / Claude你打开 → 提问 → 得到答案OpenClaw一直运行 → 自动执行任务 → 主动反馈
👉 一句话总结：
传统 AI 是工具，OpenClaw 更像一个“全天候打工的 AI 助理”
🧩 OpenClaw 的三大核心能力
1️⃣ AI大脑 + 记忆能力
通过 API 连接 AI 模型（如 GPT / Claude）
可以记录上下文和历史信息
会随着使用不断优化决策
👉 相当于一个会成长的智能助手
2️⃣ 全天候在线（7×24运行）
部署在服务器上持续运行
不需要你反复打开
可以主动执行任务
它可以做到：
主动提醒你
自动安排事项
实时监控变化
推送最新进展
👉 本质是：从“你用AI”变成“AI替你干活”
3️⃣ 强大的工具连接能力
OpenClaw 可以连接各种应用，并“真正执行操作”：
QQ
Gmail
日历（Calendar）
云盘（Google Drive）
Slack / Discord
👉 不只是“回答问题”，而是直接帮你操作系统和工具
🔥 OpenClaw 能做到什么？（真实案例）
这些都是用户真实使用场景👇
📅 场景1：智能日程助手
每天早上7点，自动检查日历 + 邮件并整理当天最重要的事项发送给你
👉 相当于一个“AI秘书”
🧑💼 场景2：面试准备自动化
自动发现日历中的面试→ 收集公司信息→ 分析岗位需求→ 匹配你的简历→ 生成准备文档
👉 全流程自动完成
🏋️ 场景3：自动抢名额
监控健身房课程在开放报名时自动帮你预约
👉 典型的“自动执行任务”
🧬 OpenClaw 的本质是什么？
你可以这样理解：
👉 OpenClaw = AI + 自动化系统 + 外部工具执行能力
或者更直白一点：
它不是一个聊天工具，而是一个“会自己行动的AI系统”
🛠️ 如何安装 OpenClaw？（保姆级教程）
很多人看到这里会觉得：
👉 “这个东西是不是很复杂？”
其实不然，我帮你整理了一套**最简单可用的安装方式（新手也能搞定）**👇
🛠️ OpenClaw 安装教程（官方推荐方式）
💻 macOS / Linux
直接在终端运行：
curl -fsSL https://openclaw.ai/install.sh | bash
👉 说明：
自动下载并安装 OpenClaw
一步完成环境配置
推荐使用（最简单）
🪟 Windows（PowerShell）
打开 PowerShell，执行：
iwr -useb https://openclaw.ai/install.ps1 | iex
👉 说明：
适用于 Windows 用户
自动完成安装流程
📦 npm 安装（适合开发者）
使用 npm：
npm install -g openclaw@latest
或使用 pnpm：
pnpm add -g openclaw@latest
👉 说明：
适合有 Node.js 环境的用户
可用于开发和自定义
🚀 运行引导（完成安装后必做）
安装完成后，你需要进行初始化，让 OpenClaw 正式开始工作。
🔧 完整初始化（推荐）
openclaw onboard --install-daemon
👉 作用：
初始化系统配置
安装后台服务（daemon）
让 OpenClaw 24小时自动运行
👉 适合：
想让 AI 持续帮你干活的人（推荐）
⚙️ 仅初始化（不后台运行）
openclaw onboard
👉 作用：
只完成基础配置
不会常驻后台运行
👉 适合：
测试使用
临时体验
🔍 检查安装是否成功
安装完成后，可以用下面两个命令验证👇
✅ 查看运行状态
openclaw gateway status
👉 如果显示运行中（running），说明系统已经正常启动
🖥️ 打开控制面板
openclaw dashboard
👉 作用：
打开 Web 控制界面
管理你的 AI 自动化流程
🧩 1. 启动 Gateway（核心服务）
🧪 前台运行（适合调试）
openclaw gateway --port 18789 --verbose
👉 特点：
可以看到详细日志
适合排查问题
⚙️ 后台运行（推荐）
openclaw gateway start
👉 特点：
后台运行
不占用终端
更稳定
🖥️ 2. 打开控制面板
openclaw dashboard
👉 或直接访问：
http://127.0.0.1:18789
👉 这里就是你的：
AI控制中心（所有自动化都在这里管理）
📩 3. 发送一条测试消息
openclaw message send --to +15555550123 --message "Hello from OpenClaw"
👉 用来验证：
消息系统是否正常
外部连接是否成功
🤖 4. 与 AI 直接对话
openclaw agent --message "帮我总结今天的会议" --thinking high
👉 说明：
agent = AI智能体
--thinking high = 更强推理能力
📂 Workspace（工作空间是什么？）
OpenClaw 有一个非常重要的概念：
👉 Workspace（工作空间）
你可以理解为：
AI的大脑 + 记忆 + 工作目录
🗂️ 默认目录结构
~/.openclaw/├── openclaw.json # 主配置文件├── workspace/ # 核心工作空间│ ├── AGENTS.md # 操作规则 & 行为指令│ ├── SOUL.md # AI人格（语气、风格）│ ├── TOOLS.md # 工具说明│ ├── IDENTITY.md # 助手身份│ ├── USER.md # 用户信息│ ├── MEMORY.md # 长期记忆│ └── skills/ # 技能扩展├── agents/ # 多Agent会话├── skills/ # 全局技能└── credentials/ # API密钥存储
🧠 核心文件说明（非常关键）
文件作用加载时机AGENTS.md行为规则、长期记忆每次对话SOUL.md人格、语气、风格每次对话TOOLS.md工具使用说明每次对话USER.md用户背景信息每次对话IDENTITY.mdAI身份设定每次对话MEMORY.md长期记忆（敏感信息）
⚙️ 配置 openclaw.json（核心配置文件）
OpenClaw 的所有能力，都是通过这个文件控制的👇
📄 路径：
~/.openclaw/openclaw.json
👉 它使用 JSON5 格式（支持注释，比 JSON 更灵活）
🧪 一、最小可用配置（新手必备）
{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace" } }
}
🧠 配置解释（通俗版）
agents（智能体配置）
workspace 👉 AI的“记忆空间”
决定它读取哪些规则、记忆、人格
channels（通信渠道）
这里配置 AI 怎么跟你“说话”👇
QQ示例：
enabled → 是否启用
botToken → 你的机器人Token
allowFrom → 允许谁访问
👉 本质：让 OpenClaw 通过 QQ和你互动
🤖 二、Agents 进阶配置（AI核心）
{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace", "model": { "primary": "anthropic/claude-sonnet-4-5", "fallbacks": ["openai/gpt-5.2"] }, "heartbeat": { "every": "30m", "target": "last" } } }}
🔥 重点解释（必须写给读者）
🧠 model（模型选择）
primary → 主模型（推荐 Claude）
fallbacks → 备用模型（比如 GPT）
👉 好处：
自动切换
提高稳定性
❤️ heartbeat（心跳机制）
👉 这个非常关键！！！
every: "30m" → 每30分钟执行一次任务
target: "last" → 针对最近任务
👉 本质：
让 AI“主动干活”，而不是等你命令
🧩 三、Session 会话管理
{ "session": { "dmScope": "per-channel-peer", "reset": { "mode": "daily", "atHour": 4, "idleMinutes": 120 } }}
📌 配置解释
dmScope
👉 会话范围：
per-channel-peer → 每个渠道独立会话
reset（重置策略）
mode: daily → 每天重置
atHour: 4 → 凌晨4点
idleMinutes: 120 → 2小时无操作自动清理
👉 作用：
✔ 控制上下文长度✔ 防止AI“记忆爆炸”
🤖 如何对接 QQ 机器人（打造你的AI私人助理）
如果你不想一直开网页，其实可以：
👉 直接用QQ和OpenClaw聊天
甚至可以做到：
用QQ给AI下指令
AI自动帮你执行任务
主动给你推送提醒
🚀 一、准备工作
在开始之前，你需要准备👇
✅ 1. 创建QQ机器人
进入 QQ机器人平台，创建一个机器人，获取：
AppID
AppSecret
👉 这两个非常重要（相当于你的“钥匙”）
🧩 二、安装 QQ 插件
在你的服务器 / 本地终端执行：
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
👉 作用：
✔ 让 OpenClaw 支持 QQ 通信
⚙️ 三、配置 QQ 渠道
执行下面命令👇
openclaw channels add --channel qqbot --token "AppID.AppSecret"
👉 示例：
openclaw channels add --channel qqbot --token "1903456700.xxxxxx"
🧠 参数说明
qqbot → 指定 QQ 渠道
token → AppID + AppSecret 拼接
👉 格式：
AppID.AppSecret
🔄 四、重启服务（关键一步）
openclaw gateway restart
👉 这一步必须执行，否则不会生效！
🤖 多智能体（Multi-Agent）配置
OpenClaw 支持多个 AI 同时工作，每个都有不同能力。
👉 你可以理解为：
一个AI负责写作，一个AI负责编程，一个AI负责运营
🧪 配置示例
{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace" }, "list": [ { "id": "main", "description": "通用助手" }, { "id": "coder", "workspace": "~/.openclaw/workspace-coder", "description": "编程专家" } ] }}
🧠 重点说明
main 👉 默认AI（什么都能做）
coder 👉 专门写代码的AI
workspace 👉 每个AI都有独立“记忆空间”
👉 本质：
让AI分工合作，而不是一个AI做所有事情
🧩 技能系统（Skills）
OpenClaw 的能力不是固定的，而是可以“扩展”的👇
👉 技能 = 可复用功能模块
比如：
图像生成
天气查询
GitHub操作
视频处理
📦 安装 ClawHub
npm install -g clawhub
🔍 搜索技能
clawhub search "image generation"clawhub search "weather"
🚀 安装技能
# 最新版本clawhub install baoyu-image-gen# 指定版本clawhub install baoyu-image-gen --version 1.2.3
🔧 管理技能
clawhub list # 查看已安装clawhub update baoyu-image-genclawhub update --all # 更新全部clawhub update --force # 强制更新
🔥 推荐技能（直接可用）
技能功能baoyu-image-genAI图片生成weather天气查询githubGitHub操作video-frames视频处理xurlTwitter/X操作
🧠 技能原理
每个技能其实是一个文件夹👇
my-skill/├── SKILL.md└── 其他脚本
👉 安装后：
OpenClaw 会自动识别并调用，无需额外配置
🚀 发布自己的技能
clawhub loginclawhub publish ./my-skill \ --slug my-skill \ --name "My Skill" \ --version 1.0.0 \ --changelog "Initial release"
⌨️ 常用 CLI 命令
🔌 Gateway 管理
openclaw gateway statusopenclaw gateway startopenclaw gateway stopopenclaw gateway restart
⚙️ 配置管理
openclaw onboardopenclaw config get agents.defaults.workspaceopenclaw config set agents.defaults.model.primary "openai/gpt-5.2"
🧪 诊断工具
openclaw doctoropenclaw doctor --fixopenclaw logs --follow
🔒 安全最佳实践（一定要写）
⚠️ 不要开放权限！
❌ 错误做法：
dmPolicy = open
✅ 正确做法：
pairing
allowlist
👥 多用户隔离
{ "session": { "dmScope": "per-channel-peer" }}
🛡️ 沙盒执行（推荐开启）
{ "agents": { "defaults": { "sandbox": { "mode": "non-main", "scope": "agent" } } }}
👉 防止 AI 执行危险操作
