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)
第一步:安装
npm install -g openclaw第二步:初始化
openclaw init这会在 ~/.openclaw-autoclaw/ 下创建工作目录:
~/.openclaw-autoclaw/
├── workspace/ # 工作空间(你的文件)
├── config.json # 主配置
├── openclaw.json # 模型和渠道配置
├── skills/ # 自定义技能包
└── memory/ # 记忆文件第三步:启动
openclaw start启动后访问 http://localhost:18789/openclaw 打开控制面板。
配置本地模型(Qwen3.5)
编辑 ~/.openclaw-autoclaw/openclaw.json,在 models.providers 中添加:
{
"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 有三层记忆:
- MEMORY.md —— 长期记忆(核心事实、偏好)
- memory/YYYY-MM-DD.md —— 每日日志
- 会话历史 —— 当前对话上下文
接入飞书(国内最实用的渠道)
1. 创建飞书应用
- 访问 飞书开放平台
- 创建企业自建应用
- 获取 App ID 和 App Secret
- 开启「机器人」能力
2. 配置权限
在 openclaw.json 的 channels.feishu 中配置:
{
"feishu": {
"enabled": true,
"appId": "你的App ID",
"appSecret": "你的App Secret",
"domain": "feishu",
"connectionMode": "websocket"
}
}3. 设置消息接收
在飞书开放平台中:
- 配置事件订阅地址为你的服务器地址
- 添加
im.message.receive_v1权限 - 设置允许发送消息的用户列表
配置完成后,你就可以在飞书中直接和 AI 对话了!
实战:让 AI 帮你管工作
场景 1:自动整理文件
在飞书中对 AI 说:
帮我把 Downloads 目录里的文件按类型分类整理一下
AI 会自动:
- 扫描 Downloads 目录
- 识别文件类型(文档、图片、视频等)
- 创建分类文件夹
- 移动文件到对应目录
- 回报整理结果
场景 2:监控网站状态
帮我检查 siliconagi.cn 是否正常访问
AI 会执行 curl 请求并返回 HTTP 状态码。
场景 3:写文章并发布
帮我写一篇关于 Mac Mini 跑大模型的教程
AI 可以:
- 搜索最新资料
- 撰写文章内容
- 生成 HTML/Markdown
- (配置好部署后)直接发布到网站
自定义技能开发
如果现有技能包不够用,你可以自己写:
技能包结构
my-skill/
└── SKILL.md # 技能说明文件(必须)SKILL.md 示例
---
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 开机自启:
# 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 真正融入你的工作流。