手把手教你OpenClaw入门：从零开始打造你的专属AI助理

2026-03-05

想拥有一个24小时待命的私人AI助理，既能帮你处理工作琐事，又能保护你的隐私数据？今天带你认识一个强大的开源框架——OpenClaw。

摘要：OpenClaw是一个开源的个人AI助理框架，支持多平台消息接入、工具调用、技能扩展。本文将从安装到实战，一步步带你完成OpenClaw的配置和使用。

📌 写在前面

在ChatGPT、Claude等AI服务日益普及的今天，你是否遇到过这样的困扰：

❌ 对话记录被上传到云端，隐私堪忧
❌ 想让AI帮你操作本地文件，却无能为力
❌ 想在不同平台（微信、Telegram、Slack）都能用同一个AI助理

OpenClaw 正是为解决这些痛点而生的本地AI助理框架。

一、OpenClaw是什么？

OpenClaw是一个本地优先的个人AI助理框架，核心特点是：

特性	说明
多平台支持	支持WhatsApp、Telegram、Slack、Discord、飞书等20+平台 ¹
本地运行	所有数据存储在本地，隐私可控
工具调用	支持文件操作、网页浏览、代码执行等
技能扩展	通过YAML文件定义新技能，无需修改核心代码
多模型支持	支持OpenAI、Anthropic、Google等主流LLM

适用场景：

📅 个人日常助理（日程管理、信息检索）
🔄 自动化工作流（邮件处理、报告生成）
💻 开发调试（代码审查、测试辅助）
🔐 隐私敏感场景（本地运行，数据可控）

💡 小贴士：OpenClaw的核心理念是”本地优先”——你的对话记录、文件操作都保存在本地，只有AI推理需要调用云端API。

二、环境准备 🛠️

2.1 系统要求

根据官方文档 ²，OpenClaw需要：

Node.js: 版本 22 或更高
操作系统: macOS、Linux、Windows (通过WSL2)
内存建议: 至少 4GB 可用内存

检查Node版本：

node --version
# 输出应该 >= v22.0.0

⚠️ 注意：如果你的Node版本过低，可以通过 nvm（Node Version Manager）快速升级：
nvm install 22
nvm use 22

2.2 安装方式

方式一：一键安装脚本（推荐） ²

macOS/Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell（以管理员身份运行）:

iwr -useb https://openclaw.ai/install.ps1 | iex

方式二：通过npm安装

npm install -g openclaw@latest
# 或使用 pnpm（更快）
pnpm add -g openclaw@latest

🔐 安全提示：安装前可以先查看脚本内容，确保安全：
curl -fsSL https://openclaw.ai/install.sh | less

三、快速开始：5分钟上手 🚀

3.1 运行配置向导

安装完成后，运行配置向导 ³：

openclaw onboard --install-daemon

💡 参数说明：--install-daemon 会将OpenClaw安装为系统服务，开机自动启动。如果不想安装为服务，可以去掉这个参数。

向导会依次引导你完成：

步骤	配置项	说明
1️⃣	模型配置	选择AI模型（OpenAI、Claude、Gemini等）
2️⃣	工作空间设置	默认位置：`~/.openclaw/workspace`
3️⃣	Gateway配置	端口：18789
4️⃣	消息通道（可选）	Telegram、WhatsApp、飞书等
5️⃣	守护进程安装	开机自启动配置

📝 配置文件位置：所有配置保存在 ~/.openclaw/openclaw.json，后续可手动修改。

3.2 启动Gateway

如果安装了守护进程，Gateway应该已经在运行：

openclaw gateway status

手动启动Gateway：

openclaw gateway --port 18789

3.3 打开控制面板

最简单的测试方式是通过Web界面 ⁴：

openclaw dashboard

浏览器会自动打开 http://127.0.0.1:18789/，你可以在WebChat中与AI助理对话。

四、核心概念解析

4.1 架构概览

OpenClaw采用微内核架构，主要由以下组件构成 ⁵：

系统架构

层级	说明	组件
用户界面层	Web、桌面、移动端	WebChat / macOS App / CLI / Mobile
Gateway控制层	WebSocket控制平面	ws://127.0.0.1:18789
消息通道层	多平台消息接入	WhatsApp / Telegram / Slack / Discord / 飞书…
技能层	工具与能力扩展	内置技能 / 社区技能 / 自定义技能
模型层	AI能力提供	OpenAI / Anthropic / Google / 本地模型

4.2 关键配置文件

配置文件位于 ~/.openclaw/ 目录：

文件/目录	用途
`openclaw.json`	主配置文件（模型、通道等）
`credentials/`	存储API密钥和认证信息
`workspace/`	工作空间（记忆、技能等）

最小配置示例 ⁶：

{
  "agent": {
    "model": "openai/gpt-4o"
  }
}

4.3 会话与记忆

OpenClaw的会话模型 ⁷：

Main Session: 主会话，直接与用户交互
Isolated Session: 隔离会话，用于处理群组消息
Memory: 分为短期记忆（当前会话）和长期记忆（持久化）

