快速开始

本指南将帮助您在 10 分钟内从零开始运行一个 IronClaw 实例。

设置您的智能体

获取 IronClaw

前往 https://agent.near.ai/ 并使用您偏好的方式登录，然后在私有实例中创建一个 IronClaw 智能体。私有实例准备就绪后，您可以通过智能体仪表盘提供的地址使用 SSH 连接到它：

ssh -p <PORT> liquid-horse@agent2.near.ai

SSH 密钥

使用 IronClaw 需要提供 SSH 密钥。如果您还没有，可以在终端中使用以下命令生成：

ssh-keygen -t rsa -b 4096 -C "you@example.com"
cat ~/.ssh/id_rsa.pub

连接遇到问题？

连接前请确保已将 SSH 密钥添加到设备的 SSH 代理中：

ssh-add ~/.ssh/id_rsa

适合在自己的机器上个人使用。默认使用 libSQL（嵌入式 SQLite），无需单独的数据库服务器。

# 安装 IronClaw
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nearai/ironclaw/releases/latest/download/ironclaw-installer.sh | sh

启动智能体

首次启动智能体：

ironclaw onboard
ironclaw serve

onboard 只需执行一次，它会创建 IronClaw 主目录、写入初始配置，并要求您选择推理提供商与模型。完成后会打印一个包含令牌的登录链接：

login_link: http://127.0.0.1:3000/login?token=<your-token>

serve 默认监听 127.0.0.1:3000。在浏览器中打开上述登录链接，即可进入聊天界面。

⚠️ 端口已被占用

若 3000 端口已被占用，可指定其他端口：

ironclaw serve --port 3100

使用 --port 0 可让系统自动分配空闲端口。

找不到登录链接？

查看配置路径并读取令牌：

ironclaw config path
cat ~/.ironclaw/reborn/webui-token

然后访问 http://127.0.0.1:3000/login?token=<token>。

我们推荐使用 NEAR AI 作为推理提供商，以获得更高的隐私与安全性。完整的提供商列表参见推理提供商（暂仅提供英文版）。

⚠️ 错误：Webhook 服务器启动失败

如果遇到错误 Error: Channel webhook_server failed to start: Failed to bind to 0.0.0.0:8080: Address already in use (os error 98)，请尝试设置一个不同的 HTTP 端口：

# 将默认 HTTP 端口改为 8081
export HTTP_PORT=8081

# 然后重新启动智能体
ironclaw

与智能体对话

当智能体启动后，您就可以通过终端与它交互。直接输入消息，智能体就会回复。

更新 IronClaw

最后，请定期更新 IronClaw，以获得最新功能和改进。您可以在终端中运行以下命令进行更新：

ironclaw-update

现在您的智能体已经运行起来了，接下来可以配置新的频道以便通过您偏好的消息平台与它交互，并添加一些工具来扩展能力。

将智能体连接到您喜欢的消息平台。

让智能体访问外部 API 与服务。