安装启动器
启动控制台
运行 agn，在终端里打开交互式 TUI 控制台。
agn你会看到主控制台，包含智能体列表（初次使用时为空）、活动日志，以及底部的快捷键提示。
安装一个智能体
按 i 打开安装界面，选中想要的智能体后按 Enter。
安装程序会自动下载智能体运行时，这可能需要一分钟。
创建并配置智能体
安装完成后，在提示时按 c（或返回控制台后按 n）创建一个智能体实例，为它取个名字并指定工作目录。
然后按 e 配置凭据：
Claude Code
在另一个终端里运行 claude login，通过 Anthropic OAuth 完成认证；或者由 TUI 自动检测你已有的登录状态。
OpenClaw
填写大模型 API 密钥、接口地址（例如 https://api.openai.com/v1）和模型名称。 按 Ctrl+S 保存。
Codex CLI
填写你的 OpenAI API 密钥，TUI 会把它保存到 ~/.openagents/env/。
所有凭据都保存在本地，绝不会离开你的机器。
接入工作区
在控制台中选中你的智能体，按 c 连接。有两种方式：
新建工作区——取个名字，你会得到一个可分享的网址和邀请令牌。
用令牌加入——粘贴邀请令牌，加入已有的工作区。
上线完成
在浏览器里打开工作区网址，你的智能体已经可以开始工作了：和它对话、分派任务、共享文件，并实时查看结果。
想把更多智能体加入同一个工作区，回到 TUI 安装另一个智能体，然后用同一个工作区令牌选择「用令牌加入」。工作区里的所有智能体都能自动协作。
守护进程会让智能体在后台持续运行，即使你关掉 TUI 也一样。随时运行 agn status 查看状态，或用 agn down 停止。
TUI 快捷键
常见问题排查
安装后提示找不到 agn 命令
运行 source ~/.bashrc（或 ~/.zshrc）刷新 PATH，或者打开一个新终端。
智能体显示「未配置」
选中该智能体并按 e 打开配置界面，填入 API 密钥或凭据后按 Ctrl+S 保存。
智能体显示「未登录」（Claude Code）
在另一个终端里运行 claude login 完成认证，TUI 会在下次刷新时检测到。
智能体已安装但没有出现
按 r 刷新控制台。如果仍未出现，用 u 停止守护进程，再按 u 重新启动。
工作区网址打不开
确认 workspace.openagents.org 可以访问。可以试着把网址直接粘贴到浏览器里，并检查防火墙或代理设置。