🦞 OpenClaw 小白使用手册（超详细版）

适合完全零基础的用户，手把手教你从安装到精通
来源：https://docs.openclaw.ai

---

📖 目录

• 一、OpenClaw 到底是什么？
• 二、准备工作
• 三、安装（5 分钟搞定）
• 四、第一次启动与配置
• 五、连接你的 AI 模型
• 六、核心用法：和 AI 聊天
• 七、连接到消息 App（Telegram/Discord 等）
• 八、技能系统（Skills）——让 AI 更聪明
• 九、常见 CLI 命令速查
• 十、常见问题排查
• 十一、安全重要！
• 十二、实用场景示例

---

一、OpenClaw 到底是什么？

简单说：OpenClaw 是一个让你能在任何聊天 App 里使用 AI 助手的工具。

想象一下：

• 你在 Telegram 上给它发消息，它帮你管理服务器
• 你在 Discord 群里 @它，它帮你查资料
• 你在 WhatsApp 上找它，它记住你的所有事情

OpenClaw 就是连接「你常用的聊天 App」和「AI 大模型」的桥梁。

特点：

• ✅ 免费开源（MIT 协议）
• ✅ 支持 20+ 消息平台（Telegram、微信、Discord、WhatsApp 等）
• ✅ 支持所有主流 AI 模型
• ✅ 可以安装各种"技能"让 AI 学会做特定事情

---

二、准备工作

你需要准备的东西

| 需要 | 说明 | 获取方式 |
|------|------|---------|
| 一台电脑 | Mac、Windows 或 Linux 都行 | 你正在用的这台 |
| Node.js | 版本 24（推荐）或 22.19+ | 下面有安装方法 |
| API 密钥 | AI 模型的"钥匙" | 从模型提供商获取 |

检查你的 Node.js 版本

打开终端（Terminal），输入：

node --version

如果显示 v22.19.0 或更高版本，就可以；如果没装或版本太低：

macOS 装 Node.js：

brew install node

Windows 装 Node.js：
去 https://nodejs.org 下载 LTS 版本安装

Linux 装 Node.js：

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

获取 API 密钥（选一个你喜欢的）

| 提供商 | 特点 | 获取地址 |
|--------|------|---------|
| OpenAI | 最流行的模型（GPT-4o） | https://platform.openai.com/api-keys |
| Anthropic | Claude 系列，擅长写作和推理 | https://console.anthropic.com |
| DeepSeek | 性价比高，国内也能用 | https://platform.deepseek.com |
| Google Gemini | 免费额度多 | https://aistudio.google.com |

---

三、安装（5 分钟搞定）

macOS / Linux 用户

打开终端，粘贴这一行然后回车：

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

看到 ✅ OpenClaw installed successfully 就说明装好了。

Windows 用户

推荐方式：安装 WSL2（Linux 子系统），在里面运行上面的命令。
原生方式：在 PowerShell 中运行：

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

验证安装

openclaw --version

如果显示版本号，恭喜你，安装成功！🎉

---

四、第一次启动与配置

安装好后，运行一个命令就能完成所有基础配置：

openclaw onboard --install-daemon

这个向导会问你几个问题：

第 1 步：选择模型提供者

比如选 openai、anthropic、deepseek 等，用方向键选择，回车确认。

第 2 步：输入 API 密钥

把你从上面获取的 API 密钥粘贴进去（粘贴后不会显示，这是正常的）。

第 3 步：设置 Gateway

Gateway 是让 OpenClaw 一直运行的后台服务。问你是否安装守护进程时，选 Yes。

完成后会显示：

✅ Onboarding complete!
✅ Gateway daemon installed

---

五、连接你的 AI 模型

如果向导没配置模型，或者想换模型

# 查看当前模型
openclaw config get agent.model

# 设置模型（把下面的 provider/model 换成你用的）
openclaw config set agent.model "openai/gpt-4o"
openclaw config set agent.model "anthropic/claude-sonnet-4"
openclaw config set agent.model "deepseek/deepseek-chat"

配置多个模型（故障转移）

// 编辑 ~/.openclaw/openclaw.json
{
  "agent": {
    "model": "openai/gpt-4o"
  },
  "models": {
    "fallback": ["anthropic/claude-sonnet-4"]
  }
}

