什么是OpenClaw？

OpenClaw 是一个构建能够使用工具、维护内存并自主运行的人工智能代理的框架。可以把它看作是你AI代理的操作系统——它负责编排循环、工具管理和会话处理，让你可以专注于定义代理的实际功能。

OpenClaw 与其他代理框架的不同之处：

• 配置优先方法：用简单的markdown文件（尤其是markdown）定义你的代理个性、能力和规则SOUL.md )
• 内置工具生态系统：网页搜索、文件操作、浏览器控制、消息传递等——开箱即用
• 内存管理：自动短期和长期记忆，并附有每日日志
• 多渠道支持：将你的代理部署到聊天平台、CLI或API端点
• 节点系统：通过配对系统将您的代理连接到设备和服务

前提条件

在开始这个 OpenClaw 教程之前，请确保你具备：

• Node.js v18+安装（推荐v22）
• 一个终端（macOS终端、Windows终端，或任何Linux壳）
• 来自大型语言模型提供商的API密钥
• 对命令行的基本熟悉

步骤1：安装OpenClaw（5分钟）

打开终端，全局安装 OpenClaw：

npm install -g openclaw

确认安装情况：

openclaw --version

你应该会看到打印出来的版本号。如果出现“找不到命令”错误，确保你的npm全局bin目录在你的PATH里。

接下来，初始化你的工作区：

openclaw init my-first-agent

cd my-first-agent

这会创建一个具有以下结构的工作区目录：

步骤2：用 SOUL.md 配置您的代理身份（5分钟）

这个文件是你OpenClaw代理的核心。它定义了你的代理人是谁，它的行为方式，以及它能做什么。这正是OpenClaw配置优先理念真正闪耀的地方。SOUL.md

在编辑器中打开：SOUL.md

nano SOUL.md

这里有一个研究助理代理人的入门模板：

保存文件。这是你代理人的个性和操作手册

步骤3：设置你的LLM提供者（3分钟）

OpenClaw 需要一个大型语言模型来驱动你的代理推理。配置您的API密钥：

openclaw config set llm.provider anthropic
openclaw config set llm.api key YOUR API KEY HERE
openclaw config set llm.model claude-sonnet-4-20250514

步骤4：为你的代理人添加工具（5分钟）

工具赋予你的代理人互动的能力。OpenClaw 内置了多个工具。让我们支持我们的研究助理所需的设备。

编辑你的工作区配置：

openclaw tools enable web search
openclaw tools enable web fetch
openclaw tools enable read
openclaw tools enable write

现在你的代理人可以：

• web_search: 使用 Brave Search API 进行互联网搜索
• web_fetch: 从任意网址提取可读内容
• read: 阅读本地文件
• write: 创建并编辑本地文件

步骤5：配置内存（3分钟）

记忆力让你的代理人在对话中记住事情。OpenClaw 通过两种机制处理此事：

每日记忆日志（）：自动记录每日互动和决策。memory/YYYY-MM-DD.md

长期记忆（）：经纪元每次会话引用的经过整理的持续信息。MEMORY.md

设置内存目录：

mkdir -p memory

OpenClaw 在每次会话开始时自动读取今天和昨天的内存文件，确保你的代理在对话中保持连续性。

步骤6：启动您的代理（2分钟）

一切都已配置好。让我们先从代理开始：

openclaw gateway start

这启动了OpenClaw网关守护进程。现在与你的经纪人互动：

openclaw chat

步骤7：部署到聊天频道（7分钟）

在终端中运行代理很适合测试，但真正的威力在于将其部署到消息平台，让你（或你的团队）能够自然地与它互动。

OpenClaw 支持多频道。以下是连接常见设备的方法：

openclaw channel add feishu --app-id YOUR APP ID --app-secret YOUR APP SECRET

启动网关时支持通道：

openclaw gateway restart

你的代理现在已经在你选定的平台上在线，用你配置的个性、工具和内存回复消息。

结论

本 OpenClaw 教程涵盖了基础知识：安装、代理身份配置、工具设置、内存管理和部署。只需30分钟，你就从无到有变成了一个能在网络上搜索、处理信息并在会话间保持记忆的AI代理。SOUL.md

真正的学习现在才开始。你构建的每一个代理都会教会你关于提示设计、工具集成以及赋予AI适当自主权的艺术新知识。从简单开始，经常测试，让你的代理根据实际使用情况不断进化。