初始配置

首次使用 OpenClaw 的用户会经历一个称为"初始配置"的交互式设置流程。

它处理所有初始配置：

• AI 模型提供商选择和认证（OAuth 或 API 密钥）
• 消息通道设置（WhatsApp、Telegram、Discord 等）
• 默认技能和工作区存储配置
• 可选的后台守护进程服务安装

启动向导

# 启动交互式向导
openclaw onboard

# 跳过向导，使用最小默认配置（需要手动配置）
openclaw onboard --skip

向导流程

第 1 步：账户设置

• 用户名：你的显示名称（智能体使用此称呼你）
• 语言：界面和智能体的首选语言
• 时区：确保定时任务和消息时间正确

第 2 步：模型选择

• 提供商：选择 OpenAI、Anthropic、Ollama 或其他支持的提供商
• 认证：
  • OAuth（推荐）：基于浏览器的登录，无 API 密钥暴露风险
  • API 密钥：直接输入密钥，更简单但需要安全存储
• 连接测试：向导验证 API 连接

第 3 步：通道配置

• 选择通道：勾选要启用的消息平台
• 登录方式：
  • WhatsApp：扫码
  • Telegram/Discord：输入 Bot Token
• 设为默认：选择一个主要接收消息的通道

第 4 步：技能选择

• 浏览技能：查看可用技能列表（浏览器、记忆、文件管理等）
• 启用技能：选择需要的技能；有些需要额外配置
• 跳过：技能可以稍后通过命令或配置文件添加

第 5 步：完成并启动

• 配置生成：所有设置保存到 ~/.openclaw/
• 服务启动：网关自动在端口 18789 启动
• 访问：在 http://127.0.0.1:18789/ 本地访问开始聊天

跳过或重新运行

使用现有配置

如果你已有配置文件，跳过向导直接启动：

openclaw onboard --config /path/to/your/config.json

重新配置

要修改设置，重新运行向导：

openclaw onboard --reset

这会清除现有配置并重新运行向导。注意：这不会删除工作区文件或记忆数据。

认证文件位置

OAuth 认证（浏览器登录）

• 文件路径：~/.openclaw/credentials/oauth.json
• 内容：访问令牌和刷新令牌
• 安全提示：此文件包含敏感凭据；不要分享或提交到代码仓库

API 密钥认证

• 存储：系统密钥链（macOS Keychain、Linux libsecret 等）
• 不会以明文保存到文件
• 向导引导你完成安全存储

无头服务器环境

如果网关运行在没有浏览器的服务器上：

1. 本地完成 OAuth：先在有浏览器的机器上运行向导
2. 复制凭据：将 ~/.openclaw/credentials/oauth.json 传输到服务器的相同位置
3. 启动服务：运行 openclaw gateway 启动网关

了解更多：模型提供商