Web 控制台
Open4X Web 控制台地址：
https://console.open4x.com控制台用于注册登录、创建服务实例、管理连接账户和 API Key、查看账单，并在 Playground 中验证接口。真正的生产调用建议使用 API Key，不要把登录 JWT 写入第三方服务配置。
首次使用
- 使用邮箱和至少 8 位密码注册，或使用已配置的 GitHub OAuth 登录。
- 进入 API Keys，创建一个只包含必要 scope 的 Key。
- 进入 Services，创建服务实例并设置 alias。
- 在 Playground 或 AI 页面发送一次测试请求。
- 将 API Key 放入服务端环境变量，再接入业务代码。
alias 只能使用字母、数字、短横线和下划线，最长 64 个字符。例如：
/v1/apps/ai/qwen122/chat
/v1/apps/webhook-push/ops/send页面说明
| 页面 | 用途 |
|---|---|
| Dashboard | 查看账户、余额、服务数量和快速入口 |
| Services | 创建、编辑、停用和删除服务实例 |
| Connections | 加密保存第三方 API Key、Telegram Bot Token 等凭据 |
| AI | 选择 AI service 和 model，测试普通或流式请求 |
| SocialOps | 管理 Telegram channel、Inbox、线程、备注和回复 |
| Inbox | 查看 Bot 和 Widget 会话并回复消息 |
| Playground | 以原始 HTTP 方式调试 API |
| Billing | 查看余额、套餐和交易记录 |
| API Keys | 创建和撤销服务端 API Key |
| Teams / Roles | 管理团队成员和权限 |
| Settings | 修改个人资料、密码和账户设置 |
菜单会根据用户权限显示。看不到某个页面时，请检查当前团队身份和权限。
推荐 Scope
| 场景 | Scope |
|---|---|
| AI | ai:invoke |
| Bot | bot:send |
| Webhook Push | push:send |
| SocialOps 读取 | socialops:read |
| SocialOps 写入和回复 | socialops:write |
| TRON 能量租赁 | tron:lease |
空 scope 的 API Key 不会自动获得全部权限；需要明确选择 scope，或在受控场景使用 *。
AI Playground
AI 页面可以选择服务和模型，设置最大 tokens、单次预算、temperature、top P 和 system prompt。Quality guard 开启后会多执行一次审校请求，用于检查明显矛盾、危险建议和缺少条件的回答，会增加延迟和费用，但不能替代事实核验。
本地 Qwen 等 OpenAI-compatible 模型可以通过服务的 base_url 和 default_model 接入。模型名称由请求体或服务配置选择，不需要放进三级域名。输出不完整时，先检查 max_tokens_per_request、上游上下文限制、超时和 fallback alias。
Telegram 和 SocialOps
要让 Telegram 消息进入控制台：
- 在 Connections 添加 active 的 Telegram Bot 连接。
- 在 Services 创建并启用 Bot 或 SocialOps 实例。
- 在 SocialOps 页面添加 Telegram channel，填写 chat ID。
- 确认 Bot 已加入群组或频道；频道通常需要管理员权限。
Bot webhook 能收到消息，不代表 SocialOps channel 已配置。若 Inbox 没有消息，需要同时检查 Bot、SocialOps service 和 channel 是否都为 active，以及群组隐私模式是否限制普通消息。
GitHub、Discord、Teams 等 provider 已进入统一事件模型，但生产 OAuth、第三方回调验证和出站回复仍需单独配置。页面上出现 provider 选项，不代表无需配置即可直接使用。
账单和安全
生产余额应通过正式支付流程增加。mock-deposit 仅用于沙盒或内测，生产环境会拒绝。
API Key、Bot Token、OAuth Secret 和模型供应商 Key 只在必要时输入，平台列表和响应会脱敏。API Key 创建后只展示一次，遗失时应撤销旧 Key 并重新创建。
本地开发
启动 Worker：
npm run dev另开终端启动控制台：
VITE_API_BASE=http://127.0.0.1:8787 \
npm --prefix apps/console run dev生产构建：
npm --prefix apps/console run build