跳转到主要内容
onboard 命令允许您一次性配置智能体的多项设置，包括推理提供商、LLM、隧道和频道。它提供了引导式体验，帮助您在几分钟内完成智能体设置。
如果您还没有设置智能体，请先查看我们的快速开始指南
如果您是 IronClaw 新用户，我们建议您逐一配置频道、工具和其他设置，而不是通过 onboard 命令一次性完成所有配置。

​
引导向导

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

启动引导向导

在终端中运行以下命令启动引导向导：
ironclaw onboard
2

选择数据库路径

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

密钥管理

选择将主密钥存储在哪里，主密钥用于加密您的全部凭证。推荐使用系统密钥环，但如果您在没有密钥环的环境中运行（如服务器或容器），建议将主密钥存储在环境变量中。
4

推理提供商和 LLM

内置提供商包括 Anthropic、OpenAI、Google Gemini、MiniMax、Mistral 和 Ollama（本地）。我们推荐使用 NEAR AI 作为推理提供商，以获得最高的隐私和安全性，并使用 Qwen3-30B 模型，性价比最优。
5

启用语义搜索

嵌入功能可在您的工作区记忆中启用语义搜索，我们建议启用此功能。
6

配置隧道和频道

隧道用于将智能体的 API 安全地暴露到互联网，这是频道正常工作所必需的。我们推荐使用 ngrok，因为它易于使用且可靠。配置隧道后，您可以选择要为智能体启用的频道，以便它可以监听和回复来自 Telegram、Slack 或 Discord 等平台的消息。您随时可以添加更多频道。
7

工具/扩展

您可以配置要为智能体启用的工具和扩展。智能体会用它们执行各种操作，例如搜索网页、读写电子邮件、使用 GitHub 等。您随时可以添加更多工具和扩展。
8

Docker 沙箱

IronClaw 可以在 Docker 容器中执行代码、运行构建和使用工具。这保证了系统安全——来自 LLM 的命令在隔离的沙箱中运行，无法访问您的凭证，文件系统访问受限，网络流量仅限于允许列表。
如果您在没有 Docker 的环境中运行 IronClaw（如服务器或容器），可以禁用沙箱功能。
9

后台任务

心跳功能运行定期后台任务（例如检查日历、监控通知、运行定时工作流）。我们建议启用此功能以释放智能体的全部潜力，但您随时可以在需要时禁用。