coral-cli 0.1.3

珊瑚平台 Python CLI 示例

coral-cli

这是一个面向珊瑚平台的 Python CLI。当前主要用于调用珊瑚平台 API，不再依赖账号密码登录，而是直接从环境变量读取鉴权信息。

安装

pip install -e .

如果已经发布到包源，也可以直接安装：

pip install coral-cli

环境变量

CLI 启动后会优先读取以下环境变量：

• ACCESSKEY，也兼容 CORAL_ACCESSKEY
• ACC_ID，也兼容 CORAL_ACC_ID

示例：

export ACCESSKEY='your-accesskey'
export ACC_ID='vic.lv'

命令

coral-cli config
coral-cli zhipu-search --app-id 2046036834380091394 --conversation-id 2046040995337003010 --input '添可'
coral-cli project

coral-cli config 会检查当前环境变量是否存在，并以脱敏方式输出配置摘要。

coral-cli zhipu-search 会调用下面这个接口：

https://coral-test.ecovacs.cn/app-platform/api/app/v1/chat/completions

等价调用示例：

coral-cli zhipu-search \
	--app-id 2046036834380091394 \
	--conversation-id 2046040995337003010 \
	--input '添可' \
	--tools-call-enabled 1 \
	--no-stream

这个命令会自动注入以下请求头：

accesskey: 从 ACCESSKEY 或 CORAL_ACCESSKEY 读取
ACC_ID: 从 ACC_ID 或 CORAL_ACC_ID 读取
Content-Type: application/json

Agent 使用建议

像 openclaw 这样的 Agent 在调用前，不应再要求用户登录，而应先确认运行环境里已经注入了 ACCESSKEY 和 ACC_ID。然后按下面顺序执行：

coral-cli config
coral-cli zhipu-search --app-id <app-id> --conversation-id <conversation-id> --input '<query>'

如果环境变量不存在，Agent 应提示用户在宿主环境中设置，而不是在 CLI 内部交互式索取或持久化保存。