guide beginner tutorial installation

OpenClaw 入门:15 分钟从零搭建你的第一个 AI 代理

OpenClaws.io Team

OpenClaws.io Team

@openclaws

2026年3月6日

7 分钟

OpenClaw 入门:15 分钟从零搭建你的第一个 AI 代理

OpenClaw 是什么?

OpenClaw 是一个运行在你自己电脑上的开源 AI 代理。与运行在云端且只能聊天的 ChatGPT 或 Claude.ai 不同,OpenClaw 运行在你的设备上,可以行动——管理文件、发送消息、浏览网页、控制智能家居设备,以及按计划运行自动化任务。

你可以通过已有的聊天应用与它交互:WhatsApp、Telegram、Discord、Slack、iMessage 等。它始终在线、持续学习,完全属于你。

你需要什么

  • 一台电脑:Mac、Windows(需要 WSL2)或 Linux。树莓派也可以。
  • Node.js 22 或更高版本:OpenClaw 运行在 Node.js 上。
  • 一个 AI API 密钥:来自 Anthropic(Claude)、OpenAI(GPT),或通过 Ollama 使用本地模型。
  • 10 分钟:真的只需要这么多时间。

第一步:安装 Node.js

如果你还没有 Node.js 22+,通过 nvm(Node 版本管理器)安装:

bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22

验证:node --version 应显示 v22.x.x 或更高版本。

第二步:安装 OpenClaw

bash
npm install -g openclaw@latest

或使用 pnpm:

bash
pnpm add -g openclaw@latest

验证:openclaw --version 应输出已安装的版本号。

第三步:运行引导向导

bash
openclaw onboard --install-daemon

向导会引导你完成以下步骤:

  1. 1.API 密钥设置:粘贴你的 Anthropic 或 OpenAI API 密钥。如果想使用本地模型,可以稍后配置 Ollama。
  2. 2.聊天平台:选择首先连接哪个聊天应用。WhatsApp 是最热门的选择——你需要扫描一个二维码来关联账户。
  3. 3.守护进程安装:守护进程确保 OpenClaw 在后台持续运行,即使关闭终端也不会停止。

第四步:打个招呼

打开已连接的聊天应用(WhatsApp、Telegram 等),给你的代理发一条消息:

> 你好!你能做什么?

你的代理会回复一份能力概览。试试以下操作:

  • "东京现在几点?"
  • "帮我总结这篇文章:[粘贴一个链接]"
  • "明天下午 6 点提醒我给妈妈打电话"
  • "搜索一下最新的 OpenClaw 版本"

第五步:自定义你的代理

设置它的性格

编辑 ~/.openclaw/agents/default/SOUL.md 来定义代理的语气和规则。例如:

markdown
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.

安装技能

技能是赋予代理新能力的插件:

bash
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration

ClawHub 市场 浏览可用技能。

访问 Web 界面

OpenClaw 附带一个本地 Web 管理面板:

bash
openclaw ui

这会打开一个浏览器界面,你可以在这里查看对话历史、管理技能、监控代理活动和调整设置。

了解架构

你(手机/电脑)
    |
    v
聊天平台(WhatsApp、Telegram、Discord...)
    |
    v
OpenClaw 网关(运行在你的设备上)
    |
    v
AI 模型(Claude、GPT、Ollama 等)
    |
    v
技能和工具(文件系统、网络、API、智能家居...)

你的消息从聊天应用流向运行在你设备上的 OpenClaw 网关。网关将消息发送给 AI 模型进行推理,然后通过已安装的技能执行相应操作。响应沿着相同路径返回。

除了 AI 模型推理之外,一切都在本地运行(除非你使用 Ollama 进行本地模型推理)。

第一周常见问题

"为什么代理回复很慢?" 冷启动后的第一次回复需要几秒钟,因为 AI 模型需要加载上下文。同一对话中的后续消息会更快。如果持续很慢,请检查你到 AI 服务商的网络连接。

"这要花多少钱?" 轻度使用(每天几次对话)的 API 费用通常为 $10-30/月。你可以通过对简单任务使用 Claude Haiku 或本地模型来大幅降低成本。

"可以同时连接多个聊天应用吗?" 可以。OpenClaw 可以同时连接 WhatsApp、Telegram、Discord 和其他平台。来自所有平台的消息由同一个代理处理。

"安全吗?" OpenClaw 运行在你的设备上,所有数据由你掌控。保持更新、安装前审查技能,并遵循 docs.openclaw.ai/security 上的安全指南。

下一步

欢迎加入 OpenClaw 社区。你的龙虾已经准备好了。

订阅更新

第一时间获取新功能和玩法。放心,不会发垃圾邮件。