本页是 本地模式（默认）会引导你完成以下内容：<\/p>\n 远程模式会将此机器配置为连接到其他位置的网关。 * 如果 \n * 完整选项矩阵见 身份验证和模型选项<\/a>。\n <\/p>\n \n * 默认值为 \n * 会提示你输入端口、绑定、身份验证模式和 tailscale 暴露设置。 \n * WhatsApp<\/a>：可选 QR 登录 \n * macOS：LaunchAgent \n * 启动 Gateway 网关（如有需要），并运行 \n * 读取可用的 Skills 并检查要求。 \n * 显示摘要和后续步骤，包括 iOS、Android 和 macOS 应用选项。<\/p>\n \n 如果未检测到 GUI，向导会打印用于控制 UI 的 SSH 端口转发说明，而不是打开浏览器。 远程模式会将此机器配置为连接到其他位置的网关。<\/p>\n \n 远程模式不会在远程主机上安装或修改任何内容。\n<\/p>\n 你需要设置的内容：<\/p>\n \n – 如果网关仅绑定到 loopback，请使用 SSH 隧道或 tailnet。 如果存在 \n * macOS：检查 Keychain 条目 “Claude Code-credentials” \n 在任意机器上运行 \n 如果存在 \n 浏览器流程；粘贴 \n 如果存在 \n 提示输入 \n 提示输入 \n 会为你存储该密钥。\n <\/p>\n \n 提示输入 \n 提示输入账户 ID、Gateway ID 和 \n 配置会自动写入。 \n 提示输入 \n 提示输入基础 URL（默认 \n Moonshot（Kimi K2）和 Kimi Coding 配置会自动写入。 \n 适用于兼容 OpenAI 和兼容 Anthropic 的端点。<\/p>\n \n 保持身份验证未配置。<\/p>\n 模型行为：<\/p>\n 凭证和配置档案路径：<\/p>\n 凭证存储模式：<\/p>\n \n 无头和服务器提示：在有浏览器的机器上完成 OAuth，然后复制 WhatsApp 凭证位于 \n 某些渠道以插件形式交付。在设置期间选择这些渠道时，向导 Gateway 网关向导 RPC：<\/p>\n 客户端（macOS 应用和控制 UI）可以在不重新实现新手引导逻辑的情况下渲染步骤。<\/p>\n Signal 设置行为：<\/p>\n CLI 设置参考 本页&# […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-273","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/273","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=273"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/273\/revisions"}],"predecessor-version":[{"id":786,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/273\/revisions\/786"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=273"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=273"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=273"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}openclaw onboard<\/code> 的完整参考。
\n简短指南请参见 设置向导（CLI）<\/a>。<\/p>\n向导会执行什么<\/h2>\n
\n
\n它不会在远程主机上安装或修改任何内容。<\/p>\n本地流程详情<\/h2>\n
~\/.openclaw\/openclaw.json<\/code> 存在，可选择 Keep、Modify 或 Reset。
\n * 重新运行向导不会清除任何内容，除非你明确选择 Reset（或传递 --reset<\/code>）。
\n * CLI --reset<\/code> 默认作用于 config+creds+sessions<\/code>；使用 --reset-scope full<\/code> 还会删除工作区。
\n * 如果配置无效或包含旧版键，向导会停止，并要求你先运行 openclaw doctor<\/code> 再继续。
\n * Reset 使用 trash<\/code>，并提供以下范围：
\n * 仅配置
\n * 配置 + 凭证 + 会话
\n * 完全重置（也会删除工作区）\n <\/p>\n~\/.openclaw\/workspace<\/code>（可配置）。
\n * 会植入首次运行 bootstrap 仪式所需的工作区文件。
\n * 工作区布局：智能体工作区<\/a>。\n <\/p>\n
\n * 建议：即使仅用于 loopback，也保持启用令牌身份验证，这样本地 WS 客户端也必须进行身份验证。
\n * 在令牌模式下，交互式设置提供：
\n * 生成\/存储明文令牌<\/strong>（默认）
\n * 使用 SecretRef<\/strong>（可选）
\n * 在密码模式下，交互式设置也支持明文或 SecretRef 存储。
\n * 非交互式令牌 SecretRef 路径：--gateway-token-ref-env <ENV_VAR><\/code>。
\n * 要求在新手引导进程环境中存在一个非空环境变量。
\n * 不能与 --gateway-token<\/code> 组合使用。
\n * 仅当你完全信任每个本地进程时才禁用身份验证。
\n * 非 loopback 绑定仍然需要身份验证。\n <\/p>\n
\n * Telegram<\/a>：bot 令牌
\n * Discord<\/a>：bot 令牌
\n * Google Chat<\/a>：服务账号 JSON + webhook audience
\n * Mattermost<\/a> 插件：bot 令牌 + 基础 URL
\n * Signal<\/a>：可选 signal-cli<\/code> 安装 + 账户配置
\n * BlueBubbles<\/a>：推荐用于 iMessage；服务器 URL + 密码 + webhook
\n * iMessage<\/a>：旧版 imsg<\/code> CLI 路径 + 数据库访问
\n * 私信安全：默认是配对。首次私信会发送一个代码；通过
\n openclaw pairing approve <channel> <code><\/code> 批准，或使用 allowlist。\n <\/p>\n
\n * 需要已登录的用户会话；对于无头环境，请使用自定义 LaunchDaemon（未随附）。
\n * Linux 和通过 WSL2 的 Windows：systemd 用户单元
\n * 向导会尝试执行 loginctl enable-linger <user><\/code>，使网关在注销后仍保持运行。
\n * 可能会提示输入 sudo（写入 \/var\/lib\/systemd\/linger<\/code>）；会先尝试不使用 sudo。
\n * 运行时选择：Node（推荐；WhatsApp 和 Telegram 必需）。不建议使用 Bun。\n <\/p>\nopenclaw health<\/code>。
\n * openclaw status --deep<\/code> 会在状态输出中添加 Gateway 网关健康探测。\n <\/p>\n
\n * 让你选择 node 管理器：npm 或 pnpm（不建议使用 bun）。
\n * 安装可选依赖（部分依赖在 macOS 上使用 Homebrew）。\n <\/p>\n
\n 如果缺少控制 UI 资源，向导会尝试构建它们；回退命令为 pnpm ui:build<\/code>（首次运行会自动安装 UI 依赖）。\n<\/p>\n远程模式详情<\/h2>\n
\n
ws:\/\/...<\/code>）<\/li>\n
\n – 发现提示：
\n * macOS：Bonjour（dns-sd<\/code>）
\n * Linux：Avahi（avahi-browse<\/code>）\n<\/p>\n身份验证和模型选项<\/h2>\n
ANTHROPIC_API_KEY<\/code> 则使用它，否则提示输入密钥，然后保存以供守护进程使用。\n <\/p>\n
\n * Linux 和 Windows：如果存在，则复用 ~\/.claude\/.credentials.json<\/code><\/p>\n在 macOS 上，请选择 “Always Allow”，以免 launchd 启动被阻塞。\n<\/code><\/pre>\n<\/p>\nclaude setup-token<\/code>，然后粘贴该令牌。
\n 你可以为其命名；留空则使用默认值。\n <\/p>\n~\/.codex\/auth.json<\/code>，向导可以复用它。\n <\/p>\ncode#state<\/code>。<\/p>\n当模型未设置或为 `openai\/*` 时，将 `agents.defaults.model` 设置为 `openai-codex\/gpt-5.4`。\n<\/code><\/pre>\n<\/p>\nOPENAI_API_KEY<\/code> 则使用它，否则提示输入密钥，然后将该凭证存储在 auth profile 中。<\/p>\n当模型未设置、为 `openai\/*` 或 `openai-codex\/*` 时，将 `agents.defaults.model` 设置为 `openai\/gpt-5.1-codex`。\n<\/code><\/pre>\n<\/p>\nXAI_API_KEY<\/code>，并将 xAI 配置为模型提供商。\n <\/p>\nOPENCODE_API_KEY<\/code>（或 OPENCODE_ZEN_API_KEY<\/code>），并让你选择 Zen 或 Go 目录。
\n 设置 URL：opencode.ai\/auth<\/a>。\n <\/p>\nAI_GATEWAY_API_KEY<\/code>。
\n 更多详情：Vercel AI Gateway<\/a>。\n <\/p>\nCLOUDFLARE_AI_GATEWAY_API_KEY<\/code>。
\n 更多详情：Cloudflare AI Gateway<\/a>。\n <\/p>\n
\n 更多详情：MiniMax<\/a>。\n <\/p>\nSYNTHETIC_API_KEY<\/code>。
\n 更多详情：Synthetic<\/a>。\n <\/p>\nhttp:\/\/127.0.0.1:11434<\/code>），然后提供 Cloud + Local 或 Local 模式。
\n 会发现可用模型并建议默认值。
\n 更多详情：Ollama<\/a>。\n <\/p>\n
\n 更多详情：Moonshot AI（Kimi + Kimi Coding）<\/a>。\n <\/p>\n交互式新手引导支持与其他提供商 API 密钥流程相同的 API 密钥存储选项：\n\n* **现在粘贴 API 密钥**（明文）\n* **使用密钥引用**（环境变量引用或已配置提供商引用，并带有预检验证）\n\n非交互式标志：\n\n* `--auth-choice custom-api-key`\n* `--custom-base-url`\n* `--custom-model-id`\n* `--custom-api-key`（可选；回退到 `CUSTOM_API_KEY`）\n* `--custom-provider-id`（可选）\n* `--custom-compatibility <openai|anthropic>`（可选；默认 `openai`）\n<\/code><\/pre>\n<\/p>\n\n
\n
~\/.openclaw\/credentials\/oauth.json<\/code><\/li>\n~\/.openclaw\/agents\/<agentId>\/agent\/auth-profiles.json<\/code><\/li>\n<\/ul>\n\n
--secret-input-mode ref<\/code> 会启用引用模式，而不是明文密钥存储。
\n 在交互式设置中，你可以选择：<\/li>\nkeyRef: { source: \"env\", provider: \"default\", id: \"OPENAI_API_KEY\" }<\/code>）<\/li>\nfile<\/code> 或 exec<\/code>），带提供商别名 + id<\/li>\n--secret-input-mode ref<\/code> 仅支持由环境变量支持的引用。<\/li>\n--openai-api-key<\/code>）要求设置该环境变量；否则新手引导会快速失败。<\/li>\nref<\/code> 模式会将 models.providers.<id>.apiKey<\/code> 存储为 { source: \"env\", provider: \"default\", id: \"CUSTOM_API_KEY\" }<\/code>。<\/li>\n--custom-api-key<\/code> 要求设置 CUSTOM_API_KEY<\/code>；否则新手引导会快速失败。<\/li>\n--gateway-token-ref-env <ENV_VAR><\/code>。<\/li>\n
\n ~\/.openclaw\/credentials\/oauth.json<\/code>（或 $OPENCLAW_STATE_DIR\/credentials\/oauth.json<\/code>）
\n 到 Gateway 网关主机。\n<\/p>\n输出和内部机制<\/h2>\n
~\/.openclaw\/openclaw.json<\/code> 中的典型字段：<\/p>\n\n
agents.defaults.workspace<\/code><\/li>\nagents.defaults.model<\/code> \/ models.providers<\/code>（如果选择了 Minimax）<\/li>\ntools.profile<\/code>（本地新手引导在未设置时默认设为 \"coding\"<\/code>；现有显式值会保留）<\/li>\ngateway.*<\/code>（模式、绑定、身份验证、tailscale）<\/li>\nsession.dmScope<\/code>（本地新手引导在未设置时默认设为 per-channel-peer<\/code>；现有显式值会保留）<\/li>\nchannels.telegram.botToken<\/code>、channels.discord.token<\/code>、channels.signal.*<\/code>、channels.imessage.*<\/code><\/li>\nskills.install.nodeManager<\/code><\/li>\nwizard.lastRunAt<\/code><\/li>\nwizard.lastRunVersion<\/code><\/li>\nwizard.lastRunCommit<\/code><\/li>\nwizard.lastRunCommand<\/code><\/li>\nwizard.lastRunMode<\/code><\/li>\n<\/ul>\nopenclaw agents add<\/code> 会写入 agents.list[]<\/code> 和可选的 bindings<\/code>。<\/p>\n~\/.openclaw\/credentials\/whatsapp\/<accountId>\/<\/code>。
\n会话存储在 ~\/.openclaw\/agents\/<agentId>\/sessions\/<\/code> 下。<\/p>\n
\n 会先提示安装插件（npm 或本地路径），然后再进行渠道配置。\n<\/p>\n\n
wizard.start<\/code><\/li>\nwizard.next<\/code><\/li>\nwizard.cancel<\/code><\/li>\nwizard.status<\/code><\/li>\n<\/ul>\n\n
~\/.openclaw\/tools\/signal-cli\/<version>\/<\/code><\/li>\nchannels.signal.cliPath<\/code><\/li>\n相关文档<\/h2>\n
\n
openclaw onboard<\/code><\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"