onboard 命令允许您一次性配置智能体的多项设置,包括推理提供商、LLM、隧道和频道。它提供了引导式体验,帮助您在几分钟内完成智能体设置。
如果您还没有设置智能体,请先查看我们的快速开始指南
如果您是 IronClaw 新用户,我们建议您逐一配置频道、工具和其他设置,而不是通过
onboard 命令一次性完成所有配置。引导向导
如果您是 IronClaw 新用户,我们建议您逐一配置频道、工具和其他设置,而不是通过 onboard 命令一次性完成所有配置。1
启动引导向导
在终端中运行以下命令启动引导向导:
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
后台任务
心跳功能运行定期后台任务(例如检查日历、监控通知、运行定时工作流)。我们建议启用此功能以释放智能体的全部潜力,但您随时可以在需要时禁用。