🦞 OpenClaw V3 新手入门指南

一份为你精简提炼的"保姆级"新手指南,从零基础到成功安装、接入飞书、学会用技能

🎯 OpenClaw 到底是什么

一句话解释

OpenClaw 是一个 AI 智能体平台,让你能在自己的电脑上运行 AI 助理,并把它接入到你日常使用的工具里——比如飞书、Telegram。

🤖

想象一下

你招了一个实习生,这个实习生特别聪明,能帮你查资料、写文档、整理数据,还能 24 小时在线。但你不需要给它交社保,也不用担心它跳槽。

OpenClaw 就是这个实习生,只不过它住在你的电脑里。

核心概念速览

Agent(智能体)

能自主执行任务的 AI 程序,就像一个带工具箱的实习生

Gateway(网关)

系统的总调度室,负责消息路由和协调

Channel(渠道)

连接各种聊天平台的接口,比如飞书、Telegram

Tool(工具)

Agent 能调用的具体功能,比如读写文件、执行命令

Skill(技能)

告诉 Agent 什么时候用什么工具的"说明书"

它能做什么?

📝 自动整理日报

从项目群提取关键进展,从邮件提取待跟进事项,自动生成日报

🔍 查资料写报告

调用搜索工具查找资料,访问多个网页提取信息,整理成结构化表格

💬 飞书里@它办事

在群里@机器人处理文件翻译、格式转换等任务,在聊天中就把事办了

📋 准备工作:你只需要这三样东西

很多技术书一上来就列一堆要求,看得人想放弃。咱们换个方式:

你只需要三样东西:

  1. 一台能上网的电脑(Windows/Mac/Linux 都行)
  2. 一个 API Key(别被这个词吓到,就是一串密码)
  3. 10 分钟时间(和一点点耐心)

没了。不需要你是程序员,不需要你懂 AI,不需要买服务器。

系统要求

系统 要求 备注
macOS 近 5 年机型 Intel 和 Apple Silicon 都支持
Windows Windows 10+ 推荐用 WSL2
Linux 主流发行版 Ubuntu/Debian/CentOS/Fedora

🔑 获取 API Key

API Key 是什么?

API Key 其实就是一串密码,就像:

  • 饭店的 VIP 卡 → 证明你有资格享受服务
  • 小区的门禁卡 → 证明你有权限进入
  • API Key → 证明你有权限调用 AI 服务

国内三家 Coding Plan(推荐)

1

方案 A:KIMI Coding Plan(推荐)

申请步骤:

  1. 访问 https://www.kimi.com/code
  2. 登录/注册 KIMI 账号
  3. 点击"订阅 Coding Plan"
  4. 完成支付(支持支付宝/微信)
  5. 进入控制台,点击"创建 API Key"
  6. 复制生成的 Key(以 sk- 开头)

💡 Key 创建后只显示一次,务必保存好。如果丢了,只能重新创建。

2

方案 B:MiniMax Coding Plan(推荐)

申请步骤:

  1. 访问 MiniMax 平台
  2. 注册/登录账号
  3. 完成实名认证(需要身份证)
  4. 订阅 Coding Plan
  5. 进入"API 管理"页面
  6. 创建 API Key 并复制
3

方案 C:GLM Coding Plan(推荐)

申请步骤:

  1. 访问 https://bigmodel.cn/glm-coding
  2. 注册/登录智谱 AI 账号
  3. 进入控制台
  4. 点击"API Keys"菜单
  5. 创建新的 API Key
  6. 复制保存

三家对比

特性 KIMI MiniMax GLM
月费 49/99/199/699 元 29/49/119 元 49/149/469 元
访问 无需代理 无需代理 无需代理
支付 支付宝/微信 支付宝/微信 支付宝/微信

⚠️ 保存 Key 的建议

不要:

  • 直接保存在微信/QQ 聊天记录里
  • 截图保存在相册里

推荐:

  • 密码管理器(1Password、Bitwarden 等)
  • 本地文本文件(放在安全的位置)
  • 备忘录(如果支持加密)

🚀 极速安装(5 分钟把神兽接回家)

1

检查 Node.js 版本

打开你的终端(Terminal),输入:

检查 Node.js
node --version
npm --version

判断标准:

  • ✅ 版本 >= v22:可以继续
  • ❌ 版本 < v22:需要升级
  • ❌ 提示"command not found":需要安装
2

安装 Node.js(如果需要)

macOS 安装(推荐用 Homebrew):

macOS 安装
brew install node@22

Windows 安装(推荐用 winget):

Windows 安装
winget install OpenJS.NodeJS.LTS

💡 Windows 用户注意:官方推荐在 WSL2 中运行 OpenClaw,能避免很多奇怪问题。

3

安装 OpenClaw

确认 Node.js >= v22 后,执行安装命令:

安装 OpenClaw
npm install -g @anthropic-ai/openclaw

等待时间:取决于你的网络,通常 30 秒到 2 分钟。

4

验证安装成功

验证命令
openclaw --version

如果提示"command not found",重启终端再试。

⚙️ 配置指南

1

运行初始化向导

初始化向导
openclaw onboard
2

选择模式

向导会问你选择什么模式:

  • QuickStart:新手,想快速跑起来(推荐第一次选这个)
  • Manual:想完全掌控配置
3

选择模型厂商

选择你在前面申请的厂商(KIMI/MiniMax/GLM)

4

输入 API Key

粘贴你之前保存的 API Key,然后选择对应的模型。

✅ 验证安装

发出第一条消息

配置完成后,你可以尝试向 OpenClaw 发出第一条消息:

测试对话
openclaw
> 你好,请介绍一下你自己

预期结果

如果 AI 正常回复了你,恭喜你!OpenClaw 已经成功安装并运行了!🎉

❓ 常见问题

Q: 安装时提示权限错误怎么办?

A: 在命令前添加 sudo 或以管理员身份运行终端。

Q: 如何更新 OpenClaw?

A: 运行 npm update -g @anthropic-ai/openclaw

Q: API Key 泄露了怎么办?

A: 立即到对应平台删除该 Key,重新创建一个新的。

Q: 支持哪些编程语言?

A: OpenClaw 本身是 JavaScript/TypeScript 编写,可以调用任何编程语言的脚本和工具。

Q: 数据安全吗?

A: OpenClaw 运行在你的电脑上,聊天记录和文件处理都在本地完成,API Key 不会经过第三方服务器。

🎯 下一步

安装成功后,你可以继续学习:

  • 接入飞书,在聊天中@AI 机器人办事
  • 配置安全策略,保护你的数据和隐私
  • 学习使用现成的 Skills,让 AI 完成特定任务
  • 编写自定义 Skills,打造专属你的 AI 助理