OpenClaw 安装与运行教程

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

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


验证安装:


看到版本号即安装成功。

其他安装方式

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

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

macOS / Linux:


Windows PowerShell:


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



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

2.1 安全提示

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

2.2 选择 Onboarding 模式


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

2.3 配置 AI 模型

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

提供商 获取 API Key 备注 Anthropic Claude(推荐) https://console.anthropic.com → 创建账号 → API Keys → Create Key 需国际信用卡 OpenAI GPT https://platform.openai.com → API Keys → Create new secret key 需国际信用卡 OpenRouter(中国大陆推荐) https://openrouter.ai → 注册 → Keys → Create Key 支持多种支付方式,聚合多家模型 DeepSeek(中国大陆推荐) https://platform.deepseek.com → 注册 → API Keys → 创建 中国大陆服务商,支持支付宝充值 Moonshot / Kimi https://platform.moonshot.cn → 注册 → 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 订阅(https://claude.ai),可以通过以下命令生成,-894f08bfaa227ixlbg06f11zcro4dg7a/) Token,无需额外申请 API Key:


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


国际用户(默认方案)

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

Image

2.4 选择聊天渠道

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


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

Image

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

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


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

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

💡 OpenClaw 支持多种聊天渠道(Telegram、WhatsApp、Discord、Signal 等),这里以 
Slack 为例。

3.1 创建 Slack App

  1. 打开 Slack API 控制台
  2. 点击 Create New App → 选择 From scratch
  3. 输入 App 名称(如 ),选择你的工作区
  4. 点击 Create App

Image Image Image

3.2 配置 Bot 权限并安装到工作区

手动配置方式

  1. 在左侧菜单点击 OAuth & Permissions

Image

  1. 滚动到 Bot Token Scopes,点击 Add an OAuth Scope,添加以下权限:
权限 说明 允许 Bot 发送消息 读取公共频道消息历史 访问公共频道信息 读取私有频道消息历史 读取私聊消息历史 读取群组私聊消息历史 读取用户信息 读取 @提及消息 读取表情回应 添加表情回应 读取置顶消息 置顶消息 读取自定义表情 支持斜杠命令 读取文件 上传文件

Image Image

  1. 还需要配置以下内容:
    • Socket Mode:左侧菜单 → Socket Mode → 开启

Image

  • Event Subscriptions:左侧菜单 → Event Subscriptions → 开启,添加以下 Bot Events:
    、、、、、、、、、、、

Image Image

  • App Home:左侧菜单 → App Home → 开启 Messages Tab -> 勾选下面的 “Allow users to send Slash commands and messages from the messages tab”

Image

  • Slash Commands:添加  命令

Image Image

  1. 滚动到页面顶部,点击 Install to

Image

  1. 在弹出的授权页面点击 Allow

Image

  1. 安装完成后,复制页面上显示的 Bot User OAuth Token

⚠️ 这个 Token 以  开头,类似:

请妥善保存,后面在 onboard 向导中需要输入。

3.3 获取 App 级别 Token

  1. 在左侧菜单点击 Basic Information

Image

  1. 滚动到 App-Level Tokens 区域
  2. 点击 Generate Token and Scopes

Image

  1. 输入 Token 名称(如 )
  2. 点击 Add Scope,选择 
  3. 点击 Generate

Image

  1. 复制生成的 Token

⚠️ 这个 Token 以  开头,类似: 同样请妥善保存。

3.4 在 onboard 向导中输入 Token

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


3.5 配置频道访问权限

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


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

💡 allowlist 怎么填

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

Image

3.6 配置技能(Skills)

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


提示 怎么填 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:


Image

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

3.7 配置 Hooks(自动化钩子)


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

Hook 作用 启动时加载引导信息 记录命令日志 保存会话上下文到记忆

💡 后续可通过以下命令管理 Hooks:

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

Image

3.8 安装 Gateway 服务

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

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

<!—->


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


看到  表示 Slack 连接成功 ✅

Image

3.9 Control UI 信息

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


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

也可以随时运行  打开。

3.10 孵化 Bot(Hatch)

这是 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 服务仍在后台运行。

3.11 验证 Slack 连接

  1. 打开你的 Slack 工作区
  2. 在左侧栏找到 OpenClaw(如果没看到,点击  +  → Browse apps 搜索)

Image Image

  1. 给它发一条私聊消息,比如:
  2. 如果收到回复,说明配置成功 ✅

💡 你也可以在任意频道中 @openclaw 来调用它,比如:

  1. 如果出现 access not configured 则需要根据提示在终端上进行配置 ,如图所示:

Image Image Image


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。

Image

配置后重启 Gateway:


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

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

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


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

如果 OpenClaw 还不够聪明没有自动装依赖,也可以手动一条命令搞定:


 CLI 未安装的话参考 安装指南,装完后执行  刷新环境变量。

Image Image Image

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

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


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

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


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


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



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



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


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


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



命令 说明 初始化配置向导(一站式完成所有配置) 打开终端聊天界面(TUI) 打开 Web 控制面板(浏览器聊天) 诊断系统环境 查看运行状态 修改配置(API Key、渠道等) 更新到最新版本 查看运行日志 查看所有 Hooks 启用指定 Hook 禁用指定 Hook 深度安全审计 安装后台守护进程 卸载后台守护进程



  • 官网: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
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/250755.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午6:32
下一篇 2026年3月13日 下午6:33


相关推荐

关注全栈程序员社区公众号