OpenClaw 设置终极指南：您的专属 AI 助手

在深入了解 OpenClaw 的精彩世界之前，确保您拥有必要的组件至关重要。本节概述了确保顺利设置过程的先决条件。 ### 1. 兼容的计算机 OpenClaw 设计用于在大多数现代操作系统上运行。您需要以下之一： * **Mac**: Apple 的 macOS 操作系统。 * **Windows**: 广泛使用的 Microsoft Windows PC 操作系统。 * **Linux**: 一个通用且功能强大的操作系统，常受开发者青睐。 ### 2. Node.js (22 版本或更高版本) Node.js 是一个运行时环境，允许您的计算机执行 JavaScript 代码，这是 OpenClaw 的基础。要检查您是否已安装 Node.js 及其版本： * **在 Mac 上**: 打开终端（Command + Space，输入 'Terminal'，按 Enter）。 * **在 Windows 上**: 打开命令提示符或 PowerShell（Windows 键，输入 'cmd' 或 'PowerShell'，按 Enter）。 * 在终端或命令提示符中，输入 `node --version` 并按 Enter。 如果输出显示的版本号以 '22' 或更高版本开头（例如 `v22.1.0`），则表示您已准备就绪。如果不是，或者您看到 'command not found'，则需要安装它。 **安装 Node.js**: 1. 访问官方 Node.js 网站：[https://nodejs.org/](https://nodejs.org/) 2. 下载 'LTS'（长期支持）版本，这是最稳定的版本。 3. 运行安装程序并按照屏幕上的说明进行操作（通常只需反复单击 'Next'）。 4. 安装完成后，在终端中重新检查版本以确认已正确安装。 ### 3. AI 服务账户 OpenClaw 需要一个外部 AI 服务来提供其智能。您需要一个以下提供商的账户和一个 API 密钥： * **选项 A: Anthropic (Claude)**: 以其先进的推理能力而闻名。您需要一个 Claude 账户（推荐 Pro 或 Max 版本以获得最佳性能）以及来自其控制台的 API 密钥。 * **选项 B: OpenAI (ChatGPT)**: 一个流行的选择，拥有广泛的模型。您需要一个 OpenAI 账户以及来自其平台的 API 密钥。 **专业提示**: 为获得最佳体验，请考虑使用 Claude Opus 4.5，它提供卓越的性能，但成本可能较高。 ### 4. 时间投入 虽然设置过程并不复杂，但通常需要大约 30 分钟。仔细按照步骤操作将确保成功安装。

安装 OpenClaw 后，下一步是配置它以理解您的偏好并连接到您选择的 AI 服务。这由用户友好的入门向导处理。 ### 步骤 1: 启动入门向导 打开您的终端并输入以下命令： ```bash openclaw onboard --install-daemon ``` `--install-daemon` 标志可确保 OpenClaw 在后台持续运行，使其始终可用。'守护进程'（daemon）是一个作为服务运行的程序，无需直接用户交互即可运行。 ### 步骤 2: 回答向导的提示 向导将引导您完成一系列问题： #### 问题 1: "我们应该如何称呼您的助手？" 为您的 AI 选择一个名字。它可以是经典的 AI 名称，如 'Jarvis' 或 'Alfred'，也可以是更个性化或幽默的名字。输入您选择的名称并按 Enter。 #### 问题 2: "您想使用哪个 AI 提供商？" 使用箭头键选择 'Anthropic'（用于 Claude）或 'OpenAI'（用于 ChatGPT），具体取决于您拥有哪个服务账户。按 Enter 确认。 #### 问题 3: "输入您的 API 密钥" 这是一个关键步骤。您的 API 密钥是一个秘密令牌，允许 OpenClaw 向您的 AI 服务进行身份验证。 * **对于 Anthropic**: 导航至 [https://console.anthropic.com/](https://console.anthropic.com/)，登录，转到 'API Keys'，点击 'Create Key'，然后复制生成的密钥。 * **对于 OpenAI**: 访问 [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys)，登录，点击 'Create new secret key'，然后复制令牌。 将复制的 API 密钥粘贴到终端中。请注意，出于安全原因，输入字符时不会显示。按 Enter 提交。 **重要提示**: 将您的 API 密钥视为密码。切勿公开分享或不安全地存储它。 #### 问题 4: "您想使用哪个模型？" 选择您希望使用的特定 AI 模型。选项将根据您的提供商而异（例如，`claude-opus-4.5`、`claude-sonnet-4.5`、`gpt-4`）。向导将显示可用模型。强烈推荐 Claude Opus 4.5，因为它具有先进的功能。 #### 问题 5: "您想设置消息通道吗？" 如果您想通过 WhatsApp 或 Telegram 等消息应用与 OpenClaw 互动，请选择 'Yes'。如果您最初更喜欢使用 Web 仪表板，请选择 'No'（稍后可以添加通道）。 #### 问题 6: "您想设置哪些通道？" 如果您在上一步中选择了 'Yes'，您将看到支持的通道列表（例如，WhatsApp、Telegram、Discord、Slack）。使用空格键选择您想要的通道，然后按 Enter。某些通道可能需要额外的配置步骤，这些将在后面介绍。 #### 问题 7: "您想安装网关守护进程吗？" 确认 'YES' 以确保 OpenClaw 在后台运行，随时准备为您提供帮助。 ### 步骤 3: 等待向导完成 向导现在将通过创建配置文件、初始化网关并启动后台守护进程来完成设置。此过程通常需要大约 30 秒。

