OpenClaw 安装与使用教程

OpenClaw 是一款开源的 AI 个人助手，运行在你自己的机器上，通过聊天应用（Slack、Telegram、WhatsApp、Discord 等）或 Web 控制面板与之交互。它能帮你处理邮件、管理日历、写代码、控制智能家居、抓取网页数据等——就像一个 24 小时在线的私人助理。

📚 官方资源

官网：https://openclaw.ai/
GitHub：https://github.com/openclaw/openclaw
官方文档：https://docs.openclaw.ai/zh-CN/start/wizard
中文社区：https://clawcn.net/install/

一、安装 OpenClaw

前置条件

在安装 OpenClaw 之前，你需要先安装 Node.js 环境。

安装 Node.js

重要提示： 访问 Node.js 官网和部分安装源可能需要科学上网工具。

🚀 梯子推荐：质子加速器 - 稳定可靠，支持多平台

安装步骤：

访问 Node.js 官网：https://nodejs.org/
下载 LTS（长期支持）版本
运行安装程序，按提示完成安装
验证安装：

bash

node --version
npm --version

看到版本号即安装成功。

方式 1：使用 npm 安装（推荐）

bash

npm install -g openclaw

验证安装：

bash

openclaw --version

看到版本号即安装成功。

方式 2：官方一键安装脚本

macOS / Linux：

bash

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

Windows PowerShell：

powershell

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

方式 3：从源码安装（开发者）

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

二、初始化配置

安装完成后，运行初始化向导：

bash

openclaw onboard

向导会交互式引导你完成所有配置，包括：AI 模型、聊天渠道、技能、Hooks、Gateway 服务等。

2.1 选择配置模式

◇  Onboarding mode
│  QuickStart

选择 QuickStart（推荐），会自动配置网关端口（18789）、绑定地址（127.0.0.1）等默认设置。

三、配置 AI 模型

3.1 中国大陆用户推荐方案

由于 Anthropic 和 OpenAI 的 API Key 需要绑定国际信用卡，中国大陆用户可以选择以下方案：

方案一：使用中转 API 接口（最便捷）

推荐使用 https://ai.gaoxiao888.com 提供的中转接口，支持多种 AI 模型，国内可直接访问。

配置方式与官方 API 相同，只需将 API Key 替换为中转平台提供的 Key 即可。

方案二：DeepSeek（国内服务商）

DeepSeek 是中国大陆的大语言模型服务商，支持支付宝充值。

访问 https://platform.deepseek.com
注册账号并获取 API Key
在向导中配置：

◇  Model/auth provider
│  DeepSeek
│
◇  DeepSeek API key
│  （粘贴你的 API Key）
│
◇  Default model
│  deepseek/deepseek-chat

方案二：OpenRouter（一个 Key 访问多家模型）

OpenRouter 是模型聚合平台，一个 API Key 即可访问 Claude、GPT、DeepSeek 等多家模型。

访问 https://openrouter.ai
注册并获取 API Key
在向导中配置：

◇  Model/auth provider
│  OpenRouter
│
◇  OpenRouter API key
│  （粘贴你的 API Key）
│
◇  Default model
│  openrouter/anthropic/claude-opus-4-6

方案三：Claude 订阅用户使用 Token

如果你已有 Claude Pro/Team 订阅（https://claude.ai），可以生成 Token：

bash

claude setup-token

然后在向导中选择：

◇  Model/auth provider
│  Anthropic
│
◇  Anthropic auth method
│  Claude.ai token
│
◇  Default model
│  anthropic/claude-opus-4-6

3.2 国际用户方案

◇  Model/auth provider
│  Anthropic
│
◇  Anthropic auth method
│  Anthropic API key
│
◇  Default model
│  anthropic/claude-opus-4-6

获取 API Key：

Anthropic Claude：https://console.anthropic.com
OpenAI GPT：https://platform.openai.com

四、配置聊天渠道（以 Slack 为例）

4.1 创建 Slack App

打开 Slack API 控制台
点击 Create New App → 选择 From scratch
输入 App 名称（如 OpenClaw），选择你的工作区
点击 Create App

4.2 配置 Bot 权限

在左侧菜单点击 OAuth & Permissions，滚动到 Bot Token Scopes，添加以下权限：

权限	说明
`chat:write`	允许 Bot 发送消息
`channels:history`	读取公共频道消息历史
`channels:read`	访问公共频道信息
`groups:history`	读取私有频道消息历史
`im:history`	读取私聊消息历史
`mpim:history`	读取群组私聊消息历史
`users:read`	读取用户信息
`app_mentions:read`	读取 @提及消息
`reactions:read`	读取表情回应
`reactions:write`	添加表情回应
`pins:read`	读取置顶消息
`pins:write`	置顶消息
`emoji:read`	读取自定义表情
`commands`	支持斜杠命令
`files:read`	读取文件
`files:write`	上传文件

