如何为 OpenBot Agent 编写第一条指令：Prompt 驱动配置实战指南

OpenBot 是一款本地优先（local-first）的桌面工作区，让你用 Codex、Claude、Grok 等 AI 组建一支"常驻的 AI 队友（Agent）"队伍。而让每个 Agent 真正好用的关键，就在于它的第一条指令——OpenBot 采用 Prompt 驱动（Prompt-driven）的方式创建和编辑 Agent：你用自然语言描述角色，指令就会变成 Agent 的"人格"与行为准则。本文手把手教你写好这条指令。

先理解：什么是 Prompt 驱动的 Agent 配置

传统方式配置 Agent 需要填写一堆表单字段，OpenBot 简化成了"对话即配置"。官方文档将其称为Prompt-driven agent profiles：

你在桌面或手机端的普通对话里直接对某个 Agent 提要求，它就能调用openbot.create_agent创建新队友（含指令和第一个任务），或用openbot.update_profile修改现有 Agent 的名称、头衔、instructions（指令）、头像、模型等。

• 机制详解：docs/architecture/agents.md（"Prompt-driven agent profiles" 一节）
• 工具定义源码：src/backend/openbot-tools.ts

这套设计的好处是：你不需要学习任何配置格式，写 Prompt 的能力直接等于配置 Agent 的能力。

三步创建你的第一个 Agent

首次启动 OpenBot 时，会进入"第一个 Agent 设置"界面（FirstAgentSetup.tsx），流程只需三步：

1. 起名 + 写目的（purpose）：这是核心。purpose 会直接写入 Agent 的初始消息，源码中逻辑很简单——它会把你的目的包装成一句"长期角色声明"发给 Agent（见 agent-initial-message.ts）：

   Your ongoing role is: <你写的 purpose>

2. 选择 Provider 和模型：Codex、Claude、Grok、OpenCode、Gemini 等，选好后点击 Connect 完成登录。

3. 保存：指令、头像、分工一次性落库，Agent 即刻可用。

写好第一条指令：四要素模板

一条合格的"第一条指令"（standing role）建议包含四个要素：

把四要素拼起来，就得到一条高质量的 purpose，例如：

你是团队的文档工程师，负责把最新提交整理成中文发布说明，只输出 Markdown，不改任何源码，回复先给结论。

📌 两个实用技巧：

• 一句话角色 + 三条硬约束比一大段描述更稳定，模型更容易长期遵守；
• 指令不必一次写完美。OpenBot 支持随时用对话修改，下一条消息就说"以后你的职责增加……"即可。

用一句话修改 Agent：update_profile 实战

Agent 创建后，改配置同样靠 Prompt。比如你在对话里说：

"把你这个 Agent 的名字改成 DocBot，职责改成每周汇总项目动态，模型换成更便宜的档位。"

Agent 会调用openbot.update_profile更新名称、标题、instructions、头像、Provider、模型、推理强度等字段。注意两点（见 openbot-tools.ts 的工具说明）：

• 权限只能收不能放：Agent 自己可以把自己限制到 workspace 范围，但"放宽权限"只能由用户操作；
• 新模型从下一轮生效：Provider 或账号变更要等 Agent 空闲才会应用。

⚠️ 安全提醒：给指令，也要给笼子

OpenBot 目前是开发预览版，Agent 默认以danger-full-access、approvalPolicy: never运行——它可以读写文件、执行命令、访问网络和控制内置浏览器，且不再逐条确认（见 README 安全警告）。因此：

• 第一条指令里务必写明边界（如"只操作某目录"）；
• 只让信任的 Agent 跑信任的任务，重要目录保持备份；
• 定期在 Agent 设置中检查访问级别。

延伸阅读

• 官方总览：README.md
• Agent 架构详解：docs/architecture/agents.md
• 术语表（agent / teammate / routine 等概念）：docs/glossary.md
• 创建表单界面：packages/ui/src/features/agents/FirstAgentSetup.tsx

把第一条指令写清楚，你的 AI 队友就从"通用助手"变成"岗位明确的同事"——这正是 OpenBot Prompt 驱动配置的核心价值。