mirror of
https://github.com/nearai/ironclaw.git
synced 2026-09-02 23:56:24 +08:00
143 lines
3.5 KiB
Plaintext
143 lines
3.5 KiB
Plaintext
---
|
||
title: "快速开始"
|
||
description: "几分钟内创建您的智能体"
|
||
icon: rocket
|
||
---
|
||
|
||
本指南将帮助您在 10 分钟内从零开始运行一个 IronClaw 实例。
|
||
|
||
---
|
||
|
||
## 设置您的智能体
|
||
|
||
<Steps>
|
||
|
||
<Step title="获取 IronClaw">
|
||
|
||
<Tabs>
|
||
<Tab title="Agent Hub">
|
||
前往 https://agent.near.ai/ 并使用您偏好的方式登录，然后在私有实例中创建一个 IronClaw 智能体。
|
||
|
||
私有实例准备就绪后，您可以通过[智能体仪表盘](https://agent.near.ai/)提供的地址使用 `SSH` 连接到它：
|
||
|
||
```bash
|
||
ssh -p <PORT> liquid-horse@agent2.near.ai
|
||
```
|
||
|
||
<Accordion title="SSH 密钥">
|
||
|
||
使用 IronClaw 需要提供 SSH 密钥。如果您还没有，可以在终端中使用以下命令生成：
|
||
|
||
```bash
|
||
ssh-keygen -t rsa -b 4096 -C "you@example.com"
|
||
cat ~/.ssh/id_rsa.pub
|
||
```
|
||
|
||
</Accordion>
|
||
|
||
<Accordion title="连接遇到问题？">
|
||
连接前请确保已将 SSH 密钥添加到设备的 SSH 代理中：
|
||
|
||
```bash
|
||
ssh-add ~/.ssh/id_rsa
|
||
```
|
||
|
||
</Accordion>
|
||
</Tab>
|
||
|
||
<Tab title="本地">
|
||
适合在自己的机器上个人使用。默认使用 libSQL（嵌入式 SQLite），无需单独的数据库服务器。
|
||
|
||
```bash
|
||
# 安装 IronClaw
|
||
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nearai/ironclaw/releases/latest/download/ironclaw-installer.sh | sh
|
||
```
|
||
</Tab>
|
||
</Tabs>
|
||
|
||
</Step>
|
||
|
||
<Step title="启动智能体">
|
||
|
||
首次启动智能体：
|
||
|
||
```bash
|
||
ironclaw
|
||
```
|
||
|
||
<Accordion title="⚠️ 错误：另一个 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
|
||
```
|
||
|
||
</Accordion>
|
||
|
||
由于这是首次启动智能体，它会要求您配置推理提供商以及要使用的 LLM。
|
||
|
||
|
||
|
||
<Note>
|
||
我们推荐使用 [NEAR AI](https://cloud.near.ai/) 作为推理提供商，以获得更高的隐私与安全性，并使用 `Qwen3-30B` 模型来兼顾效果与成本。
|
||
</Note>
|
||
|
||
<Accordion title="⚠️ 错误：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
|
||
```
|
||
|
||
</Accordion>
|
||
|
||
</Step>
|
||
|
||
<Step title="与智能体对话">
|
||
|
||
当智能体启动后，您就可以通过终端与它交互。直接输入消息，智能体就会回复。
|
||
|
||
|
||
|
||
|
||
</Step>
|
||
|
||
<Step title="更新 IronClaw">
|
||
|
||
最后，请定期更新 IronClaw，以获得最新功能和改进。您可以在终端中运行以下命令进行更新：
|
||
|
||
```bash
|
||
ironclaw-update
|
||
```
|
||
|
||
</Step>
|
||
|
||
</Steps>
|
||
|
||
|
||
---
|
||
|
||
## 下一步
|
||
|
||
现在您的智能体已经运行起来了，接下来可以配置新的[频道](./channels/telegram)以便通过您偏好的消息平台与它交互，并添加一些[工具](/extensions/web-search)来扩展能力。
|
||
|
||
<CardGroup cols={2}>
|
||
<Card title="频道" icon="plug" href="/channels/telegram">
|
||
将智能体连接到您喜欢的消息平台。
|
||
</Card>
|
||
|
||
<Card title="工具" icon="wrench" href="/extensions/web-search">
|
||
让智能体访问外部 API 与服务。
|
||
</Card>
|
||
</CardGroup>
|