OpenClaw 入门教程：从安装到搭建个人 AI 助手，一篇看懂核心用法

说明：本文基于 OpenClaw 官方文档与公开免费教程资料整理。原始资料只作为参考，正文已重新组织为更适合新手阅读的实操指南。

OpenClaw 是什么？适合谁用？

OpenClaw 可以理解为一个自托管 AI Agent 网关。它不只是让你在网页里和模型聊天，而是把模型、工具、聊天渠道、文件工作区、定时任务和多智能体会话连接到一起，让 AI 能在受控环境里帮你执行实际任务。

如果你只是偶尔问几个问题，普通网页版 AI 已经够用；但如果你想要一个长期运行的个人助手，比如接入 Telegram、Slack、飞书、WhatsApp 或 WebChat，帮你整理资料、执行命令、调用搜索、管理文件、定时检查事项，那么 OpenClaw 会更合适。

一、安装前准备

• Node.js：官方文档推荐 Node 24，也支持 Node 22.16+。安装前可用 node --version 检查版本。
• 模型 API Key：可准备 OpenAI、Anthropic、Google 或兼容 OpenAI 协议的模型服务。
• 运行环境：macOS / Linux 体验最顺；Windows 可以原生运行，但更推荐 WSL2。
• 安全意识：OpenClaw 可能具备读写文件、执行命令、连接聊天渠道的能力，建议先从本机和私有渠道开始，不要一上来开放给陌生人使用。

二、快速安装 OpenClaw

macOS / Linux 可使用官方安装脚本：

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

Windows PowerShell 可使用：

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

安装完成后，运行新手引导：

openclaw onboard --install-daemon

这个向导会引导你选择模型提供商、输入 API Key，并配置 Gateway。官方文档给出的预期是几分钟内完成基础可用状态。

三、确认 Gateway 正常运行

OpenClaw 的核心后台服务是 Gateway。它负责接收消息、路由会话、调用模型和工具。安装引导完成后，可用下面命令检查：

openclaw gateway status

正常情况下，Gateway 会监听本地端口，例如 18789。随后可以打开控制面板：

openclaw dashboard

浏览器中的 Control UI 能打开，并且你可以发送第一条消息获得回复，就说明基础链路跑通了。

四、理解 OpenClaw 的几个核心目录

OpenClaw 的配置和记忆通常集中在 ~/.openclaw/ 目录。新手最需要认识这几个位置：

路径	用途
~/.openclaw/openclaw.json	主配置文件，包含 Gateway、模型、渠道等设置。
~/.openclaw/workspace/	默认工作区，存放 SOUL、USER、MEMORY、AGENTS、TOOLS 等文件。
~/.openclaw/agents/	不同 Agent 的状态、会话和凭据目录。
~/.openclaw/skills/	共享 Skills 安装位置。
/tmp/openclaw/	常见运行日志位置，排查问题时很有用。

其中 workspace 可以看作 AI 助手的“工作台”和“记忆本”。如果你希望助手长期稳定服务，建议把这个目录做私有备份，必要时用 Git 管理，但不要公开包含隐私和密钥的文件。

五、让 OpenClaw 更像个人助手

基础安装完成后，可以继续调整这些文件：

• SOUL.md：定义助手的语气、性格和工作风格。
• USER.md：记录你的常用偏好、工作背景和协作方式。
• MEMORY.md：长期记忆，适合写入稳定偏好、重要项目和决策。
• AGENTS.md：工作区规则，告诉 Agent 每次启动时该读什么、哪些事情能做、哪些事情要先问。
• HEARTBEAT.md：定期检查清单，适合邮件、日历、服务器状态等轻量巡检任务。

新手建议先少量修改，不要一开始就写很复杂的规则。等日常使用中发现固定流程，再逐步沉淀到工作区文件里。

六、Skills：让助手学会专项工作流

OpenClaw 的 Skills 是一种说明型能力包。每个 Skill 通常是一个文件夹，里面有 SKILL.md，用于告诉 Agent 在某类任务中应该遵循什么流程、使用什么工具、注意哪些限制。

官方文档说明，Skills 可以来自工作区、项目智能体、个人智能体、共享目录或内置包。优先级大致是：工作区 Skills 优先，其次才是共享和内置 Skills。因此，如果你有自己的业务流程，放在工作区 Skills 里最容易覆盖默认行为。

一个简单的 Skill 至少需要包含名称和描述，例如：

---
name: my-workflow
description: 用于处理我的固定工作流
---

# 使用说明
当用户要求处理某类任务时，先检查输入，再按步骤执行。

需要注意：第三方 Skills 应当视为不可信内容。启用前建议先读一遍，涉及命令执行、文件读写、外部 API 的 Skill 更要谨慎。

七、多渠道和多 Agent 怎么理解？

OpenClaw 的一个优势是多渠道接入。官方文档提到，它可以连接 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等渠道。你可以先用 WebChat 或 Control UI 测试，稳定后再接入常用聊天工具。

公开教程里也有人把 OpenClaw 配成多 Agent 团队，例如一个负责规划、一个负责开发、一个负责营销、一个负责业务分析。这个思路适合长期项目，但新手不必一开始就搭四五个 Agent。更稳妥的路线是：

1. 先跑通一个主助手。
2. 把模型、工作区和常用渠道调稳定。
3. 再把开发、写作、运维、资料整理等任务拆给不同 Agent。

八、安全建议：先保守，再开放

OpenClaw 越强大，越需要明确边界。建议新手至少做到：

• 不要把包含 API Key、Token、账号密码的配置文件公开到 GitHub。
• 聊天渠道要设置允许名单，避免陌生人直接驱动你的 Agent。
• 涉及发消息、发文章、删文件、改配置、重启服务等动作，建议保留人工确认。
• 初期可以关闭或放慢 Heartbeat，确认规则可靠后再开启主动巡检。
• 定期查看 /tmp/openclaw/ 日志，遇到异常先看 Gateway 状态和错误信息。

九、新手推荐学习路线

1. 第一天：完成安装、onboard、dashboard 和第一条消息。
2. 第二步：整理自己的 SOUL.md、USER.md 和 AGENTS.md。
3. 第三步：接入一个最常用渠道，比如 Telegram、Slack、飞书或 WebChat。
4. 第四步：写一个自己的 Skill，让助手学会一个固定工作流。
5. 第五步：再尝试 Cron、Heartbeat、多 Agent、移动端节点等高级能力。

参考资料

• OpenClaw 官方文档《入门指南》：https://docs.openclaw.ai/zh-CN/start/getting-started
• OpenClaw 官方文档《个人助理设置》：https://docs.openclaw.ai/zh-CN/start/openclaw
• OpenClaw 官方文档《Skills》：https://docs.openclaw.ai/zh-CN/tools/skills
• 菜鸟教程《OpenClaw 配置目录》：https://www.runoob.com/ai-agent/openclaw-setup.html
• 博客园公开文章《如何使用 OpenClaw 搭建一个 AI 代理团队：新手教程》：https://www.cnblogs.com/gyc567/p/19686827

最后总结：OpenClaw 的价值不在于“又多一个聊天界面”，而在于把模型、工具、工作区、渠道和自动化任务串起来。新手最重要的是先跑通 Gateway 和工作区，再逐步加入 Skills、多渠道和定时任务。这样既容易成功，也更安全。