4.3 配置其他必要设置

启用 Socket Mode：

左侧菜单 → Socket Mode → 开启

配置 Event Subscriptions：

左侧菜单 → Event Subscriptions → 开启
添加以下 Bot Events：
- app_mention
- message.channels
- message.groups
- message.im
- message.mpim
- reaction_added
- reaction_removed
- member_joined_channel
- member_left_channel
- channel_rename
- pin_added
- pin_removed

配置 App Home：

左侧菜单 → App Home → 开启 Messages Tab
勾选 "Allow users to send Slash commands and messages from the messages tab"

添加 Slash Commands：

左侧菜单 → Slash Commands → 添加 /openclaw 命令

4.4 安装 App 到工作区

滚动到页面顶部，点击 Install to Workspace
在弹出的授权页面点击 Allow
安装完成后，复制 Bot User OAuth Token

⚠️ 这个 Token 以 xoxb- 开头，类似：xoxb-1234567890-1234567890123-aBcDeFgHiJkLmNoPqRsTuVwX 请妥善保存，后面配置时需要。

4.5 获取 App 级别 Token

左侧菜单点击 Basic Information
滚动到 App-Level Tokens 区域
点击 Generate Token and Scopes
输入 Token 名称（如 openclaw-socket）
点击 Add Scope，选择 connections:write
点击 Generate
复制生成的 Token

⚠️ 这个 Token 以 xapp- 开头，类似：xapp-1-A1234567890-1234567890123-abcdef... 同样请妥善保存。

4.6 在向导中输入 Token

回到 openclaw onboard 向导，输入刚才获取的两个 Token：

◇  Enter Slack bot token (xoxb-...)
│  （粘贴 Bot Token）
│
◇  Enter Slack app token (xapp-...)
│  （粘贴 App Token）

4.7 配置频道访问权限

◇  Configure Slack channels access?
│  Yes
│
◇  Slack channels access
│  Allowlist (recommended)
│
◆  Slack channels allowlist (comma-separated)
│  #general, #projects

💡 Allowlist 填写说明：
支持三种格式：#频道名、频道名、频道ID（如 C123456）
示例：#general, #private, C123456
留空：Bot 在所有频道都能响应（适合测试）
私聊始终可用，allowlist 只影响频道中的 @提及响应

五、配置技能（Skills）

向导会询问是否配置技能：

◇  Configure skills now? (recommended)
│  Yes

建议选择 Yes。接下来会询问是否配置各技能的 API Key：

◇  Set GOOGLE_PLACES_API_KEY for goplaces?     → No
◇  Set GEMINI_API_KEY for nano-banana-pro?      → No
◇  Set NOTION_API_KEY for notion?               → No
◇  Set OPENAI_API_KEY for openai-image-gen?     → No
◇  Set OPENAI_API_KEY for openai-whisper-api?   → No
◇  Set ELEVENLABS_API_KEY for sag?              → No

💡 这些 API Key 都是可选的，用于特定技能。没有的话全部选 No 跳过即可，后续可通过 openclaw configure 随时补充。

六、配置 Hooks（自动化钩子）

◇  Enable hooks?
│  🚀 boot-md, 📝 command-logger, 💾 session-memory

建议全部启用（默认已全选），这三个 Hook 的作用：

Hook	作用
`boot-md`	启动时加载引导信息
`command-logger`	记录命令日志
`session-memory`	保存会话上下文到记忆

七、启动 OpenClaw

7.1 理解两个核心概念

组件	说明	是否需要一直开着
Gateway 守护进程	后台服务，负责连接 Slack 等渠道、接收和处理消息	✅ 是（开机自动启动）
TUI / Web 控制面板	聊天界面，方便你在终端或浏览器中直接和 Bot 对话	❌ 否（需要时打开即可）

💡 关键点： 只要 Gateway 守护进程在后台运行，你就能通过 Slack 随时和 Bot 对话——不需要打开 TUI 或 Web 控制面板。

7.2 首次启动（Hatch）

向导最后会询问如何首次启动：

◇  How do you want to hatch your bot?
│  ● Hatch in TUI (recommended)
│  ○ Open the Web UI
│  ○ Do this later

选择 Hatch in TUI，会自动进入终端聊天界面。Bot 会发送 "Wake up, my friend!" 作为第一条消息。你可以开始和它对话，告诉它你的需求和偏好。

