OpenClaw 用户使用手册

#
OpenClaw Gateway 网关安装完整指南 问题解构与方案推演 针对
OpenClaw Gateway 网关安装问题，我将其分解为以下几个关键步骤进行分析和推演： 1. 环境准备阶段 – Node.js 环境验证与依赖检查 2. 核心安装阶段 –
OpenClaw CLI 工具安装与网关配置 3. 服务启动阶段 – 网关守护进程部署与启动 4. 验证测试阶段 – 网关服务连通性验证 下面将基于参考资料提供详细的安装方案和具体操作步骤。 详细安装步骤 1. 环境准备与前置检查 在进行
OpenClaw Gateway 安装之前，必须确保系统环境满足以下要求： | 环境组件 | 版本要求 | 检查命令 | 备注说明 | |———|———|———-|———-| | Node.js | ≥ v22.0.0 | `node -v` | 必须使用 v22.0.0 或更高版本 [ref_1] | | npm | 最openclaw新版本 | `npm -v` | 包管理器，随 Node.js 自动安装 | | 系统权限 | 管理员权限 | – | Windows 需使用管理员身份运行 CMD | 环境验证代码示例： “`bash # 检查 Node.js 版本 node -v # 检查 npm 版本 npm -v # 如果版本不满足要求，需要先升级 Node.js # 可以从 Node.js 官网下载最新版本进行安装 [ref_1] “` 2.
OpenClaw CLI 全局安装 使用 npm 进行全局安装，这是网关安装的基础： “`bash # 使用管理员权限打开 CMD 或 PowerShell 执行以下命令 npm install -g
openclaw-cn@latest “` 安装完成后验证安装状态： “`bash # 检查安装是否成功及查看版本
openclaw-cn –version “` 3. Gateway 网关配置与安装 这是核心的网关安装步骤，通过交互式向导完成配置： “`bash # 启动网关安装向导
openclaw-cn onboard –install-daemon “` 配置流程详解： 在交互式向导中，需要按顺序完成以下关键配置选择： 1. 守护进程安装：使用键盘左右箭头选择 `yes` 后回车 [ref_1] 2. 安装模式：上下箭头选择”手动”模式后回车 3. 网关类型：选择”本地网关”选项 4. 工作目录：通常直接回车使用默认目录 5. 模型选择：选择 deepseek 模型 6. 认证方式：选择 “DeepSeek API key” 并输入有效的 API 密钥 API Key 配置注意事项： – 需要提前在 DeepSeek 官网创建 API Key [ref_1] – 创建后立即复制保存，因为只能查看一次 – 确保账户有足够余额，否则无法调用大模型 4. 网络与安全配置 完成基础配置后，继续进行网络和安全设置： “`bash # 在向导中继续配置以下参数 “` 配置参数说明表： | 配置项 | 推荐设置 | 说明 | |——-|———-|——| | 端口设置 | 默认端口 | 直接回车使用默认端口 | | 绑定地址 | 127.0.0.1 | 选择 Loopback 确保本地安全 | | 认证方式 | Token | 选择 Token 认证机制 [ref_2] | | 网关名称 | 自定义 | 如：MyGatewayToken，后续访问需要使用 | 5. 通道集成配置 配置与外部平台的集成通道： “`bash # 配置聊天通道，选择 yes # 选择飞书作为集成平台 # 选择使用本地插件路径 # 选择飞书国内版 “` 飞书配置关键步骤： 1. 在飞书开放平台创建机器人应用 [ref_1] 2. 获取 AppID 和 AppSecret 凭证 3. 在向导中依次输入 AppID 和 AppSecret 4. 完成权限配置和版本发布 6. Skill 插件安装 选择必要的功能插件： “`bash # 使用空格键选择以下插件（多选）： # – boot-md # – command-logger # – session-memory # 选择完成后按回车确认 “` 重要提醒：这是多选操作，需要使用空格键进行选择，直接回车会导致选择不完整 [ref_1]。 7. 网关服务启动与验证 安装完成后，启动网关服务： “`bash # 启动网关服务
openclaw gateway run “` 访问验证： 通过浏览器访问网关管理界面： “` http://localhost:18789/chat?session=main&token=YourGatewayToken “` 请将 `YourGatewayToken` 替换为你在配置阶段设置的网关名称 [ref_1]。 8. 浏览器插件配置（可选） 如需
OpenClaw 控制浏览器，需要安装浏览器插件： “`bash # 安装浏览器插件
openclaw browser extension install # 查看插件安装路径
openclaw browser extension path “` 浏览器配置步骤： 1. 打开 Chrome 浏览器，访问 `chrome://extensions` 2. 启用开发者模式 3. 加载已解压的扩展程序，选择插件文件夹 4. 刷新后配置之前设置的 Token 常见问题解决方案 Gateway 启动失败处理 如果遇到网关启动问题，可以尝试以下排查步骤： “`bash # 停止现有服务
openclaw-cn gateway stop # 重新启动
openclaw-cn onboard –install-daemon “` 开机自启管理 如需禁用开机自启动： “`bash # 以管理员身份执行 schtasks /Delete /F /TN ”
OpenClaw Gateway” “` 权限问题处理 在 Windows 系统上，确保始终使用管理员权限运行命令行工具，避免权限相关的安装失败 [ref_1]。 安装验证 checklist 完成安装后，使用以下检查表验证安装状态： – [ ] Node.js 版本 ≥ v22.0.0 – [ ]
OpenClaw CLI 可正常执行 `–version` 命令 – [ ] 网关服务可通过 `
openclaw gateway run` 启动 – [ ] 浏览器可正常访问 `http://localhost:18789` – [ ] Token 认证配置正确 – [ ] 必要的 Skill 插件已安装 – [ ] 飞书集成配置完成（如适用） 通过以上完整的安装流程，你应该能够成功部署
OpenClaw Gateway 网关服务，并开始使用 AI 代理功能。如果在任何步骤遇到问题，建议参考对应的错误信息并重新执行相关配置步骤。