OpenClaw 安装完后,一般需要进行初始化配置。
其核心就是通过交互式引导,完成一些配置,生成 ~/.openclaw/openclaw.json 文件,如果熟悉该文件内容,也可以直接创建该文件,不需要进行交互式初始化。
openclaw onboard --install-daemon
交互式初始化过程说明:
- 安全警告,选择
yes。通过键盘左右键选择,回车确认。◆ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? │ ● Yes / ○ No - 设置运行模式模式,选择默认的
QuickStart。通过上下键选择,回车确认。
确认后进行默认的配置。默认的配置只能通过本地环回接口访问(localhost/127.0.0.1),如果需要跨机器访问,也可以在后续修改配置文件。◆ Setup mode │ ● QuickStart (Configure details later via openclaw configure.) │ ○ Manual◇ QuickStart ─────────────────────────╮ │ │ │ Gateway port: 18789 │ │ Gateway bind: Loopback (127.0.0.1) │ │ Gateway auth: Token (default) │ │ Tailscale exposure: Off │ │ Direct to chat channels. │ │ │ ├──────────────────────────────────────╯ - 模型提供商配置,选择最后一个
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 - 模型列表提供商,选择默认
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 - 设置默认模型,选择一个模型作为默认模型,回车确认。这里主要是配置默认模型,后续调用模型时,如果没有指定模型,则使用默认模型。该配置后续会覆盖修改。
◆ 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 ...... - 配置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`) - 配置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) - 配置SKILL,选择
No。OpenClaw会有一些默认安装的SKILL,额外的SKILL可以通过 ClawHub 进行查询和安装,后续按需安装即可。◆ Configure skills now? (recommended) │ ○ Yes / ● No - 启动哪些hooks,选择第一个
Skip for now。通过键盘上的空格键进行选择,然后回车。hooks用于OpenClaw和大模型沟通过程中添加的额外信息。◆ Enable hooks? │ ◼ Skip for now │ ◻ 🚀 boot-md │ ◻ 📎 bootstrap-extra-files │ ◻ 📝 command-logger │ ◻ 💾 session-memory - 使用哪种方式访问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 - 完成后的信息,输出完成后就会退出初始化步骤。
◇ 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.