WeAgent
使用文档

使用文档

按下面的步骤使用 Codex、会话、本地机器和工作区文件。

01

开始对话

  1. 1登录后选择一个在线环境。
  2. 2进入对话页,确认模型和工作目录。
  3. 3输入任务并发送;回复、工具调用和运行状态会出现在当前会话中。
02

选择环境

环境决定 Codex 在哪里运行,也决定可以访问哪些文件和会话。切换环境时不会沿用另一个环境的会话。

云环境由平台运行,工作区和 Codex 状态会持续保存。
本地环境运行在你自己的 Linux 或 macOS 机器上,使用该机器的文件、终端和 Codex。
在线可以发送任务、使用终端和读写文件。
离线连接已断开;重新启动对应环境后即可继续。
Codex所有会话统一使用 Codex app-server,支持流式输出、工具、审批和断线重连。
03

会话与模型

  • 每个会话只属于当前环境。页面地址同时包含环境和会话标识,刷新后仍会回到同一处。
  • “新建会话”会创建空白对话;打开左侧记录可以继续已有会话。
  • 模型按会话选择。修改当前会话的模型不会影响其他会话。
  • 需要继续已有 Codex CLI 会话时,点击“导入会话”。每次先加载最近 10 个,再按需继续加载。
  • 导入不会复制或转换会话,只保存 Codex 原生 Session ID 索引;原始记录仍保留在本机。
  • CLI 和 Web 继续同一个 Session ID 时,Agent Host 会监听 Codex rollout 变化并同步当前页面;连接中断时由定时刷新兜底。
04

连接本地环境

每个账号都可以连接自己的本地 Codex 环境。先在 Linux 或 macOS 机器上安装 WeAgent Host,然后启动一个平台服务器可以访问的 HTTP 端口:

curl -fsSL https://codex.engine.wang/install/weagent.sh | sh
weagent --listen :18080

首次启动会生成 8 位连接密码并保存到 ~/.weagent/agent-host-token。然后在右上角头像的“个人设置”中打开环境标签,点击“连接本地环境”,填写服务器能够访问的 IP:端口 和该密码。平台会先测试连接,成功后才保存环境。

默认工作区位于 Host 数据目录,和执行命令时所在目录无关。需要指定工作区时使用:

weagent --listen :18080 --workspace /workspace

如果希望自行设置连接密码,可额外传入 --token <YOUR_PASSWORD>

安装 Codex 后,先完成登录或模型配置,再运行 sudo systemctl restart weagent;如果是前台运行,停止后重新执行 weagent。回到网页刷新环境状态即可重新检测。

平台服务器与本机处于同一局域网或 VPN 时填写内网地址;否则使用内网穿透或端口映射,填写服务器能够访问的公网 IP 或域名。

平台网页用户浏览器只需访问平台公网 URL。当前部署的 Web 端口是 3001;正式公网部署建议由 HTTPS 反向代理接到 443。
同一内网 / VPN优先填写 Host 的内网 IP,例如 http://10.0.0.25:18080,并只允许平台服务器访问该端口。
公网服务器可以填写公网 IP 或域名,但应在云安全组和防火墙中仅放行平台服务器,并使用强 Token;跨公网建议使用 HTTPS。
家庭或 NAT 网络平台无法直连时,使用 Tailscale、WireGuard、frp、rathole 或受控端口映射,使 Host 对平台服务器可达。不要填写 127.0.0.1。

其他用户注册后会获得独立云环境,也可以在个人设置中连接自己的本地环境。

Web 任务由 Host 在后台启动 Codex app-server。关闭网页不会停止正在执行的任务,重新进入会话后会从服务器事件游标继续接收输出。

Linux / macOS当前支持原生安装和常驻运行。
Windows当前不支持原生 Windows 二进制,请使用 WSL2 运行 Linux 版 Host。
本机凭据Host 使用本机 Codex 配置和本机 API 凭据,平台不收取模型费用。
平台 APIHost 直接使用本机已安装的 Codex 与配置。
Host 不需要平台域名、配对码或配置文件。长期使用时,将同一条命令配置为系统常驻服务即可。
05

文件

打开右侧文件区后,可以展开目录、创建文件或文件夹、重命名、移动、上传和删除,也可以在多个标签页中同时打开文件。

代码与文本显示行号和语法高亮,可以直接编辑并保存。
图片、PDF直接在页面内预览,也可以下载原文件。
音频、视频使用浏览器播放器预览常见格式。
其他文件无法直接预览时仍可查看信息并下载。
06

图片生成

  1. 1先选择图片模型。
  2. 2在下一行选择尺寸。
  3. 3填写提示词;需要修改图片时再添加参考图。
  4. 4开始生成后,结果会保存到当前环境的工作区。
07

定时任务

在对话左侧打开“定时任务”。定时任务有独立的任务列表和运行历史,不会出现在普通聊天会话中。

  1. 1新建任务并选择执行一次、每天或固定间隔。
  2. 2选择发送固定消息,或选择由 Codex 执行。
  3. 3Codex 任务必须指定模型和工作目录;没有特殊要求时保留默认工作目录即可。
  4. 4创建后可查看下一次运行时间、成功次数,或执行暂停、修改、立即运行和删除。
  5. 5点击运行历史可查看每次结果;Codex 的工具调用和独立会话只在这里展示。
Codex 任务可以只把结果保存在运行历史,也可以在已绑定微信后选择发送到微信。固定消息任务必须先在“个人设置 → 微信绑定”中完成绑定。
08

用量

点击右上角头像进入“个人设置”,可在“详细用量”和“使用日志”中查看调用次数、Token、图片数量、费用及逐条记录。

09

常见问题

本地环境为什么显示离线?

确认 weagent 仍在运行,并从平台服务器检查填写的 IP 和端口是否可达、Token 是否一致。

从哪个目录启动 Host 有区别吗?

没有。访问范围由 --workspace 决定,不是命令启动目录。

为什么没有自动显示全部本地会话?

点击“导入本地会话”后会扫描 Codex 会话,并从最近 10 个开始分页加载;不会因当前项目目录不同而遗漏历史会话。

云环境和本地环境的文件分别在哪里?

云环境文件保存在持久工作区;本地 Host 直接读写其工作区,权限与运行 Host 的系统账号一致。