OpenClaw快速上手指南：安装、配置与使用教程

#
OpenClaw Provider选择页面调出
指南
OpenClaw的Provider选择页面通常出现在首次
安装后的初始
配置阶段，或者是通过特定
配置命令触发的设置界面。以下是多种调出该页面的方法： 方法一：通过Web UI重新运行设置向导 1. 访问
OpenClaw Web界面 “`bash # 确保
OpenClaw服务正在运行 # 在浏览器中访问 http
://localhost
:3000 “` 2. 触发设置向导 如果服务正常运行但无法看到Provider选择页面，可以尝试以下操作： “`bash # 停止当前服务 npm run stop # 清除
配置并重新启动 rm -f
openclaw.json npm run start “` 首次启动时会自动进入设置向导，其中就包含Provider选择步骤[ref_1]。 方法二：通过
配置文件手动修改 1. 定位
配置文件 “`bash #
OpenClaw主
配置文件通常位于： # Linux/macOS
: ~/.
openclaw/
openclaw.json # Windows
: C
:Users[用户名].
openclaw
openclaw.json “` 2. 编辑
配置文件 “`json “` 将`setup_completed`设置为`false`，然后重启服务[ref_6]。 方法三：
使用命令行工具 1. 重置
配置命令 “`bash # 进入
OpenClaw
安装目录 cd /path/to/
openclaw # 执行
配置重置（具体命令可能因版本而异） npx
openclaw config –reset # 或 npm run setup “` 2. 重新
配置Provider “`bash # 添加自定义Provider的示例命令 npx
openclaw provider add –name “custom-ollama” –type “custom” –base-url “http
://127.0.0.1
:11434/v1″ “` 方法四：特定部署场景下的调出方式 场景1：macOS + 自定义模型 在macOS环境下，通过修改Custom Provider
配置来触发选择界面： “`yaml # 在Provider
配置中确保以下参数正确 provider_type
: “custom” api_base_url
: “你的API基础地址” api_key
: “你的API密钥” model_id
: ”
使用的模型ID” endpoint_id
: “端点标识” “`
配置完成后，重启Gateway服务即可看到Provider管理界面[ref_1]。 场景2：Ollama本地集成 当集成Ollama本地大模型时： “`bash # 确保Ollama服务运行 ollama serve # 修改
OpenClaw
配置指向Ollama # 在Provider设置中选择”Custom”类型，
配置： API Base URL
: http
://127.0.0.1
:11434/v1 API Key
: 留空或任意值 Model ID
: 你的Ollama模型名称 “` 保存
配置后，Provider选择页面会显示连接状态[ref_3]。 场景3：局域网部署 在Linux服务器局域网部署时： “`bash # 修改网络
配置支持远程访问 # 编辑
openclaw.json { “mode”
: “remote”, “bind”
: “0.0.0.0”, “port”
: 3000 } “` 然后通过浏览器访问`http
://[服务器IP]openclaw
:3000`即可进入设置界面[ref_4][ref_6]。 常见问题排查 问题1：页面无法访问 “`bash # 检查服务状态 ps aux | grep
openclaw # 检查端口占用 netstat -tulpn | grep 3000 # 重启服务 npm run restart “` 问题2：Provider
配置不生效 “`bash # 检查日志 t
ail -f logs/
openclaw.log # 验证
配置文件权限 chmod 644
openclaw.json “` 问题3：Gateway服务启动失败 “`bash # 设置开发模式环境变量 export RUN_MODE=dev npm run start “` 这在macOS环境下尤其重要，能够解决因环境
配置导致的启动问题[ref_1]。 Provider
配置参数详解 | 参数名称 | 说明 | 示例值 | 必填 | |———|——|——–|——| | provider_type | 提供商类型 | custom/open
ai/azure | 是 | | api_base_url | API基础地址 | http
://127.0.0.1
:11434/v1 | 是 | | api_key | API密钥 | sk-xxx（或留空） | 否 | | model_id | 模型标识 | qwen2.5
:7b | 是 | | endpoint_id | 端点标识 | custom-ollama | 是 | | context_window | 上下文窗口 | 8192 | 否 | 总结 调出
OpenClaw的Provider选择页面主要依赖于正确
配置和服务的正常运行状态。通过Web UI访问、
配置文件修改、命令行工具等多种方式都可以实现这一目标。关键是要确保`setup_completed`标志为false，并且服务以正确的模式运行。不同部署环境（macOS、Linux、本地Ollama集成等）可能需要特定的
配置调整，但核心原理都是触发系统的初始设置流程[ref_1][ref_3][ref_6]。