安装 OpenClaw NPM 包

使用 npm i -g openclaw@latest 安装 openclaw npm 包。

安装 openclaw npm 包

安装中

安装成功

配置 OpenClaw

使用 openclaw onboard 进行配置向导。

onboard

这是 OpenClaw 安装完成后进入的首次配置/安全确认界面。

隐私协议

这是 OpenClaw 的初始化配置模式选择。

配置模式

这一页是在让你选择 Gateway（网关）部署方式。在 OpenClaw 里，Gateway 是核心组件——负责：

• 接收请求（CLI / Agent）
• 调用模型（OpenAI / OpenRouter / 本地模型）
• 管理 tools（文件、shell 等执行能力）
• 控制安全边界

可以理解为：Agent 的“大脑调度中心”

网关模式

工作目录。

工作目录

模型提供商。

模型提供商

输入模型提供商的 API key。

API key

API key 输入完成

选择模型。

浏览全部模型

浏览全部模型。

模型列表加载中

模型列表

deepseek-v4-pro

网关端口号。

网关端口号

这一页是在配置 Gateway 的网络暴露范围（bind address），本质是：
👉 你的 OpenClaw 网关“允许谁访问”

网关暴露范围

这一项是在配置 Gateway 的认证机制（Auth），也就是：
👉 谁可以调用你的 OpenClaw 网关，以及怎么验证身份

网关认证方式

这一项是在问：是否通过 Tailscale 把你的 Gateway 暴露出去（跨设备 / 远程访问）。本质是网络暴露策略的“增强版”。

Tailscale 暴露策略

这一项是在问：Gateway 的 token 你打算怎么管理（不是“要不要 token”，而是“存在哪”）。
Generate/store plaintext token
含义：

• 自动生成一个 token
• 直接明文保存在本地配置文件里

Use SecretRef
含义：

• 不直接存 token

• 而是引用“外部密钥来源”（secret manager）

  
  
  生成 Token

生成 Token。

生成 Token

这一页是在问你：要不要现在把 OpenClaw 接入聊天平台（作为机器人/agent）。

Channel 配置

这一页是在配置 Web Search 工具提供商，也就是：
👉 你的 OpenClaw agent “上网查资料”的能力从哪里来

配置搜索引擎

这一页是在问你要不要现在配置 Skills（技能系统）。
✅ Eligible: 7
👉 有 7 个技能可以直接用
⚠️ Missing requirements: 46（重点）
👉 有 46 个技能因为缺依赖不能用

通常原因：

• 没装 Python/Node 依赖
• 没启用 system tools
• 没授权 filesystem / shell
• 或 API key 未配置

👉 这是正常现象（刚安装都会这样）

✅ Unsupported on this OS: 0

👉 没有 Mac 不兼容的技能（很好）

✅ Blocked by allowlist: 0

👉 没有被安全策略禁止（说明默认策略正常）

配置 Skills

配置 Skills。

配置 Skills

Google 的 Places API Key 是用来给 goplaces skill 提供：

• 地点搜索（餐厅、商店、地址）
• POI 数据（评分、营业时间、评论等）

• 地理位置结构化查询

  
  
  Google places api key

这里是在问是否给 OpenClaw 的 Notion skill 配置 API Key。
如果你选 Yes，它会：

• 连接你的 Notion workspace
• 允许 agent 读取/创建/修改页面

• 用于笔记自动化、知识管理等

  
  
  Notion Api key

这里是在问是否给 OpenAI Whisper API（语音转文字） 配置 Key。
涉及 OpenAI 的语音识别服务：
OpenAI Whisper
用途包括：

• 语音转文字（ASR）
• 会议记录转写
• 音频内容解析

• 语音输入 agent

  
  
  Open

这是在配置 ElevenLabs 的 API Key，用于 sag skill（语音生成/语音交互相关能力）。
核心能力通常包括：

• 文本转语音（TTS）
• 高质量语音合成
• agent 语音输出

• 多语音角色生成

  
  
  ElevenLabs

这是在让你安装 OpenClaw 的可选插件系统（plugins），本质是：
👉 给 agent 加“运行时能力 + 观测能力 + 外部集成能力”

配置Plugins

◻ ACPX Runtime
agent 执行扩展运行时
支持更复杂 tool 调用链

👉 等级：高级执行引擎

◻ Diagnostics OpenTelemetry

OpenTelemetry

tracing / metrics / logs
用于调试 agent 行为链路
◻ Diagnostics Prometheus

Prometheus

指标监控（CPU / latency / calls）

👉 这两个都是生产级监控系统

◻ Diffs
文件/代码差异分析
agent 修改内容时用

◻ Google Meet

Google Meet

自动加入会议 / 操作会议内容
◻ Voice Call
语音通话能力（agent 语音交互）

◻ Memory LanceDB

LanceDB

向量数据库记忆系统
让 agent 记住历史信息

👉 这是“长期记忆核心组件”

◻ Lobster
内部调试/实验工具（非核心）

配置时插件

配置时插件

这里是在配置 Hooks（自动化触发器）系统。

OpenClaw 的 Hooks 本质是：

👉 当 agent 执行某些动作时，自动触发“后台逻辑”

配置Hooks

这是在问你要不要把 OpenClaw 的 Gateway 注册成系统级服务（service）。
🔧 Gateway service 是什么？
简单说：
👉 把你刚刚配置的 Gateway，从“手动运行程序”变成“系统后台常驻服务”
🔸 选择 Yes 会发生什么？

• Gateway 会作为后台进程运行
• 开机可自动启动（取决于配置）
• CLI / agent 随时可连接

• 不需要你手动 openclaw gateway start

  
  
  安装 Gateway

这是在选择 Gateway service 的运行时（runtime），也就是：
👉 OpenClaw Gateway 用什么 JS 运行环境来长期运行

Node

Gateway service 安装 ✔（LaunchAgent 已注册）

安装网关服务

🖥 Hatch in Terminal（推荐）✅

OpenClaw 的 CLI TUI 模式

特点：

在终端运行 agent
交互最直接
调试最清晰
最适合开发 / 测试

👉 本质：

“让 agent 在你当前 shell 里醒过来”

启动方式

启动TUI

Wake up, my friend!

配置

小龙虾回复中

小龙虾回复完成

回复

退出中