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

​
设置您的智能体

1

获取 IronClaw

前往 https://agent.near.ai/ 并使用您偏好的方式登录，然后在私有实例中创建一个 IronClaw 智能体。私有实例准备就绪后，您可以通过智能体仪表盘提供的地址使用 SSH 连接到它：
ssh -p <PORT> liquid-horse@agent2.near.ai
使用 IronClaw 需要提供 SSH 密钥。如果您还没有，可以在终端中使用以下命令生成：
ssh-keygen -t rsa -b 4096 -C "you@example.com"
cat ~/.ssh/id_rsa.pub
连接前请确保已将 SSH 密钥添加到设备的 SSH 代理中：
ssh-add ~/.ssh/id_rsa
2

启动智能体

首次启动智能体：
ironclaw
如果出现错误 Error: Another IronClaw instance is already running (PID 38). If this is incorrect, remove the stale PID file: /home/agent/.ironclaw/ironclaw.pid，只需运行以下命令删除过期的 PID 文件，然后重新启动智能体：
# 删除过期的 PID 文件
rm /home/agent/.ironclaw/ironclaw.pid

# 然后重新启动智能体
ironclaw
由于这是首次启动智能体，它会要求您配置推理提供商以及要使用的 LLM。setup
我们推荐使用 NEAR AI 作为推理提供商，以获得更高的隐私与安全性，并使用 Qwen3-30B 模型来兼顾效果与成本。
如果遇到错误 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
3

与智能体对话

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

更新 IronClaw

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

​
下一步

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

频道

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

工具

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