OpenClaw 基础配置

安装完成后，需要进行基础配置才能正常使用。本教程将引导你完成 Gateway 启动、模型认证和工作空间设置。

配置方式

OpenClaw 提供两种配置方式：交互式引导向导（openclaw onboard）和手动命令行配置（openclaw configure）。新手推荐使用引导向导。

第一步：运行引导向导

安装完成后，引导向导会自动启动。如果没有，可以手动运行：

bash

openclaw onboard

引导向导会依次帮你完成：

Gateway（网关服务）的安装与启动
模型提供商认证配置
工作空间目录创建
频道（聊天平台）接入设置

第二步：启动 Gateway

Gateway 是 OpenClaw 的核心服务，负责处理 AI 请求：

bash

# 查看 Gateway 状态
openclaw gateway status

# 安装并启动 Gateway（后台运行）
openclaw gateway install
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

Gateway 必须在运行

所有 AI 请求都通过 Gateway 处理，请确保它处于运行状态。 macOS 会自动安装 LaunchAgent，Linux 会安装 systemd 用户服务，实现开机自启动。

第三步：配置模型认证

至少配置一个模型提供商，Gateway 才能处理 AI 请求：

bash

# 查看支持的模型列表
openclaw models list

# 配置 Anthropic（Claude）
openclaw infer auth login --provider anthropic

# 配置 OpenAI
openclaw infer auth login --provider openai

# 查看当前认证状态
openclaw infer auth status

多个提供商

OpenClaw 支持同时配置多个模型提供商，可以在使用时灵活切换。

第四步：设置工作空间

工作空间是 OpenClaw 管理项目和文件的地方：

bash

# 查看当前工作空间路径
openclaw config get agents.defaults.workspace

# 修改工作空间路径
openclaw setup --workspace ~/my-projects

第五步：测试首次对话

配置完成后，启动终端聊天测试：

bash

# 启动终端聊天界面
openclaw tui

# 或使用快捷命令
openclaw chat

配置完成！

你已经成功完成 OpenClaw 的基础配置。接下来可以阅读“第三方模型接入”教程了解更多模型配置选项。

常用配置命令速查

命令	说明
`openclaw onboard`	运行完整引导向导
`openclaw configure`	修改已有配置
`openclaw config get <key>`	查看配置项
`openclaw config set <key> <value>`	修改配置项
`openclaw doctor`	诊断配置问题
`openclaw status`	查看整体状态