开源 AI 写小说 Agent 实战：用 InkOS 从 npm 安装到产出第一篇短篇

经常有人问"有没有开源的 AI 写小说项目"。答案是有，本文就拿一个 AGPL-3.0 协议的开源 Agent ------ InkOS（GitHub 仓库项目仓库，npm 包 @actalk/inkos）来做一次完整的实战，从安装到产出第一篇短篇，步骤尽量可复现。

一、它解决什么问题

直接拿大模型写长篇，常见三个坑：人物/时间线写着写着就崩、内容一眼 AI 味、数据不在自己手里。InkOS 的设计思路是把写作工程化：

7 个"真相文件"：把人物、世界观、时间线等沉淀成结构化记忆，写作时先读真相再生成。
33 维连续性审计：每章写完自动比对前文，降低长篇崩坏。
去 AI 味：内置疲劳词表、禁用句式、文风指纹注入，配合 AIGC 自查与改写。

支持长篇、短篇、续写、同人、文风仿写，提供 Studio Web、TUI 以及 OpenClaw skill 多种入口。下面走一遍最小可用流程。

二、环境准备

需要 Node.js（建议 LTS 版本）和 npm。先确认环境：

bash 复制代码

node -v
npm -v

三、安装

全局安装 npm 包：

bash 复制代码

npm install -g @actalk/inkos

安装完成后查看版本与可用命令：

bash 复制代码

inkos --version
inkos --help

如果你想从源码跑、或打算自己改（AGPL 允许自部署修改），也可以直接 clone 仓库：

bash 复制代码

git clone 
cd inkos
npm install

四、配置模型

InkOS 走 OpenAI 兼容接口，意味着任意兼容服务都能接入。配置通常用环境变量提供接口地址和密钥，注意用占位符，不要把真实密钥写进代码或仓库：

bash 复制代码

export INKOS_BASE_URL="YOUR_BASE_URL"
export INKOS_API_KEY="YOUR_API_KEY"

模型来源你自己定。Studio 内置了若干配置选项，包括聚合服务这类聚合入口，也可以填本地或你已有的任意兼容服务。本教程不绑定具体来源，跑通链路即可。

五、启动 Studio

可视化界面适合上手，启动后在浏览器里操作建书、配模型、写审改：

bash 复制代码

inkos studio

命令行党也可以用 TUI 模式：

bash 复制代码

inkos tui

六、产出第一篇短篇

最快看到成果的方式是一键短篇。给定一个点子，让它生成短篇加封面：

bash 复制代码

inkos short --idea "深海考古队在沉船里发现一封写给未来的信" --cover

执行后会按"写---审---改"的流程产出一篇短篇，并附带一张封面图。产物默认落在工作目录下，可直接打开查看。

说明：具体子命令与参数以 inkos --help 实际输出为准，不同版本可能略有差异。本文给出的是典型用法，跑不通时先看 help。

七、小结

到这里，一个开源 AI 写小说 Agent 的最小链路就跑通了：安装 → 配模型 → 启动 Studio → 产出短篇。InkOS 的价值在于把"防崩"和"去 AI 味"做成了工程化能力，而开源 + AGPL 让你能完整看到、修改并自部署整套流程。想深入的话，建议从真相文件机制和逐章审计读起，那是它长篇能力的核心。