准备

• Windows 电脑
• 公司提供的 URL 和 Key
• 依赖 Node.js（建议 v18 及以上，安装时勾选 Add to PATH，安装完成重启终端）

实际操作（不完全截图）

1. 全局安装 OpenClaw

npminstall-gopenclaw@latest

从终端输出可见：npm install -g openclaw@latest执行成功，新增 306 个依赖包，无报错，OpenClaw 全局安装完成。66 packages are looking for funding是 npm 开源项目捐赠提示，不影响功能使用，可忽略。

2. 初始化配置

运行openclaw onboard进入向导。

提示信息：I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? Yes / No
翻译：我已知晓该程序默认可单人使用，多用户共用场景必须进行安全加固，是否继续？
光标默认选中 Yes，因我的需求是本地网页单人沟通，无公网暴露，所以选择 Yes。

3. 进入 Setup mode（安装模式选择）

两个选项：

• QuickStart (recommended)（推荐快速启动，已被选中）：本地最简部署，后续可通过openclaw configure修改全部配置，完全匹配「仅本地网页沟通」的需求。
• Manual setup：手动高级配置，适合多网关、内网隔离、自定义权限等复杂场景，当前无需选用。

选择 QuickStart 回车继续。

4. 选择模型

• Gateway port: 18789 → 网页访问端口 http://127.0.0.1:18789
• Gateway bind: Loopback (127.0.0.1) → 仅本机可访问，安全无外网暴露
• Tailscale exposure: Off → 不对外公网，完全符合单人本地网页沟通需求

接入非内置的第三方模型服务，即公司提供的 Token API 聚合平台，可以一站式聚合全球大模型调用能力。

注意事项：因当前已有公司提供的 URL 和 Key，模型需要选择 Custom Provider。
参考链接：openclaw如何配置第三方大模型 API Key

按 ⬇️ More 回车，找到 Custom Provider 回车。

5. 输入 URL 及 Key 信息

此时我这里出现了问题，报 401 Verification failed，于是重新输入一遍。

6. Select channel

快速部署，不搞其他的，直接跳过 Skip for now。

7. Search Provider

直接跳过，选择 Skip for now。

本地网页单人沟通，没有特别复杂的事项，所以直接跳过。

8. Select channel（通道选择）

这里是对接第三方聊天软件（飞书、企业微信、QQ、网页等）。

我的需求是仅浏览器页面沟通，不需要对接 IM 软件，因此直接选择底部 Skip for now 跳过通道配置。当前光标已选中 Skip for now，直接按回车键跳过第三方聊天通道配置。

说明：只需要网页端对话，无需对接飞书、企业微信、QQ 等 IM 工具，后续需要可再配置。

9. Search provider（搜索引擎配置）

同样默认跳过。

回车跳过通道后会进入此页面，光标已选中 Skip for now，再次按回车键跳过网页搜索工具配置。

说明：该功能是联网检索资料插件，日常纯对话场景可先不配置，后续需要联网搜索再执行命令添加。

10. Configure skills now?

选择 Yes 或 No。

• Yes：现在配置全部工具，需要安装大量系统依赖，步骤繁琐，且大部分 Windows 不兼容，对你仅网页对话的需求无必要。
• No：跳过工具配置，仅保留基础对话能力，不安装额外文件操作、系统执行类工具，部署速度更快，安全性更高，适配纯网页聊天需求。

11. 验证访问

配置完成后，打开浏览器访问http://127.0.0.1:18789，即可看到 OpenClaw 网页对话界面。首次加载可能需要几秒钟，如页面正常显示则说明安装配置成功。

网关问题

安装配置完成后，如果遇到网关无法启动或访问失败的情况，请按以下步骤排查：

1. 运行openclaw status检查网关运行状态。
2. 运行openclaw doctor进行全面环境诊断。
3. 检查防火墙是否放行了端口 18789。
4. 确认 Node.js 已正确安装并已添加到 PATH 环境变量。
5. 如仍无法解决，可尝试重新运行openclaw onboard重新配置。

问题汇总

1. 直接配置 DeepSeek

如直连 DeepSeek，按照如下方法：Model/auth provider 选择 DeepSeek。

• Download from npm（当前已选中，推荐）：从 npm 官方源下载 DeepSeek 插件，国内网络兼容性更好，下载稳定，优先选这个。
• Download from ClawHub：官方内置仓库源，海外网络更友好，国内容易超时。
• Skip for now：暂时跳过插件安装，后续在网页面板手动添加 DeepSeek 模型。

输入 Key 之后回车，DeepSeek 插件已安装、API 密钥已录入，默认模型自动设置为deepseek/deepseek-chat，光标当前选中 Keep current（保留当前模型）。

三个选项作用：

• Keep current (deepseek/deepseek-chat)（已选中，推荐）：直接使用当前默认模型，响应速度快、成本低，满足日常页面沟通需求。
• Enter model manually：手动输入其他 DeepSeek 模型 ID（如 deepseek-reasoner、deepseek-v2 等）。
• Browse all models：浏览完整 DeepSeek 模型列表，可视化选择。

2. 页面报错

显示模型配置问题，Key 无效。可能是配置出错，重新运行openclaw configure进行配置。

常用指令

（1）查看版本
openclaw --version

（2）环境全面诊断（检查依赖、网关、权限）
openclaw doctor

（3）查看网关运行状态
openclaw status

（4）前台启动网关（临时测试）
openclaw gateway run

（5）注册开机自启后台服务
openclaw gateway install

（6）停止网关服务
openclaw gateway stop

（7）卸载 OpenClaw
npm uninstall -g openclaw

（8）查询 Token 访问网址
openclaw token

（9）初始化向导（首次安装用）
openclaw onboard

（10）精细化局部修改（日常调试用）
openclaw