接入自己的引擎
有两种无需写代码的方式,让 WenwoBot 的机器人运行在应用没有内置的引擎上。两者都写在 ~/.wenwobot/config.json 的 "instances" 下;修改后请重启应用(实例配置在启动时读取)。
任意 ACP 智能体(由 WenwoBot 启动的命令行)
如果某个智能体命令行通过 stdio 支持 ACP(例如 Zed 风格的智能体服务器,或你自己的封装),可以添加一个 customAcp 实例:
{
"instances": {
"my-agent": {
"driver": "customAcp",
"displayName": "我的智能体",
"environment": { "MY_AGENT_TOKEN": "…" },
"config": { "cli": "my-agent acp" }
}
}
}
config.cli是完整的命令(含参数),例如"npx -y some-agent acp"。也可以在应用里设置:在 AI 引擎设置中该实例那一行选择 设置命令行…。- 先登录。 这个驱动没有自己的登录流程:先在终端里运行一次该命令行并完成登录,WenwoBot 启动它时会沿用你的登录。
- 按机器人选择模型。 打开机器人的模型选择器,重新检测即可加载智能体公布的模型;如有提供,还可以选择思考强度。代理默认 表示沿用智能体自己的默认模型。
environment会传给命令行子进程。其他引擎的密钥(如XAI_API_KEY、OPENAI_COMPAT_API_KEY)会被有意去掉,确保自定义命令行不会用其他引擎的账户计费。- 权限 通过 ACP 自己的权限请求传递:智能体请求权限时,会在聊天中变成一张普通的审批卡片。
- 可以添加多个实例,每个智能体一个。
示例:Mistral Vibe
- 安装:
uv tool install mistral-vibe(或pipx install mistral-vibe),这会把vibe和vibe-acp放到~/.local/bin。 - 在终端里登录一次:运行
vibe --setup,用你的 Mistral 账户登录。 - 添加实例并重启 WenwoBot,
config.cli填vibe-acp的完整路径(从程序坞启动的桌面应用通常没有~/.local/bin这个 PATH)。 - 为机器人选择 Mistral Vibe。
任意 OpenAI 兼容接口(不需要任何进程)
内置的 openai-compat 驱动支持多个实例,所以本地的 vLLM、LM Studio、Ollama 的 OpenAI 接口,或任何托管的兼容 API,都只需要一条配置:
{
"instances": {
"my-endpoint": {
"driver": "openai-compat",
"displayName": "我的接口",
"environment": { "MY_ENDPOINT_KEY": "sk-…" },
"config": {
"url": "http://127.0.0.1:1234/v1",
"apiKeyEnv": "MY_ENDPOINT_KEY",
"model": "my-model"
}
}
}
}
apiKeyEnv指明environment里哪个值是密钥,这样多个实例可以各用各的密钥。- 驱动会尽量列出接口的
/models,并始终把你填的model作为自定义选项保留。 - OpenAI 兼容实例支持结构化工具和图片输入。模型两者都支持时,可以挂载已批准的电脑、本地虚拟机、VPS 或内置浏览器工具,并把截图返回给模型。原有的平台、电脑选择和审批检查仍然适用。
- 对不支持工具的模型,把
config.tools设为false。
示例:阿里云百炼(通义千问)
使用上面的 openai-compat 实例,填写你的百炼 API 密钥和账户已开通的模型 ID。config.url 填你百炼工作空间的基础地址(包含 /compatible-mode/v1),例如北京地域为 https://<工作空间ID>.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。API 密钥必须与接口属于同一地域,否则即使密钥有效也可能返回 HTTP 401。旧的 dashscope.aliyuncs.com 地址仍然可用。最新地址请参阅 阿里云百炼的 OpenAI 兼容说明。
服务商图标
每个实例显示其驱动的图标。OpenAI 兼容服务器会根据地址中的域名显示运营方的图标,例如 api.deepseek.com 显示 DeepSeek,阿里云百炼的地址显示 Qwen,openrouter.ai 显示 OpenRouter。也可以在实例上指定预设图标:在 driver 和 displayName 旁加上 "icon": { "kind": "preset", "preset": "azure" }。应用从不加载远程图标地址。
注意事项
config.json只有所有者可读写,但environment中的值以明文保存在这个文件里,请尽量使用只授权给这个引擎的密钥。driver写错或config无效不会让应用崩溃,只会影响这一个实例。