---

六、核心用法：和 AI 聊天

在终端里直接对话

openclaw agent --message "你好，你是谁？"

连续对话模式

openclaw agent

这时会进入对话界面，就像在用 ChatGPT 一样。输入你的问题，AI 就会回答。

在对话中常用的斜杠命令

| 命令 | 功能 | 示例 |
|------|------|------|
| /new | 开始新对话 | /new |
| /model <模型名> | 切换模型 | /model gpt-4o |
| /reset | 重置当前对话 | /reset |
| /status | 查看状态 | /status |
| /compact | 压缩对话（省 token） | /compact |
| /usage | 查看用量统计 | /usage |
| /skills | 列出可用技能 | /skills |
| /help | 显示帮助 | /help |

发送消息到其他平台

# 发送 Telegram 消息
openclaw message send --target telegram --message "Hello!"

# 发送 WhatsApp 消息
openclaw message send --target "+8613800138000" --message "你好"

---

七、连接到消息 App（Telegram/Discord 等）

这是 OpenClaw 最强大的功能——让你在常用聊天 App 里使用 AI。

连接 Telegram（最简单，推荐先试这个）

步骤 1：创建 Telegram 机器人

1. 打开 Telegram，搜索 @BotFather
2. 发送 /newbot
3. 按提示设置机器人名称（如 MyHelperBot）
4. 得到类似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 的 Token
5. 保存好这个 Token！

步骤 2：配置 OpenClaw

openclaw config set channels.telegram.botToken "你的Token"
openclaw config set channels.telegram.enabled true

步骤 3：重启 Gateway

openclaw gateway restart

步骤 4：给你的机器人发消息

在 Telegram 里找到你的机器人，发送 /start，它会回复你一个配对码。把配对码发回去就完成了配对。

🎉 现在你可以在 Telegram 上跟 AI 对话了！

连接 Discord

步骤 1：创建 Discord 应用

1. 去 https://discord.com/developers/applications
2. 点击 "New Application"，取名
3. 左侧点 "Bot" → "Add Bot"
4. 复制 Token

步骤 2：配置 OpenClaw

openclaw config set channels.discord.botToken "你的Token"
openclaw config set channels.discord.enabled true
openclaw config set channels.discord.guildId "你的服务器ID"

步骤 3：邀请机器人到服务器

在 Discord 开发者页面：

1. 左侧点 "OAuth2" → "URL Generator"
2. 勾选 "bot" 权限
3. 勾选 "Send Messages"、"Read Message History"
4. 打开生成的链接，选择你的服务器

连接 WhatsApp

# 配置 WhatsApp
openclaw config set channels.whatsapp.enabled true

# 启动后扫描二维码配对
openclaw gateway start

WhatsApp 会显示一个二维码，用手机 WhatsApp 扫描即可。

---

八、技能系统（Skills）——让 AI 更聪明

技能就像 AI 的"专业知识"。安装技能后，AI 能更好地完成特定任务。

从 ClawHub 安装技能

ClawHub 是 OpenClaw 的官方技能市场：https://clawhub.ai

# 从 ClawHub 安装技能
openclaw skills install <技能名>

# 例如安装一个代码审查技能
openclaw skills install code-review

# 列出已安装的技能
openclaw skills list

# 在对话中使用技能
openclaw agent --message "帮我审查这段代码" --skill code-review

手动创建自己的技能

# 创建技能目录
mkdir -p ~/.openclaw/workspace/skills/my-skill

# 创建 SKILL.md 文件

~/.openclaw/workspace/skills/my-skill/SKILL.md 内容示例：

---
name: my-skill
description: 我的第一个技能
---

当用户说"翻译"时，执行以下步骤：
1. 识别源语言和目标语言
2. 翻译内容
3. 返回翻译结果

技能加载顺序（优先级从高到低）

1. 工作区技能：workspace/skills/
2. 项目技能：.agents/skills/
3. 用户技能：~/.openclaw/skills/
4. 内置技能

---

九、常见 CLI 命令速查

安装与更新

| 命令 | 说明 |
|------|------|
| openclaw --version | 查看版本 |
| openclaw update | 更新到最新版 |
| npm update -g openclaw@latest | 用 npm 更新 |

日常使用

