> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironclaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 引导配置

> 配置智能体的主要设置

`onboard` 命令允许您一次性配置智能体的多项设置，包括推理提供商、LLM、隧道和频道。它提供了引导式体验，帮助您在几分钟内完成智能体设置。

<Note>
  如果您还没有设置智能体，请先查看我们的[快速开始指南](../quickstart)
</Note>

<Danger>
  如果您是 IronClaw 新用户，我们建议您逐一配置[频道](/channels/telegram)、工具和其他设置，而不是通过 `onboard` 命令一次性完成所有配置。
</Danger>

***

## 引导向导

如果您是 IronClaw 新用户，我们建议您逐一配置频道、工具和其他设置，而不是通过 onboard 命令一次性完成所有配置。

<Steps>
  <Step title="启动引导向导">
    在终端中运行以下命令启动引导向导：

    ```bash theme={null}
    ironclaw onboard
    ```
  </Step>

  <Step title="选择数据库路径">
    向导将首先要求您选择智能体数据库的路径，默认为 `/home/agent/.ironclaw/ironclaw.db`。这是智能体存储配置的位置。
  </Step>

  <Step title="密钥管理">
    选择将主密钥存储在哪里，主密钥用于加密您的全部凭证。

    推荐使用系统密钥环，但如果您在没有密钥环的环境中运行（如服务器或容器），建议将主密钥存储在环境变量中。
  </Step>

  <Step title="推理提供商和 LLM">
    内置提供商包括 Anthropic、OpenAI、Google Gemini、MiniMax、Mistral 和 Ollama（本地）。

    我们推荐使用 [NEAR AI](https://cloud.near.ai/) 作为推理提供商，以获得最高的隐私和安全性，并使用 `Qwen3-30B` 模型，性价比最优。
  </Step>

  <Step title="启用语义搜索">
    嵌入功能可在您的工作区记忆中启用语义搜索，我们建议启用此功能。
  </Step>

  <Step title="配置隧道和频道">
    隧道用于将智能体的 API 安全地暴露到互联网，这是频道正常工作所必需的。我们推荐使用 [ngrok](https://dashboard.ngrok.com/)，因为它易于使用且可靠。

    配置隧道后，您可以选择要为智能体启用的频道，以便它可以监听和回复来自 Telegram、Slack 或 Discord 等平台的消息。

    您随时可以添加更多频道。
  </Step>

  <Step title="工具/扩展">
    您可以配置要为智能体启用的工具和扩展。智能体会用它们执行各种操作，例如搜索网页、读写电子邮件、使用 GitHub 等。

    您随时可以添加更多工具和扩展。
  </Step>

  <Step title="Docker 沙箱">
    IronClaw 可以在 Docker 容器中执行代码、运行构建和使用工具。这保证了系统安全——来自 LLM 的命令在隔离的沙箱中运行，无法访问您的凭证，文件系统访问受限，网络流量仅限于允许列表。

    <Info>
      如果您在没有 Docker 的环境中运行 IronClaw（如服务器或容器），可以禁用沙箱功能。
    </Info>
  </Step>

  <Step title="后台任务">
    心跳功能运行定期后台任务（例如检查日历、监控通知、运行定时工作流）。

    我们建议启用此功能以释放智能体的全部潜力，但您随时可以在需要时禁用。
  </Step>
</Steps>