OpenClaw AI 助手平台使用指南

!!! tip "什么是 OpenClaw？" OpenClaw 是一款自托管的 AI 助手 / Agent 平台，支持多种大模型（DeepSeek、OpenAI、Claude 等），可部署在个人服务器上，并通过微信群、企业微信、Telegram、Discord 等即时通讯渠道与用户交互。

---

快速开始

环境要求

安装方式

方式一：npm 安装（推荐）

npm install -g openclaw
openclaw init my-agent
cd my-agent
openclaw start

方式二：一键脚本

curl -fsSL https://get.openclaw.dev | bash

安装完成后，浏览器访问 http://localhost:3000 即可进入 Control UI 控制台。

NOTE: 首次启动会生成配置文件，请根据提示填入 API Key 等必要信息。

---

核心概念

1. 多模型支持

OpenClaw 支持同时配置多个大语言模型，并为不同任务指定不同模型：

# config.yaml 示例
models:
  chat:
    provider: deepseek
    model: deepseek-chat
    api_key: ${DEEPSEEK_API_KEY}
  reasoning:
    provider: openai
    model: o1-mini
    api_key: ${OPENAI_API_KEY}
  fast:
    provider: openai
    model: gpt-4o-mini
    api_key: ${OPENAI_API_KEY}

2. 技能系统（Skills）

技能（Skill）是 OpenClaw 的核心扩展机制。每个技能由一个 SKILL.md 文件定义，包含触发条件、使用说明和工具调用规范。

技能目录结构：

~/.openclaw/skills/
├── weather/
│   └── SKILL.md
├── notion/
│   └── SKILL.md
└── wecom-msg/
    └── SKILL.md

创建自定义技能：

# SKILL.md - 我的自定义技能

## 触发条件
当用户提到“查天气”“温度”“下雨”时触发。

## 使用方式
调用 weather 工具获取指定城市的天气信息。

## 工具
- web_search：搜索天气数据
- web_fetch：获取详细天气页面

OpenClaw 会自动加载所有技能目录，在对话中根据上下文匹配合适的技能。

3. 记忆系统

记忆系统让 AI 具备长期记忆能力，分为两层：

短期记忆（Memory 目录）：

memory/
├── 2026-06-01.md   # 每日日志
├── 2026-06-02.md
└── HEARTBEAT.md     # 心跳检查清单

长期记忆（MEMORY.md）：

# MEMORY.md - 长期记忆

## 用户偏好
- 喜欢简洁的回答
- 偏爱 DeepSeek 模型处理日常对话
- 通常上午处理邮件，下午写代码

## 重要决策
- 2026-05-20：迁移到 OpenClaw v2 平台

!!! tip "记忆搜索" 使用 memory_search 工具可以语义搜索所有记忆文件，精准找到过往决策和上下文。

4. 子代理系统（Subagent）

子代理允许将复杂任务拆解为多个并行执行的子任务：

主任务：调研新能源汽车市场
  ├─ 子代理1: 搜索销量数据
  ├─ 子代理2: 搜索政策信息
  ├─ 子代理3: 搜索品牌格局
  └─ 汇总报告

典型使用场景：

5. Cron 任务系统

支持设置定时、周期性任务：

cron:
  - name: "每日早报"
    schedule: "0 8 * * *"   # 每天早上8点
    task: "查看天气、日历和邮件，生成今日简报"

  - name: "周报提醒"
    schedule: "0 18 * * 5"  # 每周五下午6点
    task: "提醒用户提交周报"

Cron 表达式格式与 Linux crontab 兼容。

6. 工具系统

OpenClaw 内置丰富的工具集：

7. 插件系统（MCP 协议）

OpenClaw 支持 MCP（Model Context Protocol） 协议，可接入第三方插件生态：

# config.yaml 中的 MCP 插件配置
plugins:
  wecom:
    type: mcp
    config:
      command: node
      args: ["path/to/wecom-server.js"]
      env:
        WECOM_CORPID: ${WECOM_CORPID}

已适配的 MCP 插件示例：

• 企业微信消息 / 日程 / 文档管理
• Notion 集成
• 百度网盘操作
• 自定义业务工具

8. 网关与 Control UI

Gateway 是消息路由的核心组件，负责接收来自各渠道的消息并路由到 AI 引擎。

Control UI 是基于 Web 的管理控制台：

• 查看系统状态
• 管理配置
• 查看日志
• 管理模型
• 调试技能

curl -fsSL https://get.openclaw.dev | bash
0

---

进阶使用

发布文章到博客

通过 publish_article.py 脚本可将 AI 生成的内容一键发布到 Zblog 博客：

curl -fsSL https://get.openclaw.dev | bash
1

渠道对接

技能开发最佳实践

1. 单一职责：一个 Skill 只做一件事
2. 明确的触发条件：在 SKILL.md 中写清楚触发关键词
3. 最小权限：只暴露必要的工具
4. 充分的文档：SKILL.md 就是文档本身

---

常见问题

!!! question "如何切换模型？" 在 Control UI 的"模型"页面或直接编辑 config.yaml 中的 model 配置即可。

!!! question "技能加载失败怎么办？" 检查 SKILL.md 格式是否正确，技能目录是否在 skills 配置路径下。运行 openclaw logs 查看错误日志。

!!! question "记忆文件占用空间太大？" 定期清理 memory/ 目录中的旧文件，或在 MEMORY.md 中做摘要后删除原始日志。

---

参考资源

• 官方文档：https://docs.openclaw.dev
• GitHub 仓库：https://github.com/openclaw
• MCP 协议：https://modelcontextprotocol.io
• MkDocs Material：https://squidfunk.github.io/mkdocs-material

---

最后更新：2026-06-03