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:
中国大陆用户指南
由于 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(如 ),向导会自动检测并询问是否使用。

2.4 选择聊天渠道
向导会显示所有支持的聊天渠道状态,然后让你选择:
选择你要配置的渠道。如果暂时不需要,可以跳过(后续通过 补充)。

以下以
Slack 为例,详见第 3 步。
配置完成后可运行诊断命令验证:
全部显示 ✅ 即表示配置成功。
在第 2.4 步选择 Slack 后,向导会提示你先去 Slack API 控制台创建 App 并获取 Token。以下是详细步骤:
💡 OpenClaw 支持多种聊天渠道(Telegram、WhatsApp、Discord、Signal 等),这里以
Slack 为例。
3.1 创建 Slack App
- 打开 Slack API 控制台
- 点击 Create New App → 选择 From scratch
- 输入 App 名称(如 ),选择你的工作区
- 点击 Create App

3.2 配置 Bot 权限并安装到工作区
手动配置方式:
- 在左侧菜单点击 OAuth & Permissions

- 滚动到 Bot Token Scopes,点击 Add an OAuth Scope,添加以下权限:

- 还需要配置以下内容:
- 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:添加 命令

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

- 在弹出的授权页面点击 Allow

- 安装完成后,复制页面上显示的 Bot User OAuth Token
⚠️ 这个 Token 以 开头,类似:
请妥善保存,后面在 onboard 向导中需要输入。
3.3 获取 App 级别 Token
- 在左侧菜单点击 Basic Information

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

- 输入 Token 名称(如 )
- 点击 Add Scope,选择
- 点击 Generate

- 复制生成的 Token
⚠️ 这个 Token 以 开头,类似: 同样请妥善保存。
3.4 在 onboard 向导中输入 Token
回到 向导,当出现以下提示时依次输入:
3.5 配置频道访问权限
输入完 Token 后,向导会继续提示配置频道权限:
💡 allowlist 怎么填:
- 支持三种格式:、、(如 )
- 示例:
- 留空:Bot 在所有频道都能响应(适合测试)
- 私聊始终可用,allowlist 只影响频道中的 @提及响应

3.6 配置技能(Skills)
频道配置完成后,向导会显示技能状态并询问是否配置:
接下来向导会逐一询问是否配置各技能的 API Key:

💡 这些 API Key 都是可选的,用于特定技能。没有的话全部选
No 跳过即可,后续可通过 随时补充。
3.7 配置 Hooks(自动化钩子)
建议全部启用(默认已全选),这三个 Hook 的作用:
💡 后续可通过以下命令管理 Hooks:
- — 查看所有 Hooks
- — 启用
- — 禁用

3.8 安装 Gateway 服务
向导会自动完成以下操作(无需手动干预):
- Systemd 配置(仅 Linux):启用 systemd lingering,防止退出登录后服务被终止
- Gateway 服务安装:自动安装 systemd 服务,确保网关持续运行
<!—->
安装完成后,向导会自动验证 Slack 连接:
看到 表示 Slack 连接成功 ✅

3.9 Control UI 信息
向导会显示 Web 控制面板的访问地址:
💡 记住这个地址,后续可以通过浏览器访问 Web 控制面板与 Bot 对话。
也可以随时运行 打开。
3.10 孵化 Bot(Hatch)
这是 onboard 的最后一步,选择如何首次启动你的 Bot:
选择 Hatch in TUI 后,会自动进入终端聊天界面:
Bot 会发送 “Wake up, my friend!” 作为第一条消息。你可以开始和它对话,告诉它你的需求和偏好——描述越详细,后续体验越好。
💡 退出 TUI:按 即可退出。Bot 的 Gateway 服务仍在后台运行。
3.11 验证 Slack 连接
- 打开你的 Slack 工作区
- 在左侧栏找到 OpenClaw(如果没看到,点击 + → Browse apps 搜索)

- 给它发一条私聊消息,比如:
- 如果收到回复,说明配置成功 ✅
💡 你也可以在任意频道中 @openclaw 来调用它,比如:
- 如果出现 access not configured 则需要根据提示在终端上进行配置 ,如图所示:

OpenClaw 有两个核心概念需要区分:
💡
关键点:只要 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 还不够聪明没有自动装依赖,也可以手动一条命令搞定:
CLI 未安装的话参考 安装指南,装完后执行 刷新环境变量。

其他所有操作(装依赖、跑脚本、发消息、改文件等)OpenClaw 都能自主完成,无需你干预。
配置好 API Key 后,OpenClaw 就是一个有手有脚的 AI 助手——它不仅能聊天,还能操作你的电脑、访问互联网、执行代码。以下是具体的使用场景和示例。
在 Slack 或 Web 控制面板中直接发消息:
OpenClaw 可以直接在你的机器上执行命令:
💡 需先配置 Gmail,详见 第三节 3.2,一条命令搞定,无需手动装 SMTP。
OpenClaw 内置浏览器控制能力,可以帮你操作网页:
OpenClaw 支持安装和创建技能插件,扩展更多能力:
你也可以从社区安装现成的技能:
配置好 Slack 后,你可以在电脑或手机 Slack App 中随时发消息给 OpenClaw:
- 官网: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
