第4章 - 引导向导配置

嗨，朋友！OpenClaw 已经装好了，现在我们来运行引导向导，一步步完成初始化配置。这个向导非常贴心，会引导你设置好所有必要的东西。

🚀 启动引导向导

打开终端，运行：

openclaw onboard --install-daemon

📋 向导步骤详解

向导会依次引导你完成以下配置：

1. 选择 AI 模型 🤖

向导会问你想用哪个 AI 模型：

? Select your AI model provider:
  ❯ Anthropic (Claude) - Recommended
    OpenAI (GPT)
    Local model

建议选择 Anthropic Claude，官方强烈推荐 Claude Opus 4.6，它有更好的长上下文能力和安全性。

2. 配置 API Key 🔑

输入你在上一章准备好的 API Key：

? Enter your Anthropic API key: sk-ant-xxxxxxxxxxxxx

3. 设置 Gateway 🌐

向导会配置 Gateway 的监听地址和端口：

? Gateway port (default: 18789): 18789

默认端口 18789 通常不需要修改。Gateway 默认只监听 127.0.0.1（本地），这是最安全的方式。

4. 安装守护进程 🔄

在 Linux 上，向导会自动创建 systemd 用户服务：

✓ Installed systemd user service
✓ Gateway daemon will start on boot

这意味着 OpenClaw Gateway 会：

• 随系统自动启动
• 崩溃后自动重启
• 在后台安静运行

⚙️ 手动配置（进阶）

如果你想手动修改配置，编辑 ~/.openclaw/openclaw.json：

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "gateway": {
    "port": 18789,
    "bind": "127.0.0.1"
  }
}

常用配置项

🔍 验证配置

向导完成后，验证一切是否正常：

# 检查 Gateway 状态
openclaw gateway status

# 预期输出
# ✓ Gateway is running on 127.0.0.1:18789

# 打开 Dashboard（在本地浏览器）
openclaw dashboard

# 预期输出
# Dashboard available at http://127.0.0.1:18789/

# 发送一条测试消息
openclaw agent --message "你好，我是你的新主人！" --thinking high

如果一切正常，你应该能看到 AI 的回复。恭喜你，OpenClaw 已经在你的 Linux 上跑起来了！🎉

🔄 重新运行向导

如果你想重新配置，随时可以再次运行：

openclaw onboard

📂 环境变量

OpenClaw 支持通过环境变量自定义一些路径：

# 设置 OpenClaw 主目录
export OPENCLAW_HOME=/custom/path

# 设置状态目录
export OPENCLAW_STATE_DIR=/custom/state

# 设置配置文件路径
export OPENCLAW_CONFIG_PATH=/custom/openclaw.json

你可以把这些添加到 ~/.bashrc 中使其永久生效：

echo 'export OPENCLAW_HOME=~/.openclaw' >> ~/.bashrc
source ~/.bashrc

💪 练习题

1. openclaw onboard --install-daemon 中 --install-daemon 的作用是什么？
2. OpenClaw 的默认 Gateway 端口是多少？
3. 为什么不建议把 gateway.bind 设为 0.0.0.0？

下一步: 第5章 - Gateway 网关 →