五、配置消息通道

5.1 Telegram配置（推荐新手）

Telegram是最容易配置的平台之一：

步骤1：创建机器人

在Telegram中搜索 @BotFather
发送 /newbot 命令
按提示设置机器人名称
保存返回的Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

步骤2：配置OpenClaw

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "channels": {
    "telegram": {
      "botToken": "你的Bot Token"
    }
  }
}

步骤3：重启Gateway

openclaw gateway restart

步骤4：测试

在Telegram中找到你的机器人，发送任意消息，首次会收到配对请求。

5.2 飞书配置（适合国内用户）

⚠️ 注意：飞书配置相对复杂，需要企业账号或开发者账号。

配置步骤：

登录飞书开放平台
创建企业自建应用，获取 App ID 和 App Secret
配置权限：
- im:message – 接收消息
- im:message:send_as_bot – 发送消息
- im:chat – 访问群组信息
设置事件订阅地址（需要公网IP或内网穿透）

💡 替代方案：国内用户也可以使用微信（通过企业微信API）或钉钉，配置方式类似。

5.3 配对机制（安全重要）

默认情况下，OpenClaw使用配对机制保护你的隐私 ⁹：

陌生用户发送消息时，会收到配对码
只有你批准的用户才能与AI助理对话
批准命令：openclaw pairing approve <sender-id>

六、使用技能扩展功能

6.1 什么是技能？

技能是OpenClaw的扩展机制，通过YAML文件定义工具和能力 ¹⁰。

6.2 内置技能

OpenClaw内置了多种实用技能：

技能	功能
`web_search`	网络搜索（需要Brave API Key）
`web_fetch`	网页内容提取
`browser`	浏览器控制
`file`	文件读写操作
`exec`	命令执行

6.3 安装社区技能

从ClawHub安装社区技能 ¹¹：

openclaw skill install <skill-name>

6.4 创建自定义技能

在 ~/.openclaw/workspace/skills/ 目录创建技能：

# my-skill/SKILL.md
---
id: my-custom-skill
name: 我的自定义技能
description: 一个简单的示例技能
version: 1.0.0
---

## 功能说明

这个技能可以帮助用户...

## 使用方法

用户可以说："帮我..."

七、实战示例 💡

7.1 示例1：网络搜索与总结

在WebChat中输入：

帮我搜索一下2024年AI行业最新动态，并总结成3个要点

AI助理响应示例：

根据搜索结果，2024年AI行业的主要动态包括：

1. 多模态模型成为主流
   GPT-4V、Gemini Ultra等多模态模型支持图文混合理解

2. 开源模型快速进步
   Llama 3、Mistral等开源模型性能接近商业模型

3. AI Agent兴起
   自主规划、工具调用的Agent应用开始落地

[来源：各科技媒体综合报道]

7.2 示例2：文件操作与处理

帮我读取 ~/Documents/notes.md 文件内容，并提取其中的待办事项

AI助理会：

调用文件读取工具获取内容
分析并提取所有 TODO 或 - [ ] 格式的待办事项
整理成清单返回

7.3 示例3：代码审查

帮我审查当前目录下的 src/main.py 文件，检查潜在的安全问题

AI助理可以：

读取代码文件
分析常见安全漏洞（SQL注入、XSS等）
提供修复建议

7.3 示例3：定时任务

配置定时简报（Cron） ¹²：

{
  "cron": {
    "jobs": [
      {
        "id": "morning-briefing",
        "schedule": "0 8 * * *",
        "action": "agentTurn",
        "message": "生成今日早间简报"
      }
    ]
  }
}

八、常见问题

Q1: 如何切换AI模型？

编辑配置文件或使用命令 ¹³：

openclaw configure --section models

Q2: 如何更新OpenClaw？

openclaw update --channel stable

Q3: Gateway无法启动怎么办？

检查端口占用：

lsof -i :18789

运行诊断：

openclaw doctor

Q4: 如何查看日志？

openclaw logs --tail 100

九、进阶资源

官方资源

官网: https://openclaw.ai
文档: https://docs.openclaw.ai
GitHub: https://github.com/openclaw/openclaw
社区: Discord | ClawHub技能市场

学习路径

入门: 完成配置向导，熟悉WebChat界面
进阶: 配置消息通道，实现多平台接入
高级: 编写自定义技能，扩展AI能力
专家: 参与社区贡献，开发新功能

十、总结 🎯

OpenClaw是一个强大且灵活的个人AI助理框架。通过本文的介绍，你应该已经掌握了：

✅ OpenClaw的基本概念和架构
✅ 从安装到配置的完整流程
✅ 消息通道的配置方法
✅ 技能扩展的使用方式
✅ 常见问题的解决方案

📚 学习路径建议

阶段	时间	学习内容
入门	1-2天	完成基础安装配置 / 熟悉WebChat界面 / 尝试基本对话功能
进阶	1周	配置消息通道 / 探索内置技能 / 了解工具调用机制
高级	持续	编写自定义技能 / 配置自动化任务 / 参与社区贡献

下一步行动：