OpenClaw 安装完后,一般需要进行初始化配置。

其核心就是通过交互式引导,完成一些配置,生成 ~/.openclaw/openclaw.json 文件,如果熟悉该文件内容,也可以直接创建该文件,不需要进行交互式初始化。

openclaw onboard --install-daemon

交互式初始化过程说明:

  1. 安全警告,选择 yes。通过键盘左右键选择,回车确认。
    ◆  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
    │  ● Yes / ○ No
    
  2. 设置运行模式模式,选择默认的 QuickStart。通过上下键选择,回车确认。
    ◆  Setup mode
    │  ● QuickStart (Configure details later via openclaw configure.)
    │  ○ Manual
    
    确认后进行默认的配置。默认的配置只能通过本地环回接口访问(localhost/127.0.0.1),如果需要跨机器访问,也可以在后续修改配置文件。
    ◇  QuickStart ─────────────────────────╮
    │                                      │
    │  Gateway port: 18789                 │
    │  Gateway bind: Loopback (127.0.0.1)  │
    │  Gateway auth: Token (default)       │
    │  Tailscale exposure: Off             │
    │  Direct to chat channels.            │
    │                                      │
    ├──────────────────────────────────────╯
    
  3. 模型提供商配置,选择最后一个 Skip for now 跳过配置。提供大模型服务的厂商,后续单独进行模型配置。
    ◆  Model/auth provider
    │  ○ Anthropic
    │  ○ BytePlus
    │  ○ Chutes
    │  ○ Cloudflare AI Gateway
    │  ○ Copilot
    │  ○ Custom Provider
    │  ○ DeepSeek
    │  ○ Google
    │  ○ Hugging Face
    │  ○ Kilo Gateway
    │  ○ Kimi Code
    │  ○ LiteLLM
    │  ○ MiniMax
    │  ○ Mistral AI
    │  ○ Moonshot AI (Kimi K2.5)
    │  ○ Ollama
    │  ○ OpenAI
    │  ○ OpenCode
    │  ○ OpenRouter
    │  ○ Qianfan
    │  ○ Qwen
    │  ○ Qwen (Alibaba Cloud Model Studio)
    │  ○ SGLang
    │  ○ Synthetic
    │  ○ Together AI
    │  ○ Venice AI
    │  ○ Vercel AI Gateway
    │  ○ vLLM
    │  ○ Volcano Engine
    │  ○ xAI (Grok)
    │  ○ Xiaomi
    │  ○ Z.AI
    │  ● Skip for now
    
  4. 模型列表提供商,选择默认 All providers。这个配置后续配置模型时会镜像修改,主要用于在Web页面聊天窗口切换模型列表的选项。
    ◆  Filter models by provider
    │  ● All providers
    │  ○ amazon-bedrock
    │  ○ anthropic
    │  ○ azure-openai-responses
    │  ○ cerebras
    │  ○ github-copilot
    │  ○ google
    │  ○ google-antigravity
    │  ○ google-gemini-cli
    │  ○ google-vertex
    │  ○ groq
    │  ○ huggingface
    │  ○ kimi-coding
    │  ○ minimax
    │  ○ minimax-cn
    │  ○ mistral
    │  ○ ollama
    │  ○ openai
    │  ○ openai-codex
    │  ○ opencode
    │  ○ opencode-go
    │  ○ openrouter
    │  ○ vercel-ai-gateway
    │  ○ xai
    │  ○ zai
    
  5. 设置默认模型,选择一个模型作为默认模型,回车确认。这里主要是配置默认模型,后续调用模型时,如果没有指定模型,则使用默认模型。该配置后续会覆盖修改。
    ◆  Default model
    │  ● Keep current (default: anthropic/claude-opus-4-6)
    │  ○ Enter model manually
    │  ○ amazon-bedrock/anthropic.claude-3-haiku-20240307-v1:0
    │  ○ amazon-bedrock/anthropic.claude-3-5-haiku-20241022-v1:0
    │  ○ amazon-bedrock/anthropic.claude-haiku-4-5-20251001-v1:0
    │  ○ amazon-bedrock/eu.anthropic.claude-haiku-4-5-20251001-v1:0
    │  ○ amazon-bedrock/global.anthropic.claude-haiku-4-5-20251001-v1:0
    │  ○ amazon-bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0
    │  ○ amazon-bedrock/anthropic.claude-opus-4-20250514-v1:0
    ......
    
  6. 配置IM渠道,选择Skip for now。这里主要是配置通过哪些渠道连接OpenClaw,如QQ、飞书、钉钉等,后面会单独进行配置。
    ◆  Select channel (QuickStart)
    │  ○ Telegram (Bot API)
    │  ○ WhatsApp (QR link)
    │  ○ Discord (Bot API)
    │  ○ IRC (Server + Nick)
    │  ○ Google Chat (Chat API)
    │  ○ Slack (Socket Mode)
    │  ○ Signal (signal-cli)
    │  ○ iMessage (imsg)
    │  ○ LINE (Messaging API)
    │  ○ Feishu/Lark (飞书)
    │  ○ Nostr (NIP-04 DMs)
    │  ○ Microsoft Teams (Teams SDK)
    │  ○ Mattermost (plugin)
    │  ○ Nextcloud Talk (self-hosted)
    │  ○ Matrix (plugin)
    │  ○ BlueBubbles (macOS app)
    │  ○ Zalo (Bot API)
    │  ○ Zalo (Personal Account)
    │  ○ Synology Chat (Webhook)
    │  ○ Tlon (Urbit)
    │  ○ Twitch (Chat)
    │  ● Skip for now (You can add channels later via `openclaw channels add`)
    
  7. 配置Web搜索服务,选择Skip for now跳过。部分搜索需要注册配置APKEY才能使用,后续可单独配置。
    ◆  Search provider
    │  ○ Brave Search
    │  ○ DuckDuckGo Search (experimental)
    │  ○ Exa Search
    │  ○ Firecrawl Search
    │  ○ Gemini (Google Search)
    │  ○ Grok (xAI)
    │  ○ Kimi (Moonshot)
    │  ○ Perplexity Search
    │  ○ Tavily Search
    │  ● Skip for now (Configure later with openclaw configure --section web)
    
  8. 配置SKILL,选择 No。OpenClaw会有一些默认安装的SKILL,额外的SKILL可以通过 ClawHub 进行查询和安装,后续按需安装即可。
    ◆  Configure skills now? (recommended)
    │  ○ Yes / ● No
    
  9. 启动哪些hooks,选择第一个 Skip for now。通过键盘上的空格键进行选择,然后回车。hooks用于OpenClaw和大模型沟通过程中添加的额外信息。
    ◆  Enable hooks?
    │  ◼ Skip for now
    │  ◻ 🚀 boot-md
    │  ◻ 📎 bootstrap-extra-files
    │  ◻ 📝 command-logger
    │  ◻ 💾 session-memory
    
  10. 使用哪种方式访问OpenClaw?选择Open the Web UI就会自动打开浏览器访问OpenClaw页面。
    ◆  How do you want to hatch your bot?
    │  ○ Hatch in TUI (recommended)
    │  ● Open the Web UI
    │  ○ Do this later
    
  11. 完成后的信息,输出完成后就会退出初始化步骤。
    ◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
    │                                                                                  │
    │  Dashboard link (with token):                                                    │
    │  http://127.0.0.1:18789/#token=5040bd14cd0d8f838f83bd41226a598ba2a4d347428ec67d  │
    │  Opened in your browser. Keep that tab to control OpenClaw.                      │
    │                                                                                  │
    ├──────────────────────────────────────────────────────────────────────────────────╯
    │
    ◇  Workspace backup ────────────────────────────────────────╮
    │                                                           │
    │  Back up your agent workspace.                            │
    │  Docs: https://docs.openclaw.ai/concepts/agent-workspace  │
    │                                                           │
    ├───────────────────────────────────────────────────────────╯
    │
    ◇  Security ──────────────────────────────────────────────────────╮
    │                                                                 │
    │  Running agents on your computer is risky — harden your setup:  │
    │  https://docs.openclaw.ai/security                              │
    │                                                                 │
    ├─────────────────────────────────────────────────────────────────╯
    │
    ◇  Shell completion ───────────────────────────────────────────────────────╮
    │                                                                          │
    │  Shell completion installed. Restart your shell or run: source ~/.zshrc  │
    │                                                                          │
    ├──────────────────────────────────────────────────────────────────────────╯
    │
    ◇  Web search ───────────────────────────────────────╮
    │                                                    │
    │  Web search was skipped. You can enable it later:  │
    │    openclaw configure --section web                │
    │                                                    │
    │  Docs: https://docs.openclaw.ai/tools/web          │
    │                                                    │
    ├────────────────────────────────────────────────────╯
    │
    ◇  What now ─────────────────────────────────────────────────────────────╮
    │                                                                        │
    │  What now: https://openclaw.ai/showcase ("What People Are Building").  │
    │                                                                        │
    ├────────────────────────────────────────────────────────────────────────╯
    │
    └  Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.