跳转到主要内容
默认情况下，IronClaw 提供两种本地界面与智能体对话：
  • 终端界面 (TUI)： 直接在终端中对话
  • Web 网关： 通过本地 HTTP 服务器在浏览器中对话
如果您还没有设置智能体，请先查看我们的快速开始指南

​
终端界面

只需运行 ironclaw，TUI 将在终端中启动。使用以下快捷键进行导航和对话。
按键操作
Enter发送消息
Shift+Enter在编辑器中换行
Ctrl+C退出
Ctrl+L清屏
Tab聚焦下一个元素
Esc取消或返回
Up/Down滚动历史记录

​
配置

选项默认值描述
CLI_ENABLEDtrue启用或禁用终端界面

​
Web 网关

选项默认值描述
GATEWAY_HOST127.0.0.1Web 网关的主机接口
GATEWAY_PORT3000Web 网关使用的端口
GATEWAY_ENABLEDtrue启用或禁用 Web 网关
GATEWAY_AUTH_TOKEN自动生成打开 Web UI 所需的认证令牌

​
认证

默认情况下，IronClaw 在启动时生成认证令牌并在日志中打印。要在重启间使用固定令牌： 
export GATEWAY_AUTH_TOKEN="your-secure-token-here"
生成令牌： 
openssl rand -hex 32

​
API 端点

Web 网关还暴露本地端点：
端点描述
GET /api/status服务器状态
POST /api/chat发送消息
GET /api/jobs列出任务
GET /api/memory搜索记忆

​
网络访问

使用仅本地访问（推荐）： 
export GATEWAY_HOST=127.0.0.1
使用局域网访问： 
export GATEWAY_HOST=0.0.0.0
使用 0.0.0.0 时，请使用强认证令牌，并在将服务暴露到本地网络之外之前，将其置于 HTTPS/反向代理后面。

​
故障排除

  • 确保您的终端支持 Unicode 和 256 色
  • 设置 TERM=xterm-256color
  • 重启终端会话
  • 检查终端焦点
  • 运行 reset
  • 禁用冲突的终端鼠标模式
  • 确认 ironclaw run 正在运行
  • 检查 GATEWAY_PORT 值
  • 确认主机和防火墙设置
  • 从启动日志中精确复制令牌
  • 移除尾部空格
  • 设置持久的 GATEWAY_AUTH_TOKEN
  • 检查本地网络/代理稳定性
  • 确认反向代理支持 WebSocket 升级
  • 检查浏览器控制台日志