OpenProgram Docs

快速上手#

这页带你在五分钟内完成：安装、接入一个 LLM provider、打开界面、发出第一条消息，并装上第一个现成的 agent 程序。

第 1 步：安装#

在 macOS 或 Linux 安装包含受控 Python 的完整 release runtime：

curl -fsSL https://openprogram.io/install | sh

Windows x86_64 使用 PowerShell：

irm https://openprogram.io/install.ps1 | iex

installer 提供自己的 Python 并包含 Web UI，因此运行时不需要 Node.js。Session 与 Memory 历史需要 Git；openprogram doctor 会报告 Git 是否可用。macOS Desktop 使用 release DMG。Windows Desktop 只在已发布 release 附带带签名 win-x64.exe 时使用该 installer；否则使用完整 Windows CLI/server runtime 和浏览器 UI。Windows 沙箱是单独层级。平台范围和开发 checkout 安装见安装。

第 2 步：首次运行，接入 provider#

openprogram

第一次运行会进入 setup 向导，引导你完成 provider 配置——从已登录的 Claude Code / Codex / Gemini CLI 导入凭据，或输入一个 API key——随后直接打开终端聊天界面。随时可以用 openprogram setup 重新运行向导。

如果环境里已经有 provider key，可以把它导入 OpenProgram 的凭据库，省去在向导里再次粘贴：

export OPENAI_API_KEY=sk-...
openprogram providers discover
openprogram providers adopt env:OPENAI_API_KEY

其他 provider 使用对应的 env:<变量名> source id 重复最后一条命令。也可以把 key 通过 stdin 直接交给 openprogram providers login <provider> --api-key-stdin。 确认检查：openprogram providers 会列出已存储的凭据。

第 3 步：打开 web 界面#

openprogram web

它会启动后台 worker 并打开浏览器到 http://localhost:18100——web UI、API 和 WebSocket 共用这一个端口。改端口用 openprogram ports --port <p>。

第 4 步：发第一条消息#

在终端聊天界面或 web 输入框里直接输入即可。想快速验证一条命令也行：

openprogram --print "用一句话介绍你自己"

它发送一条消息、打印回复、然后退出。之前的会话可以用 openprogram --resume <session_id> 续上，id 来自 openprogram sessions list 或 web 侧栏。

第 5 步：使用内置 agent Program#

每个 release 都包含 GUI、Research 和 Wiki Program，无需单独安装，启动后会出现在 Web UI 和函数列表中。可用 openprogram programs available 查看注册状态。

Program installer 只用于第三方 Program 和开发者源码 overlay，不用于区分普通用户版本的功能范围。

下一步#

Last updated · 2026-10-10
PreviousFeaturesNextDaily use