跳到主要内容

实例管理

实例管理用于统一查看和维护 OpenClaw 等 AI 应用的运行位置。你可以在这里管理本机实例和远程实例;部署在云服务器上的环境也归入远程实例。建议先看下面的视频,再跟着图文步骤操作:

实例管理视频:添加并连接实例,点击播放
OpenClaw 多实例管理

什么是实例​

实例可以理解为一个独立运行的 AI 应用服务。实例决定 Agent 在哪台设备和哪个运行环境中执行;每次对话的文件边界仍由对话中选择的工作目录决定。

常见实例类型:

  • 本机实例:运行在当前电脑上,适合个人日常使用。
  • 远程实例:运行在服务器或其他电脑上,通过网络连接管理。
  • 云服务器:按远程实例连接,适合需要集中算力或多设备访问的场景。

多实例管理适用场景​

  • 一个实例处理代码项目,另一个实例处理文档或资料。
  • 本地电脑运行轻量任务,远程服务器运行耗时任务。
  • 同时维护 OpenClaw、Claude Code、Hermes Agent、Codex 等不同应用。
  • 为不同客户、项目或业务线隔离工作环境。

统一远程管理​

多应用远程云端统一管理

东创龙虾面板可以把 OpenClaw、Claude Code、Hermes Agent、Codex 等应用纳入同一管理视图,方便查看连接状态、运行情况和项目入口。

基础操作流程​

开始前请准备:

  • 已安装并验证的目标 Agent 引擎。
  • 远程主机地址、SSH 端口和权限受限的登录账号。
  • 已核对的主机指纹,以及防火墙允许的最小网络范围。
  • 远程端已经创建、且当前账号有权限访问的工作目录。
远程连接安全

优先使用 SSH 密钥和普通权限账号,不要长期使用 root + 密码。首次连接必须核对主机指纹;不要为了连接方便把 SSH 端口向整个公网开放。

  1. 01入口
    实例管理查看现有实例和连接状态。
  2. 02新增
    添加实例选择本机或远程运行方式。
  3. 03连接
    填写配置设置地址、端口和认证信息。
  4. 04用途
    设置名称用项目或用途标识当前实例。
  5. 05引擎
    关联 Agent选择实例需要支持的引擎。
  6. 06完成
    确认在线刷新列表并检查连接状态。

第 1 步:进入实例管理​

点击左侧“实例管理”,再点击页面顶部“添加实例”。

从实例管理页面点击添加实例

第 2 步:选择实例类型​

根据运行位置选择本机或远程实例。下面的示例使用远程实例。

在添加实例页面选择远程类型

第 3 步:选择远程配置并填写连接信息​

选择可用的远程实例配置,然后核对 SSH 主机、端口、用户名、认证方式和网关端口。截图仅用于说明字段位置,其中的地址和用户名不能直接照抄。

选择远程实例配置并填写 SSH 信息

第 4 步:设置实例名称​

使用容易识别的名称,例如运行位置、Agent 和用途,不要把密码、客户姓名或公网 IP 写进实例名称。

设置远程实例名称

第 5 步:关联 Agent 引擎​

在页面底部勾选需要的 Agent 引擎,然后保存实例。

选择远程实例支持的 Agent 引擎并保存

第 6 步:确认连接成功​

返回实例列表并刷新,确认新实例已经出现,类型、引擎和状态符合预期。

远程实例创建并连接成功
完成状态

实例出现在列表中,显示对应 Agent 引擎,并且连接状态正常。

使用建议​

  • 给实例命名时包含项目或用途,例如“本机-OpenClaw-文档处理”。
  • 远程实例建议使用稳定网络和固定地址。
  • 工作目录在新建对话时选择,不要把实例名称当成文件授权边界。
  • 多人企业环境应通过官方授权后统一规划实例命名和访问权限。
  • 涉及敏感项目时,配合敏感文件夹授权访问,避免 AI 应用读取未授权目录。

故障排查​

现象检查顺序
实例显示离线Agent 进程、实例地址和端口、网络可达性、日志中的第一条错误
SSH 连接失败主机指纹、用户名、密钥/密码、SSH 端口、防火墙和账号权限
能连接但 Agent 不可用远程运行环境、引擎安装状态、配置路径和服务端日志
找不到本地文件当前是远程实例;核对远程工作目录,不要假定本地目录会自动映射
多实例切换混乱使用“位置-Agent-用途”命名,并为不同项目新建独立会话

排查远程连接时不要在截图或普通聊天中发送完整密码、私钥或 Token。记录错误时间后到 日志中心 对照;仍无法解决时按 技术支持 的清单提交。

下一步​