为确保 OpenClaw 在设置后正常运行，您可以执行一些验证步骤。 ### 步骤 1: 检查网关状态 打开您的终端并运行以下命令： ```bash openclaw gateway status ``` 您应该会看到类似以下的输出，表明网关已激活且运行正常： ``` ✓ Gateway is running ✓ Port: 18789 ✓ Status: healthy ``` 如果网关未运行，您可以键入以下命令手动启动它： ```bash openclaw gateway start ``` ### 步骤 2: 访问 Web 仪表板 OpenClaw 提供了一个方便的基于 Web 的仪表板，用于与您的 AI 互动和管理设置。要打开它，请运行： ```bash openclaw dashboard ``` 此命令应自动启动您的默认 Web 浏览器并导航到 OpenClaw 控制面板，地址为 `http://127.0.0.1:18789/`。如果它没有自动打开，请手动在浏览器中输入此地址。 仪表板允许您： * 直接与您的 AI 聊天。 * 监控其当前活动。 * 调整设置。 * 查看日志。 ### 步骤 3: 发送您的第一条消息 打开仪表板后，找到聊天输入框。尝试向您的 AI 发送一条简单消息，例如： ``` 你好！你能自我介绍一下吗？ ``` 如果您的 AI 响应准确，则表示您已成功设置 OpenClaw！这证实了安装、AI 连接和网关都按预期工作。恭喜您设置了您的个人 AI 助手！

要真正释放您的 OpenClaw AI 助手的潜力，您可以为其配备 '技能'——本质上是赋予它新能力的插件。这些技能允许 OpenClaw 与外部服务互动并执行各种任务。 ### 什么是技能？ 技能就像 OpenClaw 可以利用的应用程序。例如，'网页浏览' 技能使其能够搜索互联网，'日历' 技能允许它管理您的日程安排，'文件管理' 技能有助于组织您的文档。技能的可用性非常广泛，涵盖了众多功能。 ### 如何添加技能 **步骤 1: 浏览可用技能** 访问 [https://clawhub.ai](https://clawhub.ai) 来探索 OpenClaw 可以利用的广泛技能库。您会找到用于提高生产力、信息检索、娱乐等的技能。 **步骤 2: 安装技能** 让我们以 'web-search' 技能为例。要安装它，请打开您的终端并运行： ```bash openclaw skills install web-search ``` 此命令下载并将技能集成到您的 OpenClaw 设置中。 **步骤 3: 测试技能** 安装后，您可以通过向 OpenClaw 提出需要互联网研究的问题来测试 'web-search' 技能： ``` 你能搜索互联网关于恐龙的信息吗？ ``` OpenClaw 现在应该能够访问网络，找到相关信息并呈现给您。 ### 值得尝试的酷炫技能 以下是一些强烈推荐的技能，可以增强您的 OpenClaw 体验： * `calendar`: 用于管理您的日程安排和约会。 * `weather`: 获取实时天气更新。 * `spotify`: 控制您的 Spotify 播放。 * `file-organizer`: 用于自动化文件组织。 * `code-helper`: 协助编程任务和调试。 * `homework-helper`: 帮助理解学术科目（请负责任地用于学习，而非作弊）。