| 命令 | 说明 |
|------|------|
| openclaw agent | 启动 AI 对话 |
| openclaw agent --message "你好" | 发送一条消息 |
| openclaw gateway start | 启动后台服务 |
| openclaw gateway stop | 停止后台服务 |
| openclaw gateway restart | 重启后台服务 |
| openclaw gateway status | 查看网关状态 |

配置管理

| 命令 | 说明 |
|------|------|
| openclaw config get <key> | 查看配置项 |
| openclaw config set <key> <value> | 设置配置项 |
| openclaw doctor | 检查配置是否有问题 |

通道管理

| 命令 | 说明 |
|------|------|
| openclaw channels list | 列出所有通道 |
| openclaw channels status | 查看通道状态 |
| openclaw channels enable <name> | 启用通道 |
| openclaw channels disable <name> | 禁用通道 |

技能管理

| 命令 | 说明 |
|------|------|
| openclaw skills list | 列出所有技能 |
| openclaw skills install <name> | 安装技能 |
| openclaw skills remove <name> | 删除技能 |

诊断与排错

| 命令 | 说明 |
|------|------|
| openclaw doctor | 全面诊断 |
| openclaw logs | 查看日志 |
| openclaw status | 查看系统状态 |

---

十、常见问题排查

Q：openclaw 命令找不到？

# 重新加载 shell 配置
source ~/.bashrc   # 或 source ~/.zshrc

# 或者重新安装
npm install -g openclaw@latest

Q：安装卡住了怎么办？

• 国内用户按上一章的镜像方法操作
• 检查网络连接
• 试试用代理

Q：Gateway 启动失败？

openclaw doctor

它会告诉你什么问题。常见原因：

• 端口 18789 被占用
• 配置文件有语法错误
• 模型 API Key 无效

Q：Telegram 机器人不回复？

1. 检查 Token 是否正确：openclaw config get channels.telegram.botToken
2. 检查 Gateway 是否运行：openclaw gateway status
3. 重启 Gateway：openclaw gateway restart
4. 看日志：openclaw logs

Q：OpenClaw 安装在哪了？

| 系统 | 路径 |
|------|------|
| 配置文件 | ~/.openclaw/openclaw.json |
| 工作区 | ~/.openclaw/workspace/ |
| 日志 | ~/.openclaw/logs/ |
| 会话数据 | ~/.openclaw/agents/ |

Q：怎么卸载？

npm uninstall -g openclaw
rm -rf ~/.openclaw

---

十一、安全重要！

保护好你的 API 密钥

API 密钥就是钱（AI 是按量付费的），不要分享给任何人。

DM 配对模式

默认情况下，陌生人给你机器人发消息不会得到回复，需要先配对：

# 查看配对列表
openclaw pairing list

# 批准某个配对码
openclaw pairing approve <通道> <配对码>

安全审计

openclaw security audit

这个命令会检查你的配置有没有安全风险。

---

十二、实用场景示例

场景 1：个人 AI 助手（在 Telegram 上用）

# 1. 安装 OpenClaw
npm install -g openclaw@latest

# 2. 配置 Telegram
openclaw config set channels.telegram.botToken "你的Token"
openclaw config set channels.telegram.enabled true

# 3. 配置模型（用便宜的）
openclaw config set agent.model "deepseek/deepseek-chat"

# 4. 启动
openclaw gateway start

现在在 Telegram 上跟你的机器人对话吧！

场景 2：代码审查助手

# 安装代码技能
openclaw skills install code-review

# 使用
openclaw agent --message "审查这个文件" --skill code-review

场景 3：每日摘要机器人

# 设置定时任务（每天早上 9 点发摘要）
openclaw cron add --schedule "0 9 * * *" \
  --command "查看今天的日程和邮件，生成摘要" \
  --deliver telegram

场景 4：从源码开发

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm openclaw setup
pnpm ui:build
pnpm gateway:watch

---

还想了解更多？

• 📘 完整文档：https://docs.openclaw.ai
• 🦞 ClawHub 技能市场：https://clawhub.ai
• 💬 Discord 社区：https://discord.gg/clawd
• 🐱 GitHub：https://github.com/openclaw/openclaw

---

本手册由简川工作室基于 OpenClaw 官方文档整理，适合零基础用户阅读。
最后更新：2026-05-23