目录一、OpenClaw 是什么二、核心概念与架构1. 基础核心机制2. 架构与核心组件三、安装与基础配置1. 环境要求与安装2. 初始化配置四、进阶配置1. 模型接入与切换2. 接入飞书国内推荐3. 安装技能Skills4. 身份设定五、安全使用指南六、常见玩法一、OpenClaw 是什么OpenClaw 是一款开源、可自托管的个人 AI Agent 平台能运行在个人电脑或 VPS 上连接飞书、WhatsApp 等 22 聊天平台。它不只是聊天工具还能执行读写文件、处理邮件、运行代码、控制浏览器等实际任务相当于一个 24 小时在线、介于消息应用和工具链之间的智能网关。其核心优势有两点一是完全的本地控制权可直接操作本地文件系统和浏览器数据不上云隐私更有保障二是无缝的交互入口无需独立网页 UI能通过日常聊天软件直接操作。二、核心概念与架构1. 基础核心机制Memory对话记忆分短期记忆保留最近几轮对话保证连贯性和长期记忆压缩久远对话为摘要或提取关键信息如用户职业、偏好解决大模型上下文窗口限制问题。RAG检索增强生成先检索外部资料再作答弥补大模型知识“冻结”的缺陷能回答实时信息或内部文档问题。MCP 协议标准化模型与外部工具的对接方式让 AI 能调用天气、数据库等外部工具。Skills流程规划定义特定场景下工具的使用顺序和逻辑避免工具调用混乱提升稳定性。2. 架构与核心组件架构模式“微核 插件 统一网关”类似“AI 操作系统”。核心组件Gateway网关系统中枢管理连接、会话、配置和任务调度不负责“思考”。Channels消息渠道适配器抹平不同聊天平台的协议差异实现多平台一致体验。Hooks扩展机制可在系统启动、会话重置等事件发生时自动触发自定义逻辑。CronJob定时任务让 AI 脱离人工指令主动执行周期性任务如定时巡检、报告生成。记忆系统通过 SOUL.md人格内核、USER.md用户画像等 8 类分层文件实现跨会话、跨项目的记忆延续越用越懂用户。三、安装与基础配置1. 环境要求与安装需 Node.js 22 以上版本可通过图形界面或 Homebrew 安装。安装命令npm install -g openclawlatest安装后执行openclaw --version验证。2. 初始化配置运行openclaw onboard --install-daemon启动配置向导新手推荐选择 QuickStart 模式。关键步骤同意安全提示、选择模型厂商如 OpenAI、MiniMax、阿里百炼等并配置 API Key、可暂时跳过 Channels后续添加和 Skills 安装、开启 command-logger审计日志和 session-memory会话记忆两个核心 Hooks。配置完成后通过终端输出的 WebUI 地址含 Token访问控制台即可开始使用。四、进阶配置1. 模型接入与切换支持自定义模型配置可在配置文件~/.openclaw/openclaw.json中添加多个模型提供商。切换模型输入/model 模型标识指令可设置模型回退机制主模型故障时自动切换备用模型。2. 接入飞书国内推荐飞书开发者平台创建企业自建应用获取 App ID 和 App Secret。开通机器人能力批量导入所需权限如接收消息、发送消息等发布应用。在 OpenClaw 配置中添加飞书通道信息配置事件订阅推荐长连接模式通过配对码完成绑定后即可在飞书对话。3. 安装技能Skills技能加载优先级项目工作区技能 本地托管技能 内置技能。官方技能市场 ClawHub 收录 19000 技能安装 ClawHub CLI 后可通过命令快速搜索安装如clawhub install tavily-search。部分技能需配置 API Key 才能使用如 Tavily 搜索技能。4. 身份设定通过 4 个核心文件自定义 AI 人设IDENTITY.md基础身份名字、风格。USER.md用户画像身份、需求、偏好。SOUL.md人格内核语气、行为边界、安全红线。AGENTS.md工作规范任务流程、工具使用规则。五、安全使用指南OpenClaw 因具备系统级权限和外部通信能力需重视安全防护网络控制绑定 loopback 地址、设置防火墙、启用网关认证远程访问用隧道。隔离与权限启用沙箱模式、非 root 用户运行、仅开放必需工具权限。技能与凭证安装前审计技能源码、用环境变量存储 API Key、定期轮换凭证。日志与监控开启会话日志、设置关键事件告警、定期运行安全审计命令。可直接使用文中提供的安全版 SOUL.md明确防注入、防泄露等规则。六、常见玩法晨间智能简报自动推送天气、日历、邮件摘要和行业资讯。高效办公邮件自动分流、文件自动归档、手机端 DevOps审查 PR、运行测试。个人管理个人 CRM维护联系人、“第二大脑”记忆各类信息随时检索、IoT 设备控制。企业与创作企业知识库问答、多 Agent 协作完成营销内容从选题到发布的全流程。