文档Docs
让你的 bot 接待访客Serve visitors with your bot
在手机选模板、配置 Telegram 或网页渠道，并用自己的模型账户接待访客。Choose a template, connect Telegram or a website, and serve visitors using your own model account.
在已配对的手机上打开 Bots，点「新建 bot」。选客服、陪聊或付费问答。填名字，创建。bot 默认暂停。电脑在线、席位有效时才能服务。每个席位同时只能启用一个 bot。
客服按你的资料回答，拿不准就转人工。陪聊会先说明是 AI，守住边界，不让人依赖、被操纵，也不做专业诊断。付费问答靠你的专业资料来答。你可以设每位访客每天免费问 N 次，再挂一个 HTTPS 付费链接。免费次数用完，主机就会提示这个链接。这期不接支付，也不验证付款，点了链接不会自动解锁问答。想改免费次数，或者自己提供付费服务，都可以另外调。
选择模型和审核账户
在设置中选择「用主 Agent 套餐」或「主人自带模型 key」。自带 key 先选用哪家的按量 key，可以和主 Agent 不同家（主 Agent 用火山方舟、客服 bot 用千问也行）：火山方舟、阿里云百炼 / 千问、DeepSeek、Kimi / Moonshot、智谱 GLM、MiniMax、OpenRouter、AgentsRelay、OpenAI、Anthropic。每家自带服务地址、便宜的默认模型和自己的 key 名（比如 BOT_DASHSCOPE_API_KEY），跟主 Agent 的 key 分开存；别的 OpenAI 兼容服务选「其他」，自己填 API 地址。再填每日模型 token 上限并保存，然后点添加 / 更新这家 key 的按钮：密钥卡会写明填哪家的按量 key、去哪个控制台建。Coding Plan / Token Plan 的 key 不能用。仅在密钥卡中粘贴 key，别发到聊天中。修改已有模型 key 会暂停使用自带 key 的 bot，保存并验证成功后再启用。已有服务商档案仍可使用。
自带 key 的模型费用走该 key 的账户，模型 token 日限独立；访客、bot 和主机消息限额仍一起生效。安全审核始终使用你自己的 OpenRouter key，与模型 key 分开。添加审核 key 后，每次启用都会真实验证审核；失败或结果不确定时，不会发出模型或人工回复，也不会改用其他账户。
在 Telegram 接待
先准备一个属于你的 Telegram bot token。在 Bots 设置点「添加 / 更换 Telegram token」，只在密钥卡中粘贴。勾选「在 Telegram 接待（停用后停止收发）」，保存后会验证 token。已有 webhook 必须由你在 Telegram 端移除；同一个 token 不能同时由另一套程序轮询。Token 更换会暂停 Telegram，重新保存后恢复。取消勾选即可停用；已在途的网络请求可能继续结束，但停用后的结果不会外发。
头像：保存并启用 Telegram 后，如果这个 bot 还没有头像，Agent J 会自动把它设成官方 Logo（奶白底上的绿色机器人），只做一次；已经有头像的不会动。想换成 Agent J 头像，点 bot 设置里的「换成 Agent J 头像」，或者让 Agent 运行 agentj bots avatar set <bot id>（status 查看、reset 移除当前头像；owner 指你自己的主人 bot，它绑定时也按同样规则自动设一次）。其他尺寸和 16 个机器人见 官方 Brand Kit。
只接私聊，不接群聊和其他 bot。每位 Telegram 用户都有独立会话。消息限流、日限、知识、工具审批、转人工和 Jev 审核，跟网页渠道共用一套规则。公开网页网址和嵌入继续可用。
Telegram 是第三方渠道，平台能看到消息。Token 只存在你的主机里，不进聊天、云端明文或日志。网页聊天还是端到端加密。模型服务商和 OpenRouter 会收到必要的上下文，按各自的数据政策处理。
让你的 Agent J Telegram 机器人兼做客服
你跟 Agent J 配对的那个 Telegram 机器人也能接待客人。同一个机器人两种身份：对你是助理，对别人是客服。在客服 bot 里打开一个 bot，勾选「让我的 Agent J Telegram 机器人也接待客人」，或者让 Agent J 运行 agentj bots attach-telegram <bot-id>；两种方式都要你在已配对的手机上批准。默认关闭；关着的时候，别人给你的机器人发消息只会收到他自己的数字 ID。
只有用配对码绑定的那个私聊是主人，消息照旧进你的主对话。其他私聊都是这个 bot 的访客：各自独立会话，用这个 bot 的提示词、模型、知识、工具、限额和 Jev 审核。想给客人用便宜模型，就给这个 bot 配自带模型（key 走密钥卡）；没配就用 bot 现有的默认。客人进不了你的主对话，也拿不到你的权限；客人发配对码、自称主人或发主人命令，都只当访客文字。
客人的聊天记录在 bot 的会话列表里，和你自己的 Telegram 消息分开。电脑日志只记次数。超过限额会礼貌回复。只回文字消息，群聊暂不接待。bot 暂停或按了「全部停下」时，客人只会收到数字 ID。一次只有一个 bot 接待；取消勾选，或运行 agentj bots attach-telegram <bot-id> --off 就停。不要把 Agent J 机器人的密钥再存成某个 bot 自己的 Telegram token，两边会互相抢消息。
Gemini CLI（可选）
本期停止 Gemini 主 Agent 适配。Google 已停用个人登录；只有明确选择 Gemini CLI 时才安装，并使用付费 Gemini API key。主 Agent 请使用 Claude Code、Codex 或 OpenCode。
参见可选 CLI 安装。
让 Agent J 帮你设置
按 Alt+Shift+B 打开客服 Bot 页，或在设置里点「Bots / 客服」。点顶部「让 Agent J 帮我设置」，聊天输入框会备好技能命令和开场白。补一句想法再发，或直接发送，Agent J 都会先讲清客服 Bot 怎么用，再问你想怎么设。
Open Bots on your paired phone and choose Create bot. Select customer service, companion or paid Q&A, give it a name, and create it paused. Your computer must be online with a valid seat; one bot can be enabled per seat.
Customer service answers from your knowledge and offers a human when uncertain. The companion template identifies itself as AI and sets boundaries against dependency, manipulation and professional diagnosis. Paid Q&A uses your expertise: set N free questions per visitor per day and an HTTPS payment link. After N questions the host displays your link. This release does not process or verify payments, and visiting a link does not unlock answers. You can adjust the free allowance or deliver a separate paid service yourself.
Model billing and safety reviews
Choose your main Agent plan or your own model key. With your own key, first pick whose pay-as-you-go key the bot uses — it may differ from your main Agent's (Volcano Ark for the Agent, Qwen for the bot is fine): Volcano Ark, Alibaba Cloud Bailian / Qwen, DeepSeek, Kimi / Moonshot, Zhipu GLM, MiniMax, OpenRouter, AgentsRelay, OpenAI or Anthropic. Each brings its own address, a low-cost default model and a key name of its own (for example BOT_DASHSCOPE_API_KEY), kept apart from your main Agent's keys; for any other OpenAI compatible service choose Other and enter its API URL. Set a daily model token cap and save. Then use Add / update the key for … to open the secret card, which says whose pay-as-you-go key to paste and which console issues it; a Coding Plan / Token Plan key is refused; never paste a key into chat. Replacing an own model key pauses a bot using that key. Save and verify before enabling it again. Existing provider profiles remain available.
Own-key model calls are billed to that account and have a separate daily token budget. Visitor, bot and computer message caps still apply. Jev always uses your separate OpenRouter review key. Every activation tests reviews. Failed or uncertain reviews block output, including human replies; there is no fallback to another account.
Telegram
Use a Telegram bot token you own. Add / replace Telegram token opens the phone secret card. Enable Serve on Telegram and save to verify it. Remove any existing webhook through Telegram first, and do not run a second polling application with the same token. Replacing a token pauses Telegram until you save again. Disable the channel to stop it. A network request already in flight may finish, but its result will not be sent after disabling.
Avatar: when Telegram is enabled and saved, a bot that has no photo yet gets the official Agent J logo (the green robot on ivory), once; a bot that already has a photo keeps it. To switch to the Agent J photo, tap Use the Agent J avatar in the bot's settings, or have the Agent run agentj bots avatar set <bot id> (status to check, reset to remove the current photo; owner means your own owner bot, which gets the same one-time check when it is bound). Other sizes and the 16 robots: official Brand Kit.
Only private chats are served; groups and other bots are ignored. Each Telegram user gets a separate session. Rate limits, daily caps, knowledge, tool approvals, human handoffs and Jev are shared with the website channel. Website URLs and embeds remain available.
Telegram can see messages sent through its platform. Your token stays on your computer, outside chat, our cloud plaintext and logs. Website chat remains end-to-end encrypted. Your model provider and OpenRouter receive necessary context under their own policies.
Your own Agent J Telegram bot as customer service
The Telegram bot you paired with Agent J can also receive guests. One bot, two roles: for you it is your assistant, for everyone else it is customer service. In Bots, open a bot and tick 「Let my Agent J Telegram bot receive guests」, or ask your Agent J to run agentj bots attach-telegram <bot-id>; either way you approve the change on the paired phone. It is off by default; while it is off, anyone else who writes to your bot only gets their own numeric ID.
Only the private chat you paired with a code is the owner, and it keeps going to your main conversation. Every other private chat is a visitor of the chosen bot: a separate session with that bot's instructions, model, knowledge, tools, limits and Jev reviews. For a cheaper model for guests, give the bot its own model (key through the secret card); without one it uses the bot's current default. Guests never reach your main conversation or your permissions. A pairing code, 「I am the owner」 or an owner command from a guest is only visitor text.
Guest chats are kept in that bot's conversation list, apart from your own Telegram messages; the computer log only counts them. Over a limit, guests get a polite answer; only text is answered, and groups are not served yet. A paused bot or Stop everything sends guests back to the ID answer. Only one bot receives these guests; untick it or run agentj bots attach-telegram <bot-id> --off to stop. Do not also save your Agent J bot's key as a bot's own Telegram token: the two would take each other's messages.
Gemini CLI (optional)
Gemini main Agent adaptation is stopped for this release. Google has discontinued personal login; an explicitly selected Gemini CLI requires a paid Gemini API key. Use Claude Code, Codex or OpenCode as the main Agent.
See optional CLI setup.
Let Agent J help you set up
Press Alt+Shift+B to open Bots, or choose Bots in Settings. Tap “Let Agent J help me set up” at the top to prepare the skill command and an opening in the chat. Add your idea or send it as it is. Agent J explains how Bots work first, then asks what you would like to set up.