💡 退出 TUI：按 Ctrl+C 即可退出。Bot 的 Gateway 服务仍在后台运行。

7.3 验证 Slack 连接

打开你的 Slack 工作区
在左侧栏找到 OpenClaw（如果没看到，点击 + → Browse apps 搜索）
给它发一条私聊消息，比如：你好
如果收到回复，说明配置成功 ✅

💡 你也可以在任意频道中 @OpenClaw 来调用它。

如果出现 access not configured 提示，需要在终端运行：

bash

openclaw pairing approve slack <code>

7.4 后续使用

查看状态：

bash

openclaw status

看到 Gateway service: running 和 Slack: OK 就说明一切正常。

打开终端聊天界面：

bash

openclaw tui

打开 Web 控制面板：

bash

openclaw dashboard

浏览器会自动打开 http://localhost:18789。

八、开启全自动模式（可选但推荐）

默认安装后，OpenClaw 很多操作需要手动确认。通过以下配置可以解锁全自动模式。

8.1 编辑配置文件

编辑 ~/.openclaw/config.json，添加以下配置：

json

{
  "agents": {
    "defaults": {
      "sandbox": { "mode": "off" }
    }
  },
  "tools": {
    "exec": {
      "security": "full",
      "ask": "off"
    },
    "elevated": {
      "enabled": true,
      "allowFrom": {
        "slack": ["你的 Slack 用户 ID"]
      }
    }
  }
}

如何获取 Slack 用户 ID：

打开 Slack → 点击左上角你的头像
Profile → 点击右侧 ⋮ 更多按钮
Copy member ID，得到的 U0XXXXXXX 格式字符串就是你的 ID

⚠️ 此配置仅适合个人设备。如果是共享服务器，请参考官方安全文档做更细粒度的配置。

8.2 重启 Gateway

bash

openclaw gateway --force

配置后，OpenClaw 可以在你的机器上自主执行任何操作，不再弹审批提示。

8.3 配置 Gmail 邮件（可选）

开启全自动模式后，直接在 Slack 跟 OpenClaw 说：

帮我配置 Gmail 邮件，我的邮箱是 [email protected]

OpenClaw 会自动安装所需依赖（gog、gcloud 等）、运行配置命令，只在需要你登录 Google 账号授权时才会提示你操作。

九、OpenClaw 能做什么？

9.1 日常对话和问答

你：今天北京天气怎么样？
OpenClaw：北京今天晴，气温 -2°C ~ 8°C，北风 3-4 级...

你：帮我用中文总结一下这篇文章 https://example.com/article
OpenClaw：这篇文章主要讲了三个要点：1)... 2)... 3)...

9.2 执行 Shell 命令和写代码

你：帮我看一下当前目录有哪些文件，按大小排序
OpenClaw：我来执行一下...
（OpenClaw 自动执行 ls -lhS 命令，返回结果）

你：写一个 Python 脚本，把当前目录下所有 .jpg 文件批量重命名为 photo_001.jpg, photo_002.jpg ...
OpenClaw：好的，我来创建这个脚本...
（OpenClaw 自动创建 rename.py 文件并写入代码）
要我直接运行它吗？

你：运行吧
OpenClaw：已完成，共重命名了 23 个文件。

9.3 邮件管理

你：帮我检查一下 Gmail 里有没有未读的重要邮件
OpenClaw：你有 3 封未读邮件：
1. 来自 [email protected] - "Q1 预算审批"（2小时前）
2. 来自 [email protected] - "年假余额提醒"（5小时前）
3. 来自 [email protected] - "合同确认"（昨天）

你：帮我回复第一封，说"收到，我会在今天下午 5 点前提交修改版本"
OpenClaw：邮件已发送 ✅

9.4 日历和提醒

你：帮我创建一个提醒，明天下午 3 点和产品团队开会
OpenClaw：已创建日历事件 ✅
- 标题：产品团队会议
- 时间：明天 15:00
- 需要我提前 15 分钟提醒你吗？

你：好的，提前 15 分钟提醒
OpenClaw：已设置提醒 ✅

9.5 网页浏览和数据抓取

你：帮我去 GitHub trending 看看今天最火的 Python 项目有哪些
OpenClaw：我来查看一下...
（OpenClaw 自动打开浏览器访问 GitHub Trending）
今天 Python 热门项目 Top 5：
1. xxx/project-a ⭐ 2.3k - 一个用于...
2. xxx/project-b ⭐ 1.8k - 一个用于...
...

你：帮我把这个列表保存到 ~/Desktop/trending.md
OpenClaw：已保存 ✅

