2026年OpenClaw 安装与运行教程

OpenClaw 安装与运行教程OpenClaw 是一款开源的 AI 个人助手 运行在你自己的机器上 通过聊天应用 Slack Telegram WhatsApp Discord 等 或 Web 控制面板与之交互 它能帮你处理邮件 管理日历 写代码 控制智能家居 抓取网页数据等 就像一个 24 小时在线的私人助理 官网 GitHub 官方文档 整个过程分 3 步 安装 OpenClaw 运行 onboard

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



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



  • 官网:
  • GitHub:
  • 官方文档:

整个过程分 3 步:安装 OpenClaw → 运行 onboard 向导(配置 AI 模型 + 聊天渠道 + 技能 + Gateway)→ 开始使用。

验证安装:

看到版本号即安装成功。

如果 npm 安装不适合你,还有以下替代方式:

官方安装脚本(一键安装):

macOS / Linux:

Windows PowerShell:

从源码安装(适合开发者):

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

首先会显示安全警告,阅读后选择 Yes 继续。

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

选择 AI 模型提供商并输入 API Key:

提供商 获取 API Key 备注 Anthropic Claude(推荐) → 创建账号 → API Keys → Create Key 需国际信用卡 OpenAI GPT → API Keys → Create new secret key 需国际信用卡 OpenRouter(中国大陆推荐) → 注册 → Keys → Create Key 支持多种支付方式,聚合多家模型 DeepSeek(中国大陆推荐) → 注册 → API Keys → 创建 中国大陆服务商,支持支付宝充值 Moonshot / Kimi → 注册 → API Key 管理 → 新建 中国大陆服务商,支持国内支付 本地模型 支持 Ollama 等,无需 API Key 免费,需本地算力

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

方案一:使用 DeepSeek(最简单)

DeepSeek 是中国大陆的大语言模型服务商,注册即可使用,支持支付宝充值:

方案二:使用 OpenRouter(一个 Key 访问多家模型)

OpenRouter 是一个模型聚合平台,一个 API Key 即可访问 Claude、GPT、DeepSeek、Llama 等多家模型,支持多种支付方式:

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

