Skip to content

2026 年最全中文 OpenClaw 教程:从零搭建你的 AI 智能体

不写 Hello World,直接上实战。本文涵盖安装、配置、技能开发、多渠道接入全流程。

什么是 OpenClaw?

OpenClaw(AGI 智能体) 是一个开源的 AI Agent 框架,让你把大语言模型变成真正能干活的 AI 助手

不是聊天框里的一问一答,而是:

  • 📁 操作你的文件系统
  • 📧 收发邮件和消息
  • 🌐 自动化浏览器操作
  • 🔧 执行代码和脚本
  • 📅 管理日历和待办

一句话总结:OpenClaw = AI 的大脑 + 手脚。

为什么选 OpenClaw?

对比ChatGPT 网页版其他 Agent 框架OpenClaw
本地模型支持部分✅ Ollama 原生
中文优化一般✅ 中文生态完善
技能扩展插件式✅ 70+ 技能包
多渠道仅网页有限✅ 飞书/微信/Discord/Slack
隐私云端看实现✅ 完全本地可控
免费$20/月部分免费✅ 开源免费

安装(3 步搞定)

前置要求

  • Node.js 18+
  • 一个大模型 API(本地 Ollama 或云端 API)

第一步:安装

bash
npm install -g openclaw

第二步:初始化

bash
openclaw init

这会在 ~/.openclaw-autoclaw/ 下创建工作目录:

~/.openclaw-autoclaw/
├── workspace/          # 工作空间(你的文件)
├── config.json         # 主配置
├── openclaw.json       # 模型和渠道配置
├── skills/             # 自定义技能包
└── memory/             # 记忆文件

第三步:启动

bash
openclaw start

启动后访问 http://localhost:18789/openclaw 打开控制面板。

配置本地模型(Qwen3.5)

编辑 ~/.openclaw-autoclaw/openclaw.json,在 models.providers 中添加:

json
{
  "custom-local": {
    "baseUrl": "http://127.0.0.1:11434/v1",
    "apiKey": "ollama",
    "api": "openai-completions",
    "models": [
      {
        "id": "qwen3.5:9b",
        "name": "Qwen3.5-9B 本地",
        "contextWindow": 131072,
        "maxTokens": 8192
      }
    ]
  }
}

保存后重启 OpenClaw 即可使用。

核心概念速懂

技能包(Skills)

技能包是 OpenClaw 的"能力模块"。每个技能包解决一类问题:

分类技能包示例用途
飞书feishu-doc、feishu-bitable、feishu-calendar文档、表格、日历
浏览器autoglm-browser-agent自动化网页操作
搜索autoglm-websearch联网搜索
内容blog-writer、copywriting写作
开发code、git-essentials编程
媒体ffmpeg-video-editor、vidu-skills视频/图片

会话(Session)

每次对话是一个 Session。OpenClaw 支持:

  • 主会话:你和 AI 的直接对话
  • 子代理(Subagent):AI 派出的"分身",独立完成任务后汇报
  • 持久会话:跨天保持上下文

记忆(Memory)

OpenClaw 有三层记忆:

  1. MEMORY.md —— 长期记忆(核心事实、偏好)
  2. memory/YYYY-MM-DD.md —— 每日日志
  3. 会话历史 —— 当前对话上下文

接入飞书(国内最实用的渠道)

1. 创建飞书应用

  1. 访问 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 开启「机器人」能力

2. 配置权限

在 openclaw.json 的 channels.feishu 中配置:

json
{
  "feishu": {
    "enabled": true,
    "appId": "你的App ID",
    "appSecret": "你的App Secret",
    "domain": "feishu",
    "connectionMode": "websocket"
  }
}

3. 设置消息接收

在飞书开放平台中:

  • 配置事件订阅地址为你的服务器地址
  • 添加 im.message.receive_v1 权限
  • 设置允许发送消息的用户列表

配置完成后,你就可以在飞书中直接和 AI 对话了!

实战:让 AI 帮你管工作

场景 1:自动整理文件

在飞书中对 AI 说:

帮我把 Downloads 目录里的文件按类型分类整理一下

AI 会自动:

  1. 扫描 Downloads 目录
  2. 识别文件类型(文档、图片、视频等)
  3. 创建分类文件夹
  4. 移动文件到对应目录
  5. 回报整理结果

场景 2:监控网站状态

帮我检查 siliconagi.cn 是否正常访问

AI 会执行 curl 请求并返回 HTTP 状态码。

场景 3:写文章并发布

帮我写一篇关于 Mac Mini 跑大模型的教程

AI 可以:

  1. 搜索最新资料
  2. 撰写文章内容
  3. 生成 HTML/Markdown
  4. (配置好部署后)直接发布到网站

自定义技能开发

如果现有技能包不够用,你可以自己写:

技能包结构

my-skill/
└── SKILL.md    # 技能说明文件(必须)

SKILL.md 示例

markdown
---
name: my-skill
description: 我的自定义技能
---

# 我的技能

当用户提到 XXX 时使用此技能。

## 使用方法
...

把技能包放到 ~/.openclaw-autoclaw/skills/ 目录下即可被自动发现。

性能优化

1. 模型选择策略

场景推荐模型原因
日常对话Qwen3.5:9B 本地免费、快速
复杂推理GLM-4.7-Flash免费云端、能力强
图像识别GLM-5V-Turbo多模态
重度任务GLM-5 / GLM-5.1最强能力

2. 内存管理(Mac Mini 16GB)

  • 关闭不用的浏览器标签页
  • 复杂任务拆分成小步骤
  • 避免同时加载多个大模型
  • 定期清理 Ollama 缓存:rm -rf ~/.ollama/models/blob-v1/*

3. 启动项优化

让 Ollama 和 OpenClaw 开机自启:

bash
# Ollama
brew services start ollama

# OpenClaw(通过 launchd 或登录项添加)

常见问题

Q:OpenClaw 支持哪些模型?

A:任何兼容 OpenAI API 格式的模型都支持,包括 Ollama 本地模型、智谱、OpenAI、Claude 等。

Q:数据安全吗?

A:如果你用本地模型(Ollama),数据完全不出本机。如果用云端 API,数据会经过对应服务商。

Q:能同时接多个聊天渠道吗?

A:可以!飞书、微信、Discord、Slack 等可以同时在线。

Q:免费吗?

A:OpenClaw 框架本身免费开源。模型费用取决于你用的模型——本地模型免费,云端模型按量付费。

总结

OpenClaw 让 AI 从"聊天工具"变成了"数字员工"。配合 Mac Mini + Qwen3.5,你可以用极低的成本拥有一个 7×24 在线的 AI 智能体。

🦞 本文是「智能体」系列教程的第一篇。 下一篇:飞书深度集成指南 —— 让 AI 真正融入你的工作流。