9.6 文件操作

你：帮我把 ~/Downloads 里超过 30 天的文件移到回收站
OpenClaw：我来检查一下...
找到 47 个超过 30 天的文件，总大小 2.3 GB。
确认要移到回收站吗？

你：确认
OpenClaw：已完成 ✅ 清理了 47 个文件，释放 2.3 GB 空间。

9.7 技能扩展

你：帮我创建一个技能，每天早上 9 点自动查看 Hacker News 头条，然后发到我的 Slack
OpenClaw：好的，我来创建这个技能...
（OpenClaw 自动编写技能代码，设置定时任务）
技能已创建并启用 ✅ 明天早上 9 点你会收到第一条推送。

你：有没有 Todoist 的技能？
OpenClaw：有的，我来安装...
（自动安装 Todoist 技能）
已安装 ✅ 现在你可以说"帮我添加一个待办事项"来使用了。

9.8 远程控制

在电脑或手机 Slack App 中随时发消息给 OpenClaw：

你（在 Slack 中）：帮我看一下服务器的 CPU 和内存使用率
OpenClaw：当前服务器状态：
- CPU: 23%
- 内存: 4.2 GB / 16 GB (26%)
- 磁盘: 120 GB / 500 GB (24%)
一切正常 ✅

你（在 Slack 中）：帮我重启一下 nginx
OpenClaw：已执行 sudo systemctl restart nginx ✅
nginx 已重启，状态正常。

十、常用命令速查

命令	说明
`openclaw onboard`	初始化配置向导（一站式完成所有配置）
`openclaw tui`	打开终端聊天界面（TUI）
`openclaw dashboard`	打开 Web 控制面板（浏览器聊天）
`openclaw doctor`	诊断系统环境
`openclaw status`	查看运行状态
`openclaw configure`	修改配置（API Key、渠道等）
`openclaw update`	更新到最新版本
`openclaw logs`	查看运行日志
`openclaw logs --follow`	实时查看日志
`openclaw hooks list`	查看所有 Hooks
`openclaw hooks enable <name>`	启用指定 Hook
`openclaw hooks disable <name>`	禁用指定 Hook
`openclaw security audit --deep`	深度安全审计
`openclaw daemon install`	安装后台守护进程
`openclaw daemon uninstall`	卸载后台守护进程
`openclaw gateway --force`	强制重启 Gateway
`openclaw pairing approve slack <code>`	批准 Slack 配对请求

十一、常见问题

Q1: 如何查看 OpenClaw 是否正常运行？

bash

openclaw status

看到 Gateway service: running 和 Slack: OK 就说明正常。

Q2: 如何查看日志排查问题？

bash

openclaw logs --follow

Q3: 如何更新到最新版本？

bash

openclaw update

Q4: Slack 提示 "access not configured" 怎么办？

在终端运行：

bash

openclaw pairing approve slack <code>

其中 <code> 是 Slack 提示中显示的配对码。

Q5: 如何添加更多聊天渠道？

bash

openclaw configure

然后选择要配置的渠道（Telegram、Discord、WhatsApp 等）。

Q6: 如何禁用某个技能？

bash

openclaw hooks disable <技能名称>

Q7: 开机后 Gateway 没有自动启动怎么办？

手动安装守护进程：

bash

openclaw daemon install

十二、快速上手路线图

1. 安装 OpenClaw
   ↓
2. 运行 openclaw onboard
   ↓
3. 配置 AI 模型（DeepSeek/OpenRouter/Claude）
   ↓
4. 配置 Slack（创建 App + 获取 Token）
   ↓
5. 启动并验证（openclaw status）
   ↓
6. 在 Slack 中发消息测试
   ↓
7. （可选）开启全自动模式
   ↓
8. 开始使用！

十三、参考链接

官网：https://openclaw.ai/
官方文档：https://docs.openclaw.ai/zh-CN/start/wizard
GitHub：https://github.com/openclaw/openclaw
中文社区：https://clawcn.net/install/
技能市场：https://openclaw.ai/ → Skills & Plugins
Discord 社区：https://openclaw.ai/ → Discord
Slack API 控制台：https://api.slack.com/apps

附录：必须手动配置的项目

项目	说明
AI 模型 API Key	在 `openclaw onboard` 时填写（推荐 DeepSeek 或 OpenRouter）
聊天渠道 Token	在 `openclaw onboard` 时填写（如 Slack Bot Token）
Gmail 授权	需要本人登录 Google 账号授权

其他所有操作（安装依赖、执行脚本、发消息、修改文件等）OpenClaw 都能自主完成，无需手动干预。