如果你已经有 Claude Pro/Team 订阅( Token,无需额外申请 API Key:

然后在向导中选择对应的认证方式:

💡 如果环境变量中已有 API Key(如 ),向导会自动检测并询问是否使用。

GPT plus 代充 只需 145

向导会显示所有支持的聊天渠道状态,然后让你选择:

选择你要配置的渠道。如果暂时不需要,可以跳过(后续通过 补充)。

以下以 Slack 为例,详见第 3 步。

配置完成后可运行诊断命令验证:

全部显示 ✅ 即表示配置成功。

在第 2.4 步选择 Slack 后,向导会提示你先去 Slack API 控制台创建 App 并获取 Token。以下是详细步骤:

💡 OpenClaw 支持多种聊天渠道(Telegram、WhatsApp、Discord、Signal 等),这里以 Slack 为例。
  1. 打开
  2. 点击 Create New App → 选择 From scratch
  3. 输入 App 名称(如 ),选择你的工作区
  4. 点击 Create App

手动配置方式

  1. 在左侧菜单点击 OAuth & Permissions
  1. 滚动到 Bot Token Scopes,点击 Add an OAuth Scope,添加以下权限:
权限 说明 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 上传文件
  1. 还需要配置以下内容:
  • Socket Mode:左侧菜单 → Socket Mode → 开启
  • Event Subscriptions:左侧菜单 → Event Subscriptions → 开启,添加以下 Bot Events: 、、、、、、、、、、、
  • App Home:左侧菜单 → App Home → 开启 Messages Tab -> 勾选下面的 “Allow users to send Slash commands and messages from the messages tab”
  • Slash Commands:添加 命令
  1. 滚动到页面顶部,点击 Install to
  1. 在弹出的授权页面点击 Allow
  1. 安装完成后,复制页面上显示的 Bot User OAuth Token
⚠️ 这个 Token 以 开头,类似: 请妥善保存,后面在 onboard 向导中需要输入。
  1. 在左侧菜单点击 Basic Information
  1. 滚动到 App-Level Tokens 区域
  2. 点击 Generate Token and Scopes
  1. 输入 Token 名称(如 )
  2. 点击 Add Scope,选择
  3. 点击 Generate
  1. 复制生成的 Token
⚠️ 这个 Token 以 开头,类似: 同样请妥善保存。

回到 向导,当出现以下提示时依次输入:

输入完 Token 后,向导会继续提示配置频道权限:

提示 怎么填 Configure Slack channels access? 选 Yes Slack channels access 选 Allowlist (recommended) Slack channels allowlist 填入允许 Bot 响应的频道,逗号分隔
💡 allowlist 怎么填



  • 支持三种格式:、、(如 )
  • 示例:
  • 留空:Bot 在所有频道都能响应(适合测试)
  • 私聊始终可用,allowlist 只影响频道中的 @提及响应

频道配置完成后,向导会显示技能状态并询问是否配置:

提示 怎么填 Configure skills now? 选 Yes(推荐) Show Homebrew install command? Linux/macOS 用户选 Yes 查看安装命令,可稍后安装 Preferred node manager for skill installs 选 npm Install missing skill dependencies 可选 Skip for now(跳过,后续手动安装)

接下来向导会逐一询问是否配置各技能的 API Key:

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

建议全部启用(默认已全选),这三个 Hook 的作用:

Hook 作用 boot-md 启动时加载引导信息 command-logger 记录命令日志 session-memory 保存会话上下文到记忆
💡 后续可通过以下命令管理 Hooks:



  • — 查看所有 Hooks
  • — 启用
  • — 禁用

向导会自动完成以下操作(无需手动干预):

  1. Systemd 配置(仅 Linux):启用 systemd lingering,防止退出登录后服务被终止
  2. Gateway 服务安装:自动安装 systemd 服务,确保网关持续运行

安装完成后,向导会自动验证 Slack 连接:

看到 表示 Slack 连接成功 ✅

向导会显示 Web 控制面板的访问地址:

💡 记住这个地址,后续可以通过浏览器访问 Web 控制面板与 Bot 对话。 也可以随时运行 打开。

这是 onboard 的最后一步,选择如何首次启动你的 Bot:

选项 说明 Hatch in TUI (recommended) ✅ 直接在终端进入交互式 TUI 界面,与 Bot 对话并设定人设。推荐选这个。 Open the Web UI 打开浏览器 Web 控制面板完成初始化 Do this later 跳过,以后再做

选择 Hatch in TUI 后,会自动进入终端聊天界面:

Bot 会发送 “Wake up, my friend!” 作为第一条消息。你可以开始和它对话,告诉它你的需求和偏好——描述越详细,后续体验越好

💡 退出 TUI:按 即可退出。Bot 的 Gateway 服务仍在后台运行。
  1. 打开你的 Slack 工作区
  2. 在左侧栏找到 OpenClaw(如果没看到,点击 +Browse apps 搜索)
  1. 给它发一条私聊消息,比如:
  2. 如果收到回复,说明配置成功 ✅
💡 你也可以在任意频道中 @OpenClaw 来调用它,比如:
  1. 如果出现 access not configured 则需要根据提示在终端上进行配置 ,如图所示:

OpenClaw 有两个核心概念需要区分:

组件 说明 是否需要一直开着 Gateway 守护进程 后台服务,负责连接 Slack 等渠道、接收和处理消息。没有界面,默默运行。 ✅ 是(开机自动启动) TUI / Web 控制面板 聊天界面,方便你在终端或浏览器中直接和 Bot 对话。 ❌ 否(需要时打开即可)
💡 关键点:只要 Gateway 守护进程在后台运行,你就能通过 Slack 随时和 Bot 对话—— 不需要打开 TUI 或 Web 控制面板。TUI 和 Web 控制面板只是额外的聊天入口,关掉它们不影响 Slack 的使用。

onboard 向导已经自动安装了 Gateway 的 systemd 服务,每次开机后 Gateway 会自动启动,无需手动操作。

你可以通过以下命令确认 Gateway 是否在运行:

看到 和 就说明一切正常,直接去 Slack 聊天即可。

如果你更喜欢在终端中与 Bot 对话:

💡 退出 TUI()不会停止 Gateway,Slack 仍然可以正常使用。

你也可以通过浏览器和 Bot 对话:

浏览器会自动打开 ,你会看到一个聊天界面。

💡 如果 onboard 时显示了带 token 的 URL(如 ),可以直接用该 URL 访问,无需手动输入 token。

onboard 向导已经自动安装了 Gateway 的 systemd 服务(Linux),Bot 会在后台持续运行。查看状态:

看到 和 就说明一切正常。

通常不需要手动操作,但以下命令在排查问题时可能用到:


默认安装后,OpenClaw 很多操作需要手动确认(比如让它发邮件会提示你先装 SMTP)。只需一步配置即可解锁全自动模式。

编辑 ,粘贴以下配置:

如何获取 Slack 用户 ID:打开 Slack → 点击左上角你的头像 → Profile → 点击右侧 更多按钮 → Copy member ID,得到的 格式字符串就是你的 ID。
如果用 Discord/WhatsApp 等其他渠道,把 换成对应渠道名并填入你的 ID。


配置后重启 Gateway:

效果:OpenClaw 可以在你的机器上自主执行任何操作,不再弹审批提示。

⚠️ 此配置仅适合 个人设备。如果是共享服务器,参考做更细粒度的配置。

不需要手动装 SMTP。开启全自动模式后,直接在 Slack 跟 OpenClaw 说:

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

如果 OpenClaw 还不够聪明没有自动装依赖,也可以手动一条命令搞定:
> npm install -g gog && openclaw webhooks gmail setup –account > “ >gcloud CLI 未安装的话参考 [安装指南](),装完后执行source ~/.bashrc` 刷新环境变量。


必须手动配置 一句话说明 AI 模型 API Key openclaw onboard 时填写(中国大陆用户推荐 DeepSeek 或 OpenRouter,详见 2.3 节) 聊天渠道 Token openclaw onboard 时填写 Gmail 授权 需要本人登录 Google 账号授权

其他所有操作(装依赖、跑脚本、发消息、改文件等)OpenClaw 都能自主完成,无需你干预。


配置好 API Key 后,OpenClaw 就是一个有手有脚的 AI 助手——它不仅能聊天,还能操作你的电脑、访问互联网、执行代码。以下是具体的使用场景和示例。

在 Slack 或 Web 控制面板中直接发消息:

OpenClaw 可以直接在你的机器上执行命令:

💡 需先配置 Gmail,详见 ,一条命令搞定,无需手动装 SMTP。

OpenClaw 内置浏览器控制能力,可以帮你操作网页:

OpenClaw 支持安装和创建技能插件,扩展更多能力:

你也可以从社区安装现成的技能:

配置好 Slack 后,你可以在电脑或手机 Slack App 中随时发消息给 OpenClaw:


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


  • 官网
  • 官方文档
  • GitHub
  • 中文社区
  • 技能市场: → Skills & Plugins
  • Discord 社区: → Discord
  • Slack API 控制台

小讯
上一篇 2026-03-12 09:39
下一篇 2026-03-12 09:41

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213993.html