即使经过仔细设置，您也可能偶尔遇到问题。本节提供了常见问题的解决方案。 ### 问题: "Command not found" 此错误表明您的系统终端无法找到 `openclaw` 可执行文件。 **解决方案**: * 关闭当前的终端窗口并打开一个新的。这通常会刷新系统的 PATH 环境变量。 * 重新运行 OpenClaw 安装脚本。 * 手动将 OpenClaw 安装目录添加到系统的 PATH 环境变量中。如果您不确定如何操作，请寻求有经验用户的帮助或参考您的操作系统文档。 ### 问题: "Gateway won't start" 这通常意味着另一个应用程序已在使用 OpenClaw 网关尝试占用的默认端口（18789）。 **解决方案**: 您可以指示 OpenClaw 使用不同的端口。尝试使用新端口号启动网关： ```bash openclaw gateway --port 18790 ``` 如果 18790 也被占用，请根据需要调整端口号。 ### 问题: "AI 没响应" 如果您的 AI 未响应，可能有多种因素在起作用。 **解决方案**: * **验证 API 密钥**: 仔细检查在入门过程中输入的 API 密钥是否正确，并且未过期或被撤销。您可以通过 `openclaw config edit` 重新输入。 * **检查 AI 服务积分/订阅**: 确保您在 AI 提供商（Anthropic 或 OpenAI）处有足够的积分或有效的订阅。 * **检查日志**: `openclaw logs` 命令将显示详细的活动和错误消息，这可以 pinpoint 问题的确切原因。 ### 问题: "WhatsApp 经常断开连接" 由于其安全协议，WhatsApp 的连接有时可能不稳定。 **解决方案**: * 确保您的手机具有稳定的互联网连接。 * 避免在手机上退出 WhatsApp。 * 如果连接断开，请尝试重新扫描二维码以重新链接您的设备。 ### 问题: "花费太多钱了！" 如果您担心 API 成本，可以实施使用限制。 **解决方案**: 编辑您的 `openclaw.json` 配置文件以设置每天的最大令牌使用量并定义警报阈值： ```json "limits": { "maxTokensPerDay": 100000, "alertWhenOver": 50000 } ``` 这有助于通过限制每日使用量并在您接近限制时通知您来管理您的支出。

随着 OpenClaw 与您的数字生活集成并连接到外部服务，优先考虑在线安全和数据安全至关重要。遵守这些指南将有助于保护您的信息并确保安全体验。 ### 1. 绝不分享您的 API 密钥 您的 API 密钥是授予对您的 AI 服务账户访问权限的敏感凭证。像对待密码一样谨慎对待它。 * **请勿**: 在社交媒体上发布您的 API 密钥，与朋友分享，或将其嵌入到公开的代码存储库中。 * **安全存储**: 将您的 API 密钥保存在安全的位置，例如密码管理器中，并且仅提供给 OpenClaw 等受信任的应用程序。 ### 2. 小心处理个人信息 虽然 OpenClaw 可以成为个人助理，但避免与它分享高度敏感的个人详细信息。 * **避免分享**: 不要透露您的家庭住址、完整的电话号码、父母的信用卡信息或其他账户的密码。 * **隐私**: 请记住，虽然 OpenClaw 在本地运行，但 AI 模型本身会处理您的查询。请注意您输入的信息。 ### 3. 利用配对系统 对于 WhatsApp 等消息通道，OpenClaw 提供了一个配对系统，限制对已批准联系人的访问。 * **启用并使用**: 确保此功能已激活，并且仅批准受信任的电话号码。这可以防止未经授权的人员与您的 AI 进行互动。 ### 4. 不要仅依赖 AI OpenClaw 尽管功能强大，但并非万无一失。AI 模型有时会生成不正确或误导性的信息。 * **验证信息**: 始终仔细核查关键信息，特别是对于学术或专业任务。 * **道德使用**: 将 OpenClaw 用作学习工具，而不是用于完成作业或抄袭内容。 * **批判性思维**: 对 AI 提供的信息保持批判性视角。运用您自己的判断和推理能力。