教程完成！ 🎉

现在你可以开始使用 OpenClaw 了。如有问题，请参考官方文档或加入社区讨论。

OpenClaw 安装与使用教程 ​

📚 官方资源 ​

一、安装 OpenClaw ​

前置条件 ​

安装 Node.js ​

方式 1：使用 npm 安装（推荐） ​

方式 2：官方一键安装脚本 ​

方式 3：从源码安装（开发者） ​

二、初始化配置 ​

2.1 选择配置模式 ​

三、配置 AI 模型 ​

3.1 中国大陆用户推荐方案 ​

方案一：使用中转 API 接口（最便捷） ​

方案二：DeepSeek（国内服务商） ​

方案二：OpenRouter（一个 Key 访问多家模型） ​

方案三：Claude 订阅用户使用 Token ​

3.2 国际用户方案 ​

四、配置聊天渠道（以 Slack 为例） ​

4.1 创建 Slack App ​

4.2 配置 Bot 权限 ​

4.3 配置其他必要设置 ​

4.4 安装 App 到工作区 ​

4.5 获取 App 级别 Token ​

4.6 在向导中输入 Token ​

4.7 配置频道访问权限 ​

五、配置技能（Skills） ​

六、配置 Hooks（自动化钩子） ​

七、启动 OpenClaw ​

7.1 理解两个核心概念 ​

7.2 首次启动（Hatch） ​

7.3 验证 Slack 连接 ​

7.4 后续使用 ​

八、开启全自动模式（可选但推荐） ​

8.1 编辑配置文件 ​

8.2 重启 Gateway ​

8.3 配置 Gmail 邮件（可选） ​

九、OpenClaw 能做什么？ ​

9.1 日常对话和问答 ​

9.2 执行 Shell 命令和写代码 ​

9.3 邮件管理 ​

9.4 日历和提醒 ​

9.5 网页浏览和数据抓取 ​

9.6 文件操作 ​

9.7 技能扩展 ​

9.8 远程控制 ​

十、常用命令速查 ​

十一、常见问题 ​

Q1: 如何查看 OpenClaw 是否正常运行？ ​

Q2: 如何查看日志排查问题？ ​

Q3: 如何更新到最新版本？ ​

Q4: Slack 提示 "access not configured" 怎么办？ ​

Q5: 如何添加更多聊天渠道？ ​

Q6: 如何禁用某个技能？ ​

Q7: 开机后 Gateway 没有自动启动怎么办？ ​

十二、快速上手路线图 ​

十三、参考链接 ​

附录：必须手动配置的项目 ​

OpenClaw 安装与使用教程

📚 官方资源

一、安装 OpenClaw

前置条件

安装 Node.js

方式 1：使用 npm 安装（推荐）

方式 2：官方一键安装脚本

方式 3：从源码安装（开发者）

二、初始化配置

2.1 选择配置模式

三、配置 AI 模型

3.1 中国大陆用户推荐方案

方案一：使用中转 API 接口（最便捷）

方案二：DeepSeek（国内服务商）

方案二：OpenRouter（一个 Key 访问多家模型）

方案三：Claude 订阅用户使用 Token

3.2 国际用户方案

四、配置聊天渠道（以 Slack 为例）

4.1 创建 Slack App

4.2 配置 Bot 权限

4.3 配置其他必要设置

4.4 安装 App 到工作区

4.5 获取 App 级别 Token

4.6 在向导中输入 Token

4.7 配置频道访问权限

五、配置技能（Skills）

六、配置 Hooks（自动化钩子）

七、启动 OpenClaw

7.1 理解两个核心概念

7.2 首次启动（Hatch）

7.3 验证 Slack 连接

7.4 后续使用

八、开启全自动模式（可选但推荐）

8.1 编辑配置文件

8.2 重启 Gateway

8.3 配置 Gmail 邮件（可选）

九、OpenClaw 能做什么？

9.1 日常对话和问答

9.2 执行 Shell 命令和写代码

9.3 邮件管理

9.4 日历和提醒

9.5 网页浏览和数据抓取

9.6 文件操作

9.7 技能扩展

9.8 远程控制

十、常用命令速查

十一、常见问题

Q1: 如何查看 OpenClaw 是否正常运行？

Q2: 如何查看日志排查问题？

Q3: 如何更新到最新版本？

Q4: Slack 提示 "access not configured" 怎么办？

Q5: 如何添加更多聊天渠道？

Q6: 如何禁用某个技能？

Q7: 开机后 Gateway 没有自动启动怎么办？

十二、快速上手路线图

十三、参考链接

附录：必